Go服务监听地址必须设为127.0.0.1而非0.0.0.0，以确保仅通过Nginx反向代理暴露，从而实现TLS终止、限流和统一日志；需配合upstream配置、正确透传Host头、设置超时参数并校准Nginx与Go的超时值。
Go服务监听地址必须设为 127.0.0.1 而非 0.0.0.0
Nginx反向代理的前提是 Go 服务只对本机暴露，否则会绕过 Nginx 直接被外部访问，失去 TLS 终止、限流、日志统一等关键能力。
常见错误是开发时用 http.ListenAndServe(":8080", handler)，这等价于 http.ListenAndServe("0.0.0.0:8080", handler)，生产环境必须显式绑定回环地址：
http.ListenAndServe("127.0.0.1:8080", handler)- 如果用
net/http的Server结构体，Addr字段也应设为"127.0.0.1:8080" - 某些云环境（如 Docker）中，
127.0.0.1在容器内仅指向自身，需确认 Go 服务与 Nginx 是否同容器或同宿主机网络；跨容器部署时改用宿主机 IP 或 Docker 网络别名 - Linux 上若启用
net.ipv4.ip_nonlocal_bind=1，127.0.0.1绑定可能被绕过，建议配合防火墙规则限制端口访问
Nginx upstream 配置要避免硬编码 127.0.0.1
直接写 proxy_pass http://127.0.0.1:8080 看似简单，但会导致连接复用失效、健康检查缺失、多实例负载不均等问题。
正确做法是定义 upstream 块，哪怕只有一台后端：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
upstream go_backend {
server 127.0.0.1:8080 max_fails=3 fail_timeout=30s;
}-
max_fails和fail_timeout让 Nginx 主动摘除异常的 Go 实例（比如 panic 后进程僵死但端口仍通） - 后续扩为多实例（如
server 127.0.0.1:8081）时，只需加行，无需改proxy_pass - 若 Go 服务使用 systemd 管理，建议配合
Restart=on-failure和StartLimitIntervalSec=60，与 Nginx 健康检查节奏对齐
必须设置 proxy_set_header Host $host
Go 服务里常通过 r.Host 或 r.URL.Host 构造绝对 URL（比如 OAuth 回调地址、邮件中的链接），若 Nginx 不透传原始 Host，这些链接会变成 127.0.0.1:8080 或空值，导致功能断裂。
完整推荐的代理头配置：
location / {
proxy_pass http://go_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}-
$host是客户端请求的 Host 头，不是$http_host（后者可能带端口，且未标准化） - Go 中读取真实 IP 应优先用
r.Header.Get("X-Real-IP")，而非r.RemoteAddr（后者永远是 Nginx 的 IP） - 若 Nginx 启用了 HTTPS，
X-Forwarded-Proto能让 Go 服务判断是否该生成 https:// 链接
Go 的 HTTP Server 要主动处理超时和长连接
Nginx 默认 proxy_read_timeout 是 60 秒，而 Go 的 http.Server 默认无读写超时，一旦后端卡住（如 DB 查询阻塞），连接会堆积并最终耗尽 Nginx worker 连接数。
必须显式配置超时参数：
srv := &http.Server{
Addr: "127.0.0.1:8080",
Handler: handler,
ReadTimeout: 30 * time.Second,
WriteTimeout: 30 * time.Second,
IdleTimeout: 60 * time.Second,
}-
ReadTimeout从连接建立开始计时，覆盖 TLS 握手和请求头读取；若 Go 服务启动慢，需略大于 Nginx 的proxy_connect_timeout -
IdleTimeout控制 keep-alive 空闲时间，应 ≥ Nginx 的keepalive_timeout（默认 75s），否则 Nginx 可能复用已关闭的连接 - 不要依赖
context.WithTimeout包裹 handler——它无法中断底层 TCP 连接，只能中断业务逻辑
Go 服务与 Nginx 的超时参数必须成对校准，差 1 秒都可能引发 502 或连接泄漏。实际部署前，用 ab -n 100 -c 10 <a href="https://www.php.cn/link/da8f01d7f98d024b5edc57f1c45fda15">https://www.php.cn/link/da8f01d7f98d024b5edc57f1c45fda15</a> 和 ss -tn state established | grep :8080 观察连接生命周期，比看文档更可靠。
