SpringCloud(五):Zuul的多个使用场景

Zuul Http客户端

  • Zuul使用的默认HTTP客户端现在由Apache HTTP Client支持,而不是已经不推荐使用的Ribbon RestClient
  • 要使用RestClientokhttp3.0kHttpClient,请分别设置
    1
    2
    3
    ribbon.restclient.enabled = true
    //或
    ribbon.okhttp.enabled = true

如果要自定义Apache HTTP客户端或OK HTTP客户端,请提供ClosableHttpClient或OkHttpClient类型的bean。

Cookies and Sensitive Headers

配置文件application.yml中设置

1
2
3
4
5
6
zuul:
routes:
users:
path: /myusers/**
sensitiveHeaders: Cookie,Set-Cookie,Authorization
url: https://downstream

这里sensitiveHeaders是默认值,所以当你希望它不同时,才需进行设置。 这是Spring Cloud Netflix 1.1中的新功能(在1.0中,用户无法控制标题,并且所有Cookie都在两个方向上流动)。

sensitiveHeaders是黑名单,且默认不为空。 因此,要使Zuul发送所有标头(忽略的标头除外),您必须将其明确设置为空列表。 如果要将cookie或授权标头传递到后端,则必须这样做。 以下示例显示了如何使用sensitiveHeaders:

1
2
3
4
5
6
zuul:
routes:
users:
path: /myusers/**
sensitiveHeaders:
url: https://downstream

您还可以通过设置sensitiveHeaders来设置zuul.sensitiveHeaders。 如果在路由上设置了sensitiveHeaders,它将覆盖全局sensitiveHeaders设置。

Ignored Headers

  • 常规理解:

    zuul.ignoreHeaders属性可用于丢弃一些标题。

    例如,设置zuul.ignoredHeaders = Header1,Header2;
    那么Header1和Header2将不会传播到任何其他服务。

    默认情况下,zuul.ignoredHeaders=是空的。但如果Spring Securuty在classpath中。
    它的值在是:
    1
    Pragma,Cache-Control,X-Frame-Options,X-Content-Type-Options,X-XSS-Protextion,Expires

zuul.ignoreSecurityHeaders的默认值为true。但是当我想要标头值的值时
从下游服务我们需要设置为false。

  • 通俗来讲就是:

    route-sensitive外,您还可以将与下游服务交互期间应丢弃的值(请求和响应)设置名为zuul.ignoredHeaders的全局值。 默认情况下,如果Spring Security不在类路径中,则它们为空。 否则,它们被初始化为一组众所周知的“安全”头文件(例如,涉及缓存),如Spring Security所指定的那样。 在这种情况下的假设是下游服务也可能添加这些头,但我们想从代理中获得这些值。 如果要在Spring Security位于类路径时不丢弃这些众所周知的security headers,可以将zuul.ignoreSecurityHeaders设置为false。 如果您在Spring Security中禁用了HTTP安全响应标头并希望下游服务提供的值,那么这样做会非常有用。

    Routes Endpoint

  • 使用routes 端点的前提:
    • Zuul Server需要有Spring Boot Actuator的依赖,否则访问/routes 端点将会返回404;
    • 设置management.security.enabled = false,否则将会返回401;也可添加Spring Security的依赖,这样可通过账号、密码访问routes 端点。

      Strangulation Patterns and Local Forwards

      标题: 扼杀模式和本地转发

迁移现有应用程序或API时的一种常见模式是“扼杀”旧端点,慢慢用不同的实现替换它们。 Zuul代理是一个有用的工具,因为您可以使用它来处理来自旧端点的客户端的所有流量,但将一些请求重定向到新的端点。

以下示例显示“strangle”方案的配置详细信息:

  • application.yml配置示例:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    zuul:
    routes:
    first:
    path: /first/**
    url: http://first.example.com
    second:
    path: /second/**
    # forward的是本地转发
    url: forward:/second
    third:
    path: /third/**
    url: forward:/3rd
    legacy:
    path: /**
    url: http://legacy.example.com

==[注意]== 忽略的模式不会被完全忽略,它们只是不由代理处理(因此它们也可以在本地有效转发)。

Uploading Files through Zuul

标题: 通过zuul上传文件

  • 如果使用@EnableZuulProxy注解,可以用代理路径上传文件,只要文件很小,它就可以正常工作。

    1
    2
    3
    curl -F "file=@d:/tmp.txt" localhost:8050/upload

    curl -F "file=@d:/tmp.txt" localhost:8050/microservice-file-upload/upload
  • 而对于大型文件,需要使用一个替代路径绕过/zuul/*中的Spring DispatcherServlet;
    即使用/zuul/*的方式绕过Spring DispatcherServlet(以避免多部分处理)

    1
    curl -F "file=@d:/tmp.txt" localhost:8050/zuul/microservice-file-upload/upload
    • application.yml配置中需要加如下语句,主要是为了避免文件过大和上传超时:

      1
      2
      3
      4
      5
      6
      7
      # 经过zuul的请求都会使用hystrix进行包裹
      # hystrix的超时时间
      hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 60000
      # zuul使用了ribbon做负载均衡
      ribbon:
      ConnectTimeout: 3000
      ReadTimeout: 60000

      ==[注]== 超时问题解决后,也可能存在堆内存太小,导致上传失败,可以堆tomcat进行如下设置: 点这里

      Disable Zuul Filters

      标题: 禁用zuul过滤器

SpringCloud在代理和服务器模式下都默认启用了许多ZuulFilter bean。

有关可以启用的过滤器列表,请参阅Zuul过滤器包

如果要禁用一个过滤器,请参照如下设置zuul.<SimpleClassName>.<filterType>.disable=true;按照惯例,过滤器后的包是Zuul过滤器类型。

例如,要禁用org.springframework.cloud.netflix.zuul.filters.post.SendResponseFilter需设置zuul.SendResponseFilter.post.disable = true