Nginx 怎么在 Nginx 中配置全站强制将 HTTP 协议重写为 HTTPS 协议-Nginx-PHP中文网

最推荐用 return 301 实现 http 到 https 跳转，语法简洁高效、保留完整路径和查询参数、seo友好；需确保 https server 块已正确配置并放行 443 端口，修改后执行 nginx -t 和 nginx -s reload 验证。

nginx 怎么在 nginx 中配置全站强制将 http 协议重写为 https 协议

直接在 Nginx 配置中新增一个监听 80 端口的 `server` 块，用 `return 301` 指令跳转，是最简洁、高效且符合规范的做法。它天然保留原始路径和全部查询参数，对 SEO 友好，也避免了正则匹配开销。

推荐写法：使用 return 301（首选）

在你的 Nginx 配置文件（如 /etc/nginx/conf.d/your-site.conf 或 /www/server/nginx/conf/vhost/域名.conf）中，添加或确认存在如下配置：

listen 80; 必须监听 HTTP 默认端口
server_name 要与 HTTPS 的 server 块保持一致（例如 example.com www.example.com）
return 301 https://$host$request_uri; —— 关键：$request_uri 包含完整路径 + 查询参数（如 /login?next=/admin），不会丢失

示例：

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

备选写法：rewrite + permanent（兼容旧版本）

如果因历史原因需用 rewrite，语法等效但稍冗余：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

必须加 permanent 标志，等价于 301 状态码
^ 表示匹配任意 URI，$1 在这里不生效；应直接用 $request_uri
正确写法：rewrite ^ https://$host$request_uri permanent;

⚠️ 注意：不要写成 rewrite ^(.*)$ https://$host$1 permanent; —— $1 在 ^(.*)$ 中虽能捕获，但不如 $request_uri 直观可靠，且易在特殊字符下出错。

关键前提与验证要点

确保以下条件已满足，否则跳转会失败或报错：

HTTPS 的 443 端口 server 块已正确配置（含 ssl_certificate、ssl_certificate_key 等）
防火墙或云服务商安全组已放行 443 端口
修改后执行 nginx -t 检查语法，再 nginx -s reload 生效
验证方式：
• curl -I http://example.com/path?x=1 → 应返回 HTTP/1.1 301 Moved Permanently 和正确的 Location 头
• 浏览器访问 http://example.com/test?a=b → 地址栏自动变为 https://...，且参数完整保留

不推荐的写法（容易踩坑）

以下方式存在明显缺陷，应避免：

if ($scheme = http) { return 301 ... }：放在 location 内可能失效，且 if 在 server 上下文中性能较差、逻辑易混乱
error_page 497 ...：依赖错误触发，属于“兜底方案”，非主动拦截，用户体验差
meta refresh 或 JS 跳转：客户端跳转，延迟高、不安全、SEO 不友好、参数可能被截断
只用 $uri 不拼 $args：会导致 ? 后面的查询参数丢失（如 ?id=123 消失）