网关属性配置

本篇主要讲解如何在 Apache Shenyu 网关配置 ShenYu 的相关属性。

属性配置

shenyu:#  httpclient:#    strategy: webClient#    connectTimeout: 45000#    readTimeout: 3000#    writeTimeout: 3000#    wiretap: false#    pool:#      type: ELASTIC#      name: proxy#      maxConnections: 16#      acquireTimeout: 45000#    proxy:#      host:#      port:#      username:#      password:#      nonProxyHostsPattern:#    ssl:#      useInsecureTrustManager: false#      trustedX509Certificates:#      handshakeTimeout:#      closeNotifyFlushTimeout:#      closeNotifyReadTimeout:#      defaultConfigurationType:  file:    enabled: true  cross:    enabled: true  exclude:    enabled: false    paths:      - /favicon.ico  sync:    websocket:      urls: ws://localhost:9095/websocket      allowOrigin: ws://localhost:9195 #    zookeeper:#      url: localhost:2181#      sessionTimeout: 5000#      connectionTimeout: 2000#    http:#      url: http://localhost:9095#    nacos:#      url: localhost:8848#      namespace: 1c10d748-af86-43b9-8265-75f487d20c6c#      username:#      password:#      acm:#        enabled: false#        endpoint: acm.aliyun.com#        namespace:#        accessKey:#        secretKey:#    etcd:#      url: http://localhost:2379#    consul:#      url: http://localhost:8500#      waitTime: 1000#      watchDelay: 1000

属性详解

shenyu.httpclient 配置

这是 ShenYu 网关中代理Http及SpringCloud协议后，用于发送代理请求的HttpClient配置。

Name	Type	Default	Required	Description
strategy	String	webcwebClient	No	HttpClientPlugin实现策略（默认使用webClietn）： - webClient：使用WebClientPlugin - netty：使用NettyHttpClientPlugin
connectTimeout	int	45000	No	连接超时时间 (毫秒)，默认值为 45000.
readTimeout	int	3000	No	读取超时 (毫秒)，默认值为 3000.
writeTimeout	int	3000	No	输出超时 (millisecond)，默认值为 3000.
wiretap	Boolean	false	No	启用 Netty HttpClient 的窃听调试，默认值为 false。
pool				HttpClient连接池配置
proxy				HttpClient代理配置
ssl				HttpClient SSL配置

• pool config

HttpClient连接池配置：

Name	Type	Default	Required	Description
type	String	ELASTIC	No	HttpClient连接池类型，默认值为ELASTIC。 - ELASTIC: 连接池可以按需缓存和增长。 - FIXED: 连接池缓存并重用，有固定的最大连接数。 - DISABLED: 连接池总是会创建一个新的连接。
name	String	proxy	No	连接池映射名称，默认为proxy。
maxConnections	int	2*可用处理器数，最小值为16	No	仅适用于 FIXED 类型，在现有连接上开始挂起获取之前的最大连接数。 默认值为可用处理器数*2。 (最小值为 16)
acquireTimeout	int	45000	No	仅适用于 FIXED 类型，等待获取连接的最长时间（毫秒）。默认值为 45000

• Proxy config

Netty HttpClient 代理的相关配置：

Name	Type	Default	Required	Description
host	String	null	No	Netty HttpClient 代理配置的主机名。
port	String	null	No	Netty HttpClient 的代理配置端口。
username	String	null	No	Netty HttpClient 代理配置的用户名。
password	String	null	No	Netty HttpClient 代理配置的密码。
nonProxyHostsPattern	String	null	No	直连的主机列表的正则表达式 (Java)。

• SSL config

网关路由可以同时支持路由到http和https的后端服务，以下为SSL相关配置：

Name	Type	Default	Required	Description
useInsecureTrustManager	Boolean	false	No	是否信任所有下游证书，默认false
trustedX509Certificates	Array	Null	No	配置自己的信任的证书列表。
handshakeTimeout	int	10000	No	SSL握手超时时间（毫秒），默认值为10000
closeNotifyFlushTimeout	int	3000	No	SSL close_notify 刷新超时（毫秒）默认值为 3000.
closeNotifyReadTimeout	int	0	No	SSL close_notify 读取超时（毫秒）默认值为 0.
defaultConfigurationType	String	TCP	No	SslContextBuilder 的默认配置， 默认为 TCP. - H2: SslProvider 将根据 OpenSsl.isAlpnSupported()、SslProvider.HTTP2_CIPHERS、ALPN 支持、HTTP/1.1 和 HTTP/2 支持进行设置 - TCP: SslProvider 将根据 OpenSsl.isAvailable() 设置 - NONE: 不会有默认配置

过滤器相关配置

• shenyu.file 配置

文件过滤器的相关配置。

名称	类型	默认值	是否必填	说明
enabled	Boolean	false	否	是否开启文件大小过滤

• shenyu.cross 配置

跨域相关配置。

名称	类型	默认值	是否必填	说明
enabled	Boolean	false	否	是否支持跨域请求

• shenyu.exclude 配置

拒绝指定请求经过网关的相关配置

名称	类型	默认值	是否必填	说明
enabled	Boolean	false	否	是否拒绝指定请求经过网关
paths	Array	无	是	匹配该列表的请求不经过网关（支持路径匹配）

shenyu.sync 配置

网关和Admin端使用数据同步的相关配置。

使用websocket进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
urls	String	无	是	Admin的websocket服务地址，多个地址用 , 分开 。

使用zookeeper进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
url	String	无	是	zookeeper的连接地址
sessionTimeout	int	无	是	session的超时时间（毫秒）
connectionTimeout	int	无	是	连接超时时间（毫秒）

使用http长轮询进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
url	String	无	是	Admin的服务地址

使用nacos进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
url	String	无	是	nacos连接地址
namespace	String	无	是	命名空间
username	String	无	否	用户名
password	String	无	否	密码
acm			否	阿里云ACM服务配置

• acm配置

名称	类型	默认值	是否必填	说明
enabled	boolean	false	否	是否启用
endpoint	String	无	是	ACM服务地址
namespace	String	无	否	namespace
accessKey	String	无	否	accessKey
secretKey	String	无	否	secretKey

使用etcd进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
url	String	无	是	etcd连接地址

使用consul进行数据同步的属性配置如下：

名称	类型	默认值	是否必填	说明
url	String	无	是	consul连接地址
waitTime	int	无	是	请求consul服务拉取配置信息的超时时间（毫秒）
watchDelay	int	无	是	同步间隔（毫秒）