容器化Nginx代理超时须四维协同：一查网络拓扑（bridge下宿主机用172.17.0.1，跨容器用自定义网络+服务名）；二分层设timeout（connect/send/read各司其职，内网connect建议3–5秒）；三配健康检查（interval略大于connect_timeout，配合内核somaxconn等调优）；四实测验证（nc/tcpdump+debug日志确认超时阶段）。
容器化环境里 Nginx 代理超时问题，不能只改配置，得从网络拓扑、参数分层、健康探测和实测验证四方面一起动。
先理清容器网络通信路径
默认 bridge 模式下，Nginx 容器访问宿主机服务不能写 127.0.0.1，那是容器自己的回环地址。真实可用的宿主机网关是 docker0 接口 IP（通常是 172.17.0.1）。如果后端服务跑在宿主机上，upstream 应配成：
- server 172.17.0.1:8080;
跨容器调用更推荐创建自定义 bridge 网络，用服务名解析：
- docker network create app-net
- 启动 Nginx 和后端容器时都加
--network app-net - upstream 中直接写
server backend:8080;
分阶段设 proxy 超时参数
三个关键 timeout 各管一段，不能全设成 60 秒：
- proxy_connect_timeout：只管 TCP 握手，内网容器间建议 3～5 秒；跨可用区或混合云可到 8～12 秒；超过 15 秒要查网络质量
- proxy_send_timeout：控制发请求体的间隔，上传大文件时可设 60 秒，普通接口保持 30 秒即可
- proxy_read_timeout：等后端首字节返回，导出类接口建议 300 秒，API 接口 60 秒够用
这些统一写在 http 块顶部，特殊路径再局部覆盖，比如：
- location /export/ { proxy_read_timeout 300s; }
- location /health/ { proxy_read_timeout 2s; }
必须配健康检查 + 内核调优
光调 timeout 不解决“持续打到挂掉节点”的问题：
- 用 nginx_upstream_check_module（开源版）或 health_check（Plus 版），interval 设为比 connect_timeout 大 2～5 秒
- fails 设 2 次，passes 设 1，避免误摘又确保快速恢复
- Linux 内核同步调优：
net.core.somaxconn=65535、net.ipv4.tcp_max_syn_backlog=65535、net.ipv4.ip_local_port_range="1024 65535" - Nginx stream 或 http upstream 的 listen 行加上
backlog=65535
验证是否真生效
改完别信配置语法对就完事，得动手测：
- 停掉一个后端容器，用
nc -zv backend-ip 8080看连接耗时是否接近你设的proxy_connect_timeout - 开 error_log debug 级别，搜
connect() failed或upstream timed out日志，确认触发阶段 - tcpdump 抓包看是 SYN 未回复（connect 阶段失败），还是 ACK 后无数据（read/send 阶段超时）
不复杂但容易忽略
