zuul路由配置详解

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

简单路由（SimpleHostRoutingFilter）

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

#zuul路由配置
zuul:
  routes:
  #person为路由名
  person:
    path:/person/**
    url:http://localhost:8080

该配置访问 http://localhost:9100/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/**
       # 注册在eureka的服务名
       serviceId:HELLOWORLD-PROVIDER

与简单路由同样，serviceId 也能够被省略，当省略时，将会使用 routeId 做为 serviceId，简化配置以下：

#zuul路由配置
zuul:
  routes:
    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

若是后端服务多达十几个的时候，每个都这样配置也挺麻烦的，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:
  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。