TCP 前端部署
前端不是必需的。中继自行终止 TLS 1.3 并自行获取证书(参见快速入门)。只有当其他服务必须与中继共享本机 443 端口时,才使用这种部署方式。
TLS 必须在中继处终止
Section titled “TLS 必须在中继处终止”协议第 2 版把每个客户端的密钥证明以及中继的身份签名,都绑定到客户端与中继之间的 TLS 会话上。因此:
- 支持: 本机上的 TCP(第 4 层)透传,把原始字节转发给中继,并在每个连接前加上 PROXY 协议 v2 头。支持两种前端:使用
send-proxy-v2的 HAProxy,以及使用proxy_protocol v2的 Caddy(caddy-l4 插件)。 - 不支持: 任何在中继前终止 TLS 的东西:Caddy
reverse_proxy、在ssl监听上的 nginxproxy_pass、HAProxymode http、代理模式的 CDN,或终止 TLS 的负载均衡器。两端看到的是不同的 TLS 会话,所有连接都会失败;应用会显示 “This server couldn’t prove its identity”。 - 不支持: nginx 的 stream 模块。它只发送 PROXY 协议第 1 版,而中继会拒绝第 1 版。
旧的部署方式(由代理终止 TLS、中继在回环地址上以 --no-tls 运行)已无法使用。
rchat-core 仓库中的 rchat/config/server-behind-proxy.toml 是这种部署方式的配置模板,由发布的单元 rchat-server-proxy.service 运行。要点如下:
# /etc/rchat/server.toml,位于公网 :443 的 TCP 透传之后[server]bind_addr = "127.0.0.1:8443"max_connections = 10000# 每个连接都来自前端的地址:# 这里不设按地址的上限(在前端中限制)。max_connections_per_ip = 0max_connections_per_ipv6_48 = 0# 前端通过 PROXY 协议 v2 发送客户端地址。proxy_protocol = truewebsocket_path = "/CHANGE-ME-to-a-long-random-path"relay_identity_path = "/var/lib/rchat/relay_identity.key"
# 中继自行终止 TLS 1.3。续期证书后发送 SIGHUP#(systemctl reload rchat-server)。[server.tls]cert_path = "/etc/rchat/tls/fullchain.pem"key_path = "/etc/rchat/tls/privkey.pem"
[metrics]bind_addr = "127.0.0.1:9090"
[decoy]enabled = false当前端把该域名在公网 :443 上的所有连接都转发过来时,内置 ACME(用 [server.acme] 代替 [server.tls])同样可用,因为 Let’s Encrypt 的 TLS-ALPN-01 检查会到达中继。
先创建一次中继身份,再安装单元:
sudo -u rchat /usr/local/bin/rchat-server --config /etc/rchat/server.toml --init-relay-identitycurl -fsSL -o rchat-server.service https://assets.r-chat.net/2.1.1/rchat-server-proxy.servicesudo install -m 0644 rchat-server.service /etc/systemd/system/rchat-server.servicesudo systemctl daemon-reloadsudo systemctl enable --now rchat-server该单元运行 rchat-server --config /etc/rchat/server.toml --bind 127.0.0.1:8443,TLS 来自配置文件。1024 以上的回环端口不需要任何 capability。
proxy_protocol
Section titled “proxy_protocol”设置 proxy_protocol = true 时,中继在 TLS 握手之前从原始 TCP 流中读取 PROXY v2 头(5 秒内),并只把其源地址用于按来源的公平份额:待处理请求、电路、存储的消息请求、每日请求配额以及削减(参见资源限制)。它从不用于连接上限、认证或日志。
- 解析器很严格:只接受第 2 版,命令为 LOCAL 和 PROXY,IPv4 或 IPv6 上的 TCP,最多 16 + 216 字节。没有有效头的连接会被关闭(
reason="proxy_header")。 - TCP 对端不是回环地址的连接,在读取任何数据之前就被拒绝,并记录警告(
reason="proxy_not_loopback")。 - 除非
max_connections_per_ip = 0、max_connections_per_ipv6_48 = 0且bind_addr为回环地址(127.0.0.1或::1;通配地址会被拒绝),否则设置proxy_protocol = true的中继会拒绝启动。 - 两端必须一致。 如果前端不发送 PROXY v2,所有连接都会被关闭;如果中继设置为
proxy_protocol = false,该头会破坏所有 TLS 握手。
信任边界。 中继相信任何能连接到其回环端口的进程发来的 PROXY 头,因此本机任何用户或进程都可以声称任意源地址。最坏的情况是扭曲公平份额。如果您在意公平性,请不要在与不受信任用户共享的主机上运行中继。
在不带 PROXY v2 的透传之后,每个连接都来自前端的地址。请把两个按地址的上限都设为 0;此时按来源的公平份额关闭,一个客户端可能挤占其他所有人的请求。
中继不读取 X-Forwarded-For。原来的 trusted_proxy 设置已被移除:仍设置它的配置会拒绝启动,并提示改用 proxy_protocol。
HAProxy
Section titled “HAProxy”包含按客户端的连接上限,用来代替中继的 max_connections_per_ip:
frontend rchat mode tcp bind :::443 v4v6 # 每个客户端地址最多 64 个并发连接。 stick-table type ipv6 size 1m expire 10m store conn_cur tcp-request connection track-sc0 src tcp-request connection reject if { sc0_conn_cur gt 64 } default_backend relaybackend relay mode tcp server r1 127.0.0.1:8443 send-proxy-v2使用 caddy-l4 的 Caddy
Section titled “使用 caddy-l4 的 Caddy”Caddy 需要 caddy-l4 插件(xcaddy build --with github.com/mholt/caddy-l4)。rchat-core 仓库中的 rchat/config/Caddyfile:
{ layer4 { :443 { route { proxy { proxy_protocol v2 upstream 127.0.0.1:8443 } } } }}该文件没有站点块,因此 Caddy 的 HTTP 应用不会占用 :443。据我们所知,caddy-l4 无法按客户端地址限制并发连接数(其 throttle 处理器只限制带宽),因此在这种部署方式下,一个客户端最多可以打开 max_connections 个连接。如果需要按客户端的上限,请使用 HAProxy,或让中继自己占用 :443。
# 出示的证书必须是中继自己的,而不是前端的。openssl s_client -connect chat.example.com:443 -servername chat.example.com </dev/null | head -20curl -s http://127.0.0.1:9090/metrics | grep -E 'reason="proxy_(header|not_loopback)"'然后用应用连接一次。proxy_header 计数持续增长通常意味着前端没有发送 PROXY v2。