最推荐方式是使用 return 301 指令在监听 80 端口的 server 块中配置 https://$host$request_uri 跳转,高效、无正则开销、语义清晰;同时必须配置独立的 443 ssl server 块并启用有效证书。

在 Nginx 中实现 HTTP 自动跳转到 HTTPS,最常用、最推荐的方式是使用 return 301(而非 rewrite),因为它更高效、语义更清晰、配置更简洁。虽然标题提到 rewrite,但实际生产环境中应避免用 rewrite ... permanent 做全站跳转,它多一层正则匹配和重写开销,且容易出错。
✅ 推荐方式:用 return 301 实现强制跳转
在 HTTP 服务块(监听 80 端口)中直接返回 301 重定向,指向当前域名的 HTTPS 版本:
server {
listen 80;
server_name example.com www.example.com;
<pre class="brush:php;toolbar:false;"># 强制跳转到 HTTPS,保持原始请求路径和参数
return 301 https://$server_name$request_uri;
}
-
$server_name:复用配置中的域名,支持多域名时建议配合
if或拆分为多个 server 块(更安全) -
$request_uri:完整保留路径、查询参数(如
/path?k=v),比$uri?$args更可靠 - 务必确保对应域名已在 HTTPS 的
server块中正确配置 SSL 证书和listen 443 ssl
⚠️ 不推荐方式:用 rewrite 实现跳转(仅作了解)
如果坚持用 rewrite,需注意语法和作用域:
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># ❌ 错误:无条件 rewrite /,会丢失路径和参数
# rewrite ^(.*)$ https://$server_name$1 permanent;
# ✅ 可行但冗余(等价于 return)
rewrite ^(.*)$ https://$server_name$1 permanent;
}
- 正则
^(.*)$捕获全部路径,$1回填,permanent表示 301 - 问题:正则引擎额外开销;若
server_name为空或未设,可能跳转到错误地址;不处理端口、子路径嵌套等边界情况 - 不支持在
location块外直接用rewrite(Nginx 会报错),必须放在server或location内
? 补充要点:确保 HTTPS 服务正常运行
跳转只是第一步,后端 HTTPS server 必须就绪:
- 监听
443 ssl,配置ssl_certificate和ssl_certificate_key - 建议启用 HSTS(防降级):
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; - 若使用 CDN 或反向代理(如 Cloudflare),注意真实客户端 IP 和协议头(
X-Forwarded-Proto),此时跳转逻辑可能需在上层做,或 Nginx 根据头判断:if ($http_x_forwarded_proto = 'http') { return 301 https://$host$request_uri; }(慎用 if,优先用 map)
? 小技巧:批量域名统一跳转
多个域名共用一套跳转逻辑,可用 map 提前映射 HTTPS 主机名:
map $host $https_host {
default $host;
www.example.com example.com;
}
<p>server {
listen 80;
server_name example.com www.example.com;</p><pre class="brush:php;toolbar:false;">return 301 https://$https_host$request_uri;
}
- 避免
$server_name在多域名时只取第一个,导致跳转地址不一致 - map 在全局 http 块中定义,性能好且逻辑清晰











