需手动设置X-Forwarded-Port，因Nginx默认不传递该头；应配置proxy_set_header X-Forwarded-Port $server_port;并确保后端信任代理IP且启用转发头解析，否则绝对URL、重定向及安全策略将出错。
当 Nginx 作为反向代理时，后端应用（如 Node.js、Django、Spring Boot）默认只能看到 Nginx 与它通信的本地端口（如 8080），而非用户实际访问的端口（如 443 或 80）。这会导致生成的绝对 URL、重定向地址、安全策略（如 HSTS、CORS）出错。通过设置 X-Forwarded-Port 请求头，可显式告知后端真实入口端口。
为什么需要手动设置 X-Forwarded-Port
Nginx 不会自动添加 X-Forwarded-Port 头——它只默认传递 X-Forwarded-For 和 X-Forwarded-Proto（需启用 proxy_set_header X-Forwarded-Proto $scheme;）。若后端依赖端口号做逻辑判断（例如：拼接回调地址、校验 webhook 来源、配置 WebSocket 升级路径），缺失该头将导致行为异常。
在 location 块中正确设置该头
在 Nginx 配置的 location 块内，使用 proxy_set_header 显式注入端口值。推荐方式是根据 $scheme 动态推导：
-
HTTPS 流量 → 端口为
443，即使你用的是非标端口（如8443），也应设为443（符合 RFC 7239，且多数框架按标准端口理解） -
HTTP 流量 → 端口为
80，同理，不写实际监听端口（如8080） - 直接写死也可，但缺乏灵活性：
proxy_set_header X-Forwarded-Port 443;
更健壮的写法（推荐）：
location / {
proxy_pass http://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;
proxy_set_header X-Forwarded-Port $server_port;
}
⚠️ 注意：$server_port 是 Nginx 监听的实际端口（如 80 或 443），不是后端服务端口。若你在非标端口（如 8080）上提供 HTTPS，则需配合 map 指令做映射，避免传错。
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
后端如何安全使用该头
仅设置请求头还不够——后端必须明确信任并解析它。不同框架处理方式不同：
-
Express（Node.js）：启用
app.set('trust proxy', true)后，req.port或req.get('X-Forwarded-Port')可读取；但注意需限定可信代理 IP，防止伪造 -
Spring Boot：配置
server.forward-headers-strategy=framework，并确保TomcatServletWebServerFactory设置了setRemoteIpHeader("X-Forwarded-For")和setProtocolHeader("X-Forwarded-Proto")；X-Forwarded-Port通常由ForwardedHeaderFilter自动识别 -
Django：需开启
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')，但原生不解析X-Forwarded-Port，需中间件手动读取request.META.get('HTTP_X_FORWARDED_PORT')
关键原则：永远只从已知可信代理（即你的 Nginx）接收该头，禁止在公网直连场景下启用。
验证是否生效
临时在后端加一行日志或响应头，输出接收到的 X-Forwarded-Port 值：
- cURL 测试：
curl -H "X-Forwarded-Port: 443" https://yoursite.com/health（模拟，但仅用于调试） - 查看 Nginx 访问日志是否记录该头：
log_format main '$http_x_forwarded_port ...'; - 用浏览器开发者工具检查后端返回的响应头或日志输出，确认值为
80或443，而非8080等内部端口
若始终为空，检查 Nginx 配置是否被其他 location 覆盖、是否遗漏 proxy_set_header、或后端未启用转发头支持。
