关键是用独立server块分离HTTP/HTTPS处理:HTTP块仅return 301跳转,HTTPS块禁用任何跳转指令;域名用$server_name或白名单校验$host;合并HTTPS与www逻辑一步跳转;后端需信任X-Forwarded-Proto头。

要让 Nginx 的 HTTPS 重定向既安全又高效,关键是“一步到位、不重复判、不依赖不可信输入”。多次 301 跳转(比如 HTTP → HTTPS → www → HTTPS+www)不仅拖慢访问速度,还容易触发浏览器 ERR_TOO_MANY_REDIRECTS 错误。
用独立 server 块分离 HTTP 和 HTTPS 处理
HTTP 和 HTTPS 必须由两个完全分开的 server 块承担职责,不能混在一起:
- HTTP server(listen 80)只做一件事:return 301 跳转到 HTTPS,不加任何 if、rewrite 或 proxy 指令
- HTTPS server(listen 443 ssl)里绝对不要出现 return 301 https://... 或 rewrite ... permanent 这类跳转指令——否则已加密的请求会被再次推回 HTTPS,立刻形成循环
- 确保 HTTPS server 中的 ssl_certificate 和 ssl_certificate_key 指向有效证书,否则跳过去就报证书错误,用户打不开
跳转目标域名必须来自可信源
避免用 $host 构造跳转地址,它来自客户端 Host 请求头,可被任意伪造,存在 Host 注入风险:
- 单域名站点推荐写死:return 301 https://example.com$request_uri;
- 多域名共用时,优先用 $server_name(配置中显式声明的合法域名),如 return 301 https://$server_name$request_uri;
- 若需支持泛域名或 CDN 场景,且必须用 $host,请先用 map 或 if 白名单校验:比如只允许 example.com、www.example.com、cdn.example.com 才参与跳转
合并跳转逻辑,禁止链式跳转
强制 HTTPS 和强制 www(或去 www)不能分两步走,否则会多一次 301:
- 错误做法:先在 HTTP 块里跳 HTTPS,再在 HTTPS 块里判断是否 www 并跳转——这造成两次 301
- 正确做法:在 HTTP server 中一步到位,例如 return 301 https://www.example.com$request_uri;
- 如果需要灵活处理(比如部分域名保留非 www),可用 map 提前判断 host,再统一跳转,避免嵌套 if
后端也要配合识别真实协议
Nginx 把请求转发给后端应用(如 Django、Spring Boot、WordPress)时,后端默认只看到 HTTP 协议。若不告诉它“用户实际是走 HTTPS 来的”,它自己也会跳回 HTTP,和 Nginx 形成闭环:
- 在 HTTPS server 块中添加:proxy_set_header X-Forwarded-Proto $scheme;
- 同时配好 proxy_set_header Host $host; 和 proxy_set_header X-Real-IP $remote_addr;
- 后端框架必须启用对 X-Forwarded-Proto 的信任(例如 Django 的 SECURE_PROXY_SSL_HEADER,Spring Boot 的 server.forward-headers-strategy=framework)











