必须设置 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 动态传值 + 后端主动信任，两者缺一不可。
