如何用Nginx proxy_set_header将X-Forwarded-Port转成长尾词？

本文共计973个文字，预计阅读时间需要4分钟。

直接说结论：

为什么 X-Forwarded-Port 在多层代理中经常为空或错乱

CDN 层几乎从不设置 X-Forwarded-Port：Cloudflare 固定用 443/80，阿里云 CDN 默认不透传端口信息，腾讯云 CDN 仅在开启“透传客户端端口”开关时才可能带，但该开关实际影响的是 X-Forwarded-For 的端口部分，而非独立的 X-Forwarded-Port 头。Nginx 默认也不会自动填充它——$scheme 只能告诉你协议，不能告诉你客户端连的是 443 还是 8443。

常见错误现象包括：

• 后端生成跳转链接变成 http://example.com:8080（Nginx 回源走 HTTP 8080，但用户实际访问的是 HTTPS 443）
• Django 的 request.build_absolute_uri() 返回带错端口的 URL
• Spring Boot 的 server.forward-headers-strategy=framework 未识别端口，导致 OAuth redirect_uri 校验失败

proxy_set_header X-Forwarded-Port $server_port 的陷阱

很多人直接写 proxy_set_header X-Forwarded-Port $server_port;，但这只在 Nginx 直接暴露给用户时有效。