必须设置 proxy_set_header x-forwarded-proto $scheme 并配置后端信任该头，否则后端误判协议导致url、重定向和cookie异常；还需同步设置x-forwarded-for、x-forwarded-host等头并验证生效。

在 Nginx 作为反向代理时，如果客户端通过 HTTPS 访问 Nginx，而 Nginx 再以 HTTP 协议转发请求给后端（如 Flask、Django、Node.js 等），后端默认会认为原始请求是 HTTP，导致生成的 URL、重定向、安全 Cookie 等出错。解决方法是用 proxy_set_header X-Forwarded-Proto 显式告诉后端原始协议。

为什么要设置 X-Forwarded-Proto

后端应用通常依赖 X-Forwarded-Proto 判断用户真实访问协议。例如：

• Django 的 SECURE_PROXY_SSL_HEADER 依赖它识别 HTTPS 请求；
• Flask 的 request.scheme 在未配置时默认返回 http；
• Spring Boot 的 server.forward-headers-strategy=framework 会读取该头；
• 生成绝对 URL（如密码重置链接）时若误判为 HTTP，会导致混合内容或跳转失败。

正确配置 proxy_set_header X-Forwarded-Proto

在 Nginx 的 location 或 server 块中添加：

proxy_set_header X-Forwarded-Proto $scheme;

其中 $scheme 是 Nginx 内置变量，值为 http 或 https，自动匹配客户端发起的协议。不要硬编码成 https，否则 HTTP 请求也会被标记为 HTTPS，引发后端逻辑错误。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

同时建议一并设置其他常用转发头：

• proxy_set_header X-Forwarded-For $remote_addr;（记录原始客户端 IP）
• proxy_set_header X-Forwarded-Host $host;（保留原始 Host）
• proxy_set_header X-Forwarded-Port $server_port;（可选，用于特殊端口场景）

后端需配合启用信任代理头

仅 Nginx 设置不够，后端必须明确信任来自代理的 X-Forwarded-* 头，否则会忽略它们：

• Django：设置 SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')，并确保 USE_X_FORWARDED_HOST = True；
• Flask：使用 ProxyFix 中间件，如 app.wsgi_app = ProxyFix(app.wsgi_app, x_proto=1)；
• Express/Node.js：启用 app.set('trust proxy', true)；
• Nginx 自身做 HTTPS 终止时，还需确认 listen 443 ssl 已配置且证书有效，否则 $scheme 不会是 https。

验证是否生效

可在后端打印请求头或日志检查：

• 查看日志中是否收到 X-Forwarded-Proto: https；
• 用 curl 模拟请求：curl -H "X-Forwarded-Proto: https" http://your-nginx-host/，观察后端响应行为；
• 访问页面后检查浏览器开发者工具的 Network 标签页，确认重定向 URL 或 API 返回的链接是否为 https:// 开头。

不复杂但容易忽略。关键是 Nginx 动态传值 + 后端主动信任，两者缺一不可。