我的书签
添加书签
移除书签- listener.ssl.external.handshake_timeout
- listener.ssl.external.keyfile
- listener.ssl.external.certfile
- listener.ssl.external.cacertfile
- listener.ssl.external.dhfile
- listener.ssl.external.verify
- listener.ssl.external.fail_if_no_peer_cert
- listener.ssl.external.ciphers
- listener.ssl.external.psk_ciphers
- listener.ssl.external.secure_renegotiate
- listener.ssl.external.reuse_sessions
- listener.ssl.external.recbuf
- listener.ssl.external.sndbuf
- listener.ssl.external.buffer
- listener.ssl.external.tune_buffer
- listener.ssl.external.nodelay
- listener.ssl.external.reuseaddr
说明
listener.ssl.external.acceptors
| Type | Default |
|---|---|
| integer | 16 |
说明
监听器的接收池大小。
listener.ssl.external.max_connections
| Type | Default |
|---|---|
| integer | 102400 |
说明
监听器允许的最大并发连接数量。
listener.ssl.external.max_conn_rate
| Type | Default |
|---|---|
| integer | 500 |
说明
监听器允许的最大接入速率。单位：个/秒。
listener.ssl.external.active_n
| Type | Default |
|---|---|
| integer | 100 |
说明
监听器持续接收 TCP 报文的次数。
listener.ssl.external.zone
| Type | Default |
|---|---|
| string | external |
说明
监听器所属的配置组 (Zone)。
listener.ssl.external.access.1
| Type | Default |
|---|---|
| string | allow all |
说明
监听器的 ACL 规则列表。它用于设置连接层的白/黑名单。
例如:
allow all：表允许所有的 TCP 连接接入。 allow 192.168.0.0/24：表允许网络地址为 192.168.0.0/24 的 TCP 连接接入。
同时，该配置可配置多条规则:
listener.ssl.external.rate_limit
| Type | Default |
|---|---|
| string | - |
说明
监听器的速率限制。格式为 <limit>,<duration>。
listener.ssl.external.proxy_protocol
| Type | Optional Value | Default |
|---|---|---|
| enum | on, off | - |
说明
监听器是否开启 Proxy Protocol 的支持。
如果 EMQ X 集群部署在 HAProxy 或 Nginx 后，且需要拿到客户端真实的源 IP 地址与端口，则需打开此配置。
Proxy Protcol 参考: https://www.haproxy.com/blog/haproxy/proxy-protocol。
listener.ssl.external.proxy_protocol_timeout
| Type | Default |
|---|---|
| duration | - |
说明
| Type | Default |
|---|---|
| string | tlsv1.2,tlsv1.1,tlsv1 |
说明
指定服务端支持的 SSL 的版本列表。详情请参见 。
listener.ssl.external.handshake_timeout
说明
指定 SSL 握手过程的超时时间。
listener.ssl.external.keyfile
| Type | Default |
|---|---|
| string | etc/certs/key.pem |
说明
指定 SSL 的私钥文件 (PEM)。
listener.ssl.external.certfile
| Type | Default |
|---|---|
| string | etc/certs/cert.pem |
说明
指定 SSL 的证书文件 (PEM)。
listener.ssl.external.cacertfile
| Type | Default |
|---|---|
| string | etc/certs/cacert.pem |
说明
指定 SSL 的 CA 证书文件 (PEM)。
listener.ssl.external.dhfile
| Type | Default |
|---|---|
| string | etc/certs/dh-params.pem |
说明
若使用 Ephemeral Diffie-Helman 算法，指定算法使用的 key 文件。
listener.ssl.external.verify
| Type | Optional Value | Default |
|---|---|---|
| enum | verify_peer, verify_none |
说明
指定握手过程中是否校验客户端。
listener.ssl.external.fail_if_no_peer_cert
| Type | Optional Value | Default |
|---|---|---|
| enum | true, false | false |
说明
SSL 握手过程中若客户端没有证书，是否让握手失败。
listener.ssl.external.ciphers
| Type | Default |
|---|---|
| string | ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-DES-CBC3-SHA,ECDH-ECDSA-AES256-GCM-SHA384,ECDH-RSA-AES256-GCM-SHA384,ECDH-ECDSA-AES256-SHA384,ECDH-RSA-AES256-SHA384,DHE-DSS-AES256-GCM-SHA384,DHE-DSS-AES256-SHA256,AES256-GCM-SHA384,AES256-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256,ECDH-ECDSA-AES128-GCM-SHA256,ECDH-RSA-AES128-GCM-SHA256,ECDH-ECDSA-AES128-SHA256,ECDH-RSA-AES128-SHA256,DHE-DSS-AES128-GCM-SHA256,DHE-DSS-AES128-SHA256,AES128-GCM-SHA256,AES128-SHA256,ECDHE-ECDSA-AES256-SHA,ECDHE-RSA-AES256-SHA,DHE-DSS-AES256-SHA,ECDH-ECDSA-AES256-SHA,ECDH-RSA-AES256-SHA,AES256-SHA,ECDHE-ECDSA-AES128-SHA,ECDHE-RSA-AES128-SHA,DHE-DSS-AES128-SHA,ECDH-ECDSA-AES128-SHA,ECDH-RSA-AES128-SHA,AES128-SHA |
说明
指定服务端支持的密码套件。
listener.ssl.external.psk_ciphers
| Type | Default |
|---|---|
| string | PSK-AES128-CBC-SHA,PSK-AES256-CBC-SHA,PSK-3DES-EDE-CBC-SHA,PSK-RC4-SHA |
说明
若使用 PSK 算法，指定服务端支持的 PSK Cipher 列表。注意 ‘listener.ssl.external.ciphers’ 和 ‘listener.ssl.external.psk_ciphers’ 只能配置一个。
| Type | Optional Value | Default |
|---|---|---|
| enum | on, off | off |
说明
指定在客户端不遵循 RFC 5746 的情况下，是否拒绝 renegotiation 请求。
listener.ssl.external.reuse_sessions
| Type | Optional Value | Default |
|---|---|---|
| enum | on, off | on |
说明
指定是否支持 SSL session 重用。详情见 http://erlang.org/doc/man/ssl.html。
listener.ssl.external.honor_cipher_order
说明
指定是否使用服务端的偏好设置选择 Ciphers。
listener.ssl.external.peer_cert_as_username
| Type | Optional Value | Default |
|---|---|---|
| enum | cn, dn, crt | cn |
说明
listener.ssl.external.backlog
| Type | Default |
|---|---|
| integer | 1024 |
说明
TCP 连接队列的最大长度。它表明了系统中允许的正在三次握手的 TCP 连接队列最大个数。
listener.ssl.external.send_timeout
| Type | Default |
|---|---|
| duration | 15s |
说明
TCP 报文发送超时时间。
listener.ssl.external.send_timeout_close*
| Type | Optional Value | Default |
|---|---|---|
| enum | on, off | on |
说明
TCP 报文发送超时后，是否关闭该连接。
listener.ssl.external.recbuf
| Type | Default |
|---|---|
| bytesize | - |
说明
TCP 接收缓存区大小（操作系统内核级参数）。
参见：。
listener.ssl.external.sndbuf
| Type | Default |
|---|---|
| bytesize | - |
说明
TCP 发送缓存区大小（操作系统内核级参数）。
参见：http://erlang.org/doc/man/inet.html。
listener.ssl.external.buffer
| Type | Default |
|---|---|
| bytesize | - |
说明
TCP 缓冲区大小 (用户级)。
该值建议大于等于 sndbuff 和 recbuff 的最大值，以避免一些性能问题。在不配置的情况下，它默认等于 sndbuff 和 recbuff 的最大值。
参见：。
listener.ssl.external.tune_buffer
| Type | Optional Value | Default |
|---|---|---|
| enum | on, off | - |
说明
如果打开此配置，请设置该值等于 sndbuff 与 recbuff 的最大值。
| Type | Optional Value | Default |
|---|---|---|
| enum | true, false | true |
说明
即 TCP_NODELAY 参数。开启该选项即表示禁用 Nagle 算法，小包将被立即发送。
listener.ssl.external.reuseaddr
| Type | Optional Value | Default |
|---|---|---|
| enum | true, false | true |
