Spring Cloud(Dalston.SR5)--Zuul 网关-路由配置

Posted 2020-11-01 追寻自由的路途

Spring Cloud 在 Zuul 的 routing 阶段实现了几个过滤器，这些过滤器决定如何进行路由工作。

• 简单路由（SimpleHostRoutingFilter）

  该过滤器运行后，会将 HTTP 请求全部转发到"源服务器"，简单路由的配置如下：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/person/speaks地址，路由到http://localhost:8080/speaks

  person:

  path:/person/**

  url:http://localhost:8080

  该配置访问 http://localhost:9200/person/speak 会将请求转发到 http://localhost:8080/speak ，为了配置简化，可以省略 path 属性，简化配置如下：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/person/speaks地址，路由到http://localhost:8080/speaks

  person:

  url:http://localhost:8080

  url 的值必须以 http: 和 https: 字符串开头，否则不会触发简单路由。

  简单路由使用了 HttpClient 进行转发，该过滤器会将 HttpServletRequest 的相关数据（HTTP方法，参数、请求头等）转换为 HttpClient 的请求实体，再使用 CloseableHttpClient 进行转发，为了保证性能，使用了 HttpClient 的连接池功能，因此，在使用简单路由时，可以配置 HttpClient 连接池的属性：

  • zuul.host.maxTotalConnections：目标主机的最大连接数，默认值 200。配置该属性，相当与调用了 PoolingHttpClientConnectionManager 的 setMaxTotal 方法。
  • zuul.host.maxPerRouteConnections：每个主机的初始连接数，默认值 20。配置该属性，相当与调用了PoolingHttpClientConnectionManager 的 setDefaultMaxPerRoute 方法。

    ? ?

• 跳转路由（SendForwardFilter）

  跳转路由时当外部访问网关的 A 地址时，会跳转到 B 地址，处理跳转的过滤器为 SendForwardFilter，跳转路由的配置如下：

  #zuul路由配置

  zuul:

  routes:

  testRoute:

  path:/test/**

  url:forward:/hello

  表示访问 http://localhost:9100/test 地址时会自动跳转到 http://localhost:9100/hello 地址，注意，这个不是客户端跳转，在浏览器上是无法看到地址变化的，只能根据返回信息来验证，并且不能跨域名，只能在当前站点进行跳转，在验证跳转路由还必须创建一个简单的 REST 服务，如下：

  package org.lixue.zuul;

  ? ?

  import org.springframework.web.bind.annotation.PathVariable;

  import org.springframework.web.bind.annotation.RequestMapping;

  import org.springframework.web.bind.annotation.RequestMethod;

  import org.springframework.web.bind.annotation.RestController;

  ? ?

  @RestController

  public class HelloWorldController{

  @RequestMapping(value="/hello/{name}",method=RequestMethod.GET)

  publicStringhello(@PathVariable("name")Stringname){

  return"hello"+name;

  }

  }

  跳转路由实现比较简单，实际上是调用了 RequestDispatcher 的 forward 方法进行跳转。

  ? ?

• Ribbon 路由（RibbonRoutingFilter）

  当网关作为 Eureka 客户端注册到 Eureka 服务器时，可以通过配置 serviceId 将请求转发到集群的服务中，使用以下配置，可以执行 Ribbon 路由过滤器：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/hello/speaks地址，路由到http://HELLOWORLD-PROVIDER/speaks，其中具体地址是通过eureka获取

  hello:

  path:/hello/**

  #或者使用url:HELLOWORLD-PROVIDER含义一样

  serviceId:HELLOWORLD-PROVIDER

  与简单路由一样，serviceId 也可以被省略，当省略时，将会使用 routeId 作为 serviceId，简化配置如下：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/hello/speaks地址，路由到http://HELLOWORLD-PROVIDER/speaks，其中具体地址是通过eureka获取

  HELLOWORLD-PROVIDER:

  path:/hello/**

  如果配置了 serviceId 或者 url 的配置项不是简单的路由格式（不以 http： 或 https：开头），也不是跳转路由格式（forward：开头），那么就会执行 ribbon 路由过滤器，配置如下：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/hello/speaks地址，路由到http://HELLOWORLD-PROVIDER/speaks，其中具体地址是通过eureka获取

  hello:

  path:/hello/**

  #或者使用url:HELLOWORLD-PROVIDER含义一样

  url:HELLOWORLD-PROVIDER

  ? ?

  如果后端服务多达十几个的时候，每一个都这样配置也挺麻烦的，spring cloud zuul 已经帮我们做了默认配置，默认情况下，Zuul 会代理所有注册到Eureka Server的微服务，并且 Zuul 的路由规则如下：

  http://ZUUL_HOST:PORT/serviceId/**

  如果想让一个或多个服务被不路由，可以使用 zuul.ignoredServices 属性来配置，如果设置 ‘*‘ 则表示所有服务被忽略，配置如下：

  zuul:

  #不被路由的serviceId，多个使用逗号分割

  ignored-services:HELLOWORLD-PROVIDER

  ? ?

• 忽略路由

  除了使用 zuul.ignoredServices 来忽略路由服务外，还可以使用 zuul.ignoredPatterns 来设置不进行路由的 Url，配置如下：

  #zuul路由配置

  zuul:

  routes:

  #表示http://localhost:9100/hello/speaks地址，路由到http://HELLOWORLD-PROVIDER/speaks，其中具体地址是通过eureka获取

  hello:

  path:/hello/**

  #或者使用url:HELLOWORLD-PROVIDER含义一样

  serviceId:HELLOWORLD-PROVIDER

  ignored-patterns:/hello/noRoute

  ? ?

  访问/hello会被路由到HELLOWORLD-PROVIDER服务，但是/hello/noRoute不会被路由。

? ?

请求头配置

在集群的服务间共享请求头并没有什么问题，但是如果请求会被转发到其他系统，那么对于敏感的请求头信息，就需要进行处理。在默认情况下，HTTP 请求头的 Cookie、SetCookie、Authorization 属性不会传递到"源服务"，可以使用 sensitiveHeaders 属性来配置敏感请求头，下面的配置全局生效：

#zuul路由配置

zuul:

#HTTP请求头不进行转发

sensitive-headers:Cookie,Set-Cookie,Authorization

如果只希望针对一个路由生效，可以在路由下进行配置，如下：

#zuul路由配置

zuul:

routes:

#表示http://localhost:9100/hello/speaks地址，路由到http://HELLOWORLD-PROVIDER/speaks，其中具体地址是通过eureka获取

hello:

path:/hello/**

#或者使用url:HELLOWORLD-PROVIDER含义一样

serviceId:HELLOWORLD-PROVIDER

#HTTP请求头不进行转发

sensitive-headers:Cookie,Set-Cookie,Authorization

? ?

如果每一个路由都需要配置一些额外的敏感Header时，那你可以通过 zuul.ignoredHeaders 来统一设置需要忽略的HTTP请求头，默认情况下，是没有配置的，如果项目中引入了Spring Security，那么Spring Security会自动加上这个配置，默认值为: Pragma、Cache-Control、X-Frame-Options、X-Content-Type-Options、X-XSS-Protection、Expries。

? ?

? ?