一、Nginx rewrite模块核心机制解析

Nginx的rewrite规则基于Perl兼容正则表达式（PCRE），通过ngx_http_rewrite_module模块实现URL路径与域名的动态重写。其核心指令包括rewrite、if、set等，其中rewrite指令的语法结构为：

rewrite regex replacement [flag];

regex：匹配请求URI的正则表达式
replacement：替换后的目标路径或域名
flag：控制重写行为的标志（如last/break/redirect/permanent）

域名跳转本质是通过修改HTTP响应头中的Location字段实现的，配合301/302状态码告知客户端跳转目标。例如将example.com跳转至new.example.com时，Nginx会在响应头添加：

HTTP/1.1 301 Moved Permanently
Location: https://new.example.com/original/path

二、典型域名跳转场景配置

1. 永久性域名迁移（301重定向）

当网站域名永久变更时，需配置301重定向以保持SEO权重：

server {
    listen 80;
    server_name old-domain.com;
    return 301 https://new-domain.com$request_uri;
}

或使用rewrite指令实现更复杂的路径保留：

server {
    listen 80;
    server_name old-domain.com;
    rewrite ^/(.*) https://new-domain.com/$1 permanent;
}

优化建议：

优先使用return 301指令，其处理效率比rewrite permanent高15%-20%

在HTTP到HTTPS的跳转中，可合并配置：

server {
    listen 80;
    server_name old-domain.com;
    return 301 https://new-domain.com$request_uri;
}

2. 临时性跳转（302重定向）

适用于A/B测试或临时维护场景：

server {
    listen 80;
    server_name temp-domain.com;
    rewrite ^/(.*) https://backup-domain.com/$1 redirect;
}

关键区别：

permanent对应301状态码（永久重定向）
redirect对应302状态码（临时重定向）
浏览器对301会缓存跳转关系，而302每次都会重新请求

3. 基于路径的动态跳转

当需要根据URL路径进行差异化跳转时，正则表达式发挥关键作用：

server {
    listen 80;
    server_name multi-domain.com;
    # 将/blog/开头的请求跳转到独立博客
    rewrite ^/blog/(.*) https://blog.example.com/$1 permanent;
    # 将/api/开头的请求跳转到微服务
    rewrite ^/api/(.*) https://api-gateway.example.com/$1 permanent;
}

正则技巧：

使用^锚点确保从路径开头匹配
括号()捕获分组内容，通过$1、$2引用
避免过度复杂的正则，建议每个server块处理不超过3个rewrite规则

三、进阶配置与性能优化

1. 条件判断跳转

结合if指令实现更复杂的逻辑：

server {
    listen 80;
    server_name smart-redirect.com;
    # 根据User-Agent跳转移动端
    if ($http_user_agent ~* "(Android|iPhone|iPad)") {
        rewrite ^/(.*) https://m.example.com/$1 permanent;
    }
    # 根据Cookie跳转测试环境
    if ($http_cookie ~* "env=test") {
        rewrite ^/(.*) https://test.example.com/$1 permanent;
    }
}

注意事项：

if指令在Nginx中存在性能损耗，建议将高频判断逻辑移至应用层
避免在if中使用正则匹配大文本（如整个请求体）

2. 变量与映射表

对于大规模域名跳转需求，可使用map指令建立映射关系：

http {
    map $host $redirect_target {
        default         "";
        old1.example.com new1.example.com;
        old2.example.com new2.example.com;
        ~^(?<sub>.+)\.old\.example\.com$ $sub.new.example.com;
    }
    server {
        listen 80;
        server_name ~^(.+)\.old\.example\.com$;
        if ($redirect_target) {
            return 301 https://$redirect_target$request_uri;
        }
    }
}

优势：

集中管理跳转规则，便于维护
支持动态子域名匹配
减少重复配置

3. HTTPS强制跳转

现代网站必须配置的HTTPS跳转方案：

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    # 其他配置...
}

安全建议：

使用HSTS头增强安全性：

add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

配置OCSP Stapling提升TLS性能

四、调试与问题排查

1. 常用调试工具

nginx -t：测试配置语法
```
nginx -t -c /etc/nginx/nginx.conf
```
curl -v：查看完整请求响应流程
```
curl -v http://old-domain.com/path
```
浏览器开发者工具：检查Network标签中的重定向链

2. 典型问题解决方案

问题1：跳转后丢失路径参数

原因：未正确使用$request_uri变量

修复：

rewrite ^ https://new-domain.com$request_uri? permanent;

问题2：无限重定向循环

原因：新旧域名配置相互引用
修复：确保跳转目标不会再次匹配当前server块的规则

问题3：正则匹配不生效

原因：未正确使用正则锚点或分组

修复：

# 错误示例：可能匹配到部分路径
rewrite /oldpath /newpath permanent;
# 正确示例：精确匹配
rewrite ^/oldpath(/.*)?$ /newpath$1 permanent;

五、最佳实践总结

简单优先：能用return解决的问题不用rewrite
最小化规则：每个server块尽量保持3条以内rewrite规则
集中管理：通过include指令拆分复杂配置
性能监控：定期检查nginx -T输出的完整配置

备份习惯：修改前备份配置文件

cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak-$(date +%Y%m%d)

通过系统掌握Nginx的rewrite机制与域名跳转技巧，开发者可以高效完成网站迁移、多域名管理等任务，同时确保SEO效果和用户体验不受影响。实际配置时建议先在测试环境验证，再逐步应用到生产环境。

Nginx之rewrite配置域名跳转：从基础到进阶的完整指南