Nginx 跨机房 TCP 保活需四项配置协同：upstream keepalive 连接池、proxy_http_version 1.1、proxy_set_header Connection ""、proxy_socket_keepalive on idle interval probes；并同步调小系统 TCP keepalive 参数，最后用 tcpdump 验证探测包。
要解决跨机房 TCP 连接因中间网络设备（如防火墙、云负载均衡、运营商 NAT 网关）静默关闭空闲连接导致的“Connection reset by peer”或超时失败，关键不是等错误发生后再处理，而是让 Nginx 主动探测 upstream 连接是否真实存活。proxy_socket_keepalive 就是这个 TCP 层保活机制，但它必须与其他三项配置协同生效，单独开启无效。
四项配置必须同时启用
缺一不可，否则 proxy_socket_keepalive 不起作用：
-
upstream 块中启用 keepalive 连接池：例如
keepalive 64;（数值建议为后端实例数 × 平均并发连接数，常见 32–128），否则 Nginx 不复用连接，保活无意义 -
location 或 server 块中声明 HTTP/1.1：添加
proxy_http_version 1.1;，确保后端支持持久连接 -
清除 Connection 头：设置
proxy_set_header Connection "";，防止 Nginx 自动注入Connection: close导致后端立即断连 -
显式开启并调优 proxy_socket_keepalive：不能只写
on，需指定参数，例如proxy_socket_keepalive on 300s 10s 3;
针对跨机房链路调优探测参数
跨机房链路通常经过多层中间设备，其空闲超时普遍较短（常见 300–600 秒），而 Linux 内核默认 keepalive（7200 秒才首次探测）完全无法覆盖该窗口。必须让探测在设备切断前完成：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
idle（首探延迟）：设为中间设备超时值的 70%～80%，例如设备超时为 5 分钟（300 秒），则设
300s或保守起见用240s - interval（探测间隔）：建议 5–15 秒，10 秒在多数跨机房场景中平衡及时性与内核开销
-
probes（失败重试次数）：设为
3即可，既能容忍偶发丢包，又不会过度等待
示例完整写法：proxy_socket_keepalive on 300s 10s 3;
同步调整系统级 TCP 参数
Nginx 的 proxy_socket_keepalive 依赖内核 TCP keepalive 行为。若系统参数未同步调小，Nginx 配置可能被内核忽略：
- 检查当前值：
sysctl net.ipv4.tcp_keepalive_time net.ipv4.tcp_keepalive_intvl net.ipv4.tcp_keepalive_probes - 推荐临时调整：
sysctl -w net.ipv4.tcp_keepalive_time=300 net.ipv4.tcp_keepalive_intvl=10 net.ipv4.tcp_keepalive_probes=3 - 写入配置文件持久化：
echo "net.ipv4.tcp_keepalive_time = 300" >> /etc/sysctl.conf，然后sysctl -p
验证是否真正生效
仅靠 nginx -t 或日志无法确认保活是否启动，必须从网络层验证：
- 在 Nginx 服务器上抓包：
tcpdump -i any port 8080 -nn -vv -A（替换为 upstream 端口） - 观察是否有周期性 TCP keepalive 探测包（含 ACK + zero-length payload）及对应 ACK 响应
- 若长时间无数据但持续出现 keepalive 流量，说明配置已生效
