Nginx虚拟主机重写规则须置于对应server或location块内,仅作用于该站点;常用rewrite和if实现跳转、路径替换等,但if有嵌套与安全性限制,推荐优先使用return或rewrite redirect;配置后需nginx -t验证并curl测试响应码。

在 Nginx 中配置 Virtual Host(虚拟主机)时加入重写规则,核心是把 rewrite 指令或 if 判断放在对应的 server 块或其内部的 location 块中。重写规则只对匹配该虚拟主机的请求生效,不会影响其他站点。
重写规则应放在 server 块内
每个 server 块代表一个独立的虚拟主机,所有与该域名/端口/IP 相关的重写逻辑都应定义在其中。例如:
- 若要将
http://old.example.com全站跳转到https://new.example.com,就在old.example.com对应的server块里写重定向规则; - 若只对某个路径(如
/blog/old-post)做跳转,可放在location /blog/内,更精准且避免全局匹配开销。
常用重写方式及写法示例
基于不同需求,选择合适语法:
-
简单路径替换:用
rewrite+ 正则捕获 +last或redirectrewrite ^/old/(.*)$ /new/$1 permanent;→ 301 跳转rewrite ^/temp/(.*)$ /$1 break;→ 内部重写,不改变浏览器地址栏 -
条件跳转(如仅 HTTP 跳 HTTPS):配合
if判断$schemeif ($scheme = "http") { return 301 https://$host$request_uri; } -
根据 Host 头或参数跳转:
if ($host ~* "^www\.(.+)$") { set $domain $1; rewrite ^(.*)$ https://$domain$1 permanent; }
注意 if 指令的限制和替代方案
if 在 server 或 location 中可用,但有明确限制:
- 不能嵌套使用;
- 不建议在
location中对 URI 做复杂判断(易引发循环或意外匹配); - 多数场景推荐用
return或rewrite ... redirect替代冗长if块,更安全高效。
验证与调试要点
配置完成后务必检查并测试:
- 运行
nginx -t确保语法无误; - 用
curl -I查看响应状态码是否符合预期(如 301/302); - 留意日志中的
rewrite记录(需开启rewrite_log on;并设日志级别为 notice 或 debug); - 避免重写规则冲突——多个
rewrite连续触发时,last会终止当前块查找,break会停止后续重写,redirect和permanent直接返回响应。


















