Nginx之rewrite配置域名跳转：实现高效URL重定向的完整指南

一、域名跳转的核心价值与Nginx实现优势

在互联网业务场景中，域名跳转（URL重定向）是解决网站迁移、多域名统一、SEO优化等问题的关键技术。相较于应用层代码实现，Nginx的rewrite模块通过底层网络层处理，具有以下显著优势：

1. 性能高效：Nginx以事件驱动模型处理请求，rewrite规则在连接建立阶段即完成判断，避免应用层解析开销
2. 灵活可控：支持正则表达式匹配、条件判断、变量操作等高级功能，可实现复杂业务逻辑
3. 集中管理：通过配置文件统一管理所有跳转规则，便于维护和审计
4. 协议透明：支持HTTP/HTTPS无缝跳转，可自动处理301/302状态码

典型应用场景包括：

• 网站改版时的永久性域名迁移（301重定向）
• 移动端适配（m.example.com → example.com/mobile）
• 区域化内容分发（cn.example.com → example.com/cn）
• 防域名劫持的备用域名跳转

二、rewrite模块基础语法解析

Nginx的rewrite规则由三部分组成：

rewrite [flag] regex replacement;

1. 正则表达式（regex）

使用PCRE语法，支持捕获组：

rewrite ^/old-path/(.*)$ /new-path/$1 last;

关键特性：

• ^ 和 $ 分别匹配行首行尾
• .* 匹配任意字符（除换行符）
• ( ) 定义捕获组，可通过$1、$2引用
• ? 使前面的字符变为可选

2. 替换字符串（replacement）

支持变量和反向引用：

set $backend "backend1";
rewrite ^/api/(.*)$ /$backend/$1;

常用内置变量：

• $host：请求主机名
• $request_uri：完整URI（含查询参数）
• $scheme：协议类型（http/https）
• $http_user_agent：用户代理信息

3. 标志位（flag）

三、域名跳转实战配置示例

场景1：HTTP到HTTPS的强制跳转

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

优化点：

• 使用$host保持原始域名
• $request_uri保留完整路径和参数
• 301状态码利于SEO权重传递

场景2：多域名统一跳转

server {
    listen 443 ssl;
    server_name old-domain.com www.old-domain.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    return 301 https://new-domain.com$request_uri;
}

注意事项：

• 确保新旧域名都配置了有效的SSL证书
• 测试时建议先用302临时跳转验证

场景3：带条件的路径跳转

server {
    listen 80;
    server_name example.com;
    location /download {
        if ($http_user_agent ~* "Mobile") {
            rewrite ^/download(.*)$ /mobile/download$1 permanent;
        }
        # 其他处理逻辑...
    }
}

警告：

• if指令在server块中使用需谨慎，可能引发意外行为
• 推荐使用map或多个location替代复杂条件判断

四、性能优化与调试技巧

1. 规则匹配顺序优化

Nginx按配置文件顺序匹配规则，遵循原则：

1. 精确匹配（=）优先
2. 前缀匹配（^~）次之
3. 正则匹配（~/~*）最后

建议将高频访问的跳转规则放在前面。

2. 避免循环跳转

典型错误示例：

rewrite ^/(.*)$ /new-$1 permanent;
rewrite ^/new-(.*)$ /$1 permanent;

检测方法：

curl -I http://example.com/test
# 观察是否出现多次301响应

3. 日志调试技巧

在nginx.conf中启用rewrite日志：

http {
    rewrite_log on;
    log_format rewrite_log '$remote_addr - $remote_user [$time_local] '
                          '"$request" $status $body_bytes_sent '
                          '"$http_referer" "$http_user_agent" '
                          '"$uri" "$args" -> "$new_uri"';
    access_log /var/log/nginx/rewrite.log rewrite_log;
}

五、安全注意事项

1. 正则表达式注入防护：

   # 错误示例：直接拼接用户输入
   rewrite ^/user/(.*)$ /profile?id=$1;
   # 正确做法：限制字符集
   rewrite ^/user/([a-zA-Z0-9]+)$ /profile?id=$1;

2. 开放重定向漏洞防范：

   # 危险示例：允许外部控制跳转目标
   if ($arg_url) {
       rewrite ^ /redirect?to=$arg_url;
   }
   # 安全方案：白名单验证
   map $arg_url $safe_url {
       default "";
       "~^https://trusted\.com" $arg_url;
   }

3. HTTPS混合内容警告：

   • 确保跳转后的资源也使用HTTPS
   • 使用HSTS头强制加密连接：

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

六、进阶应用场景

1. 基于地理位置的跳转

结合GeoIP模块：

geo $country {
    default us;
    CN cn;
    JP jp;
}
server {
    listen 80;
    server_name example.com;
    if ($country = cn) {
        rewrite ^(.*)$ https://cn.example.com$1 permanent;
    }
}

2. A/B测试分流

map $cookie_abtest $backend {
    default backend_a;
    "group_b" backend_b;
}
server {
    listen 80;
    location / {
        if ($cookie_abtest = "") {
            set $abgroup "group_${random_int % 2}";
            add_header Set-Cookie "abtest=$abgroup; Path=/";
            rewrite ^ / redirect;
        }
        proxy_pass http://$backend;
    }
}

七、常见问题解决方案

1. 跳转后丢失查询参数：

   # 错误示例
   rewrite ^/old /new permanent;
   # 正确写法
   rewrite ^/old(.*)$ /new$1 permanent;
   # 或使用$request_uri
   rewrite ^/old /new$is_args$args permanent;

2. 大小写敏感问题：

   # 匹配不区分大小写
   rewrite ~* ^/case-insensitive(.*)$ /new$1 permanent;

3. 正则表达式性能优化：

   • 避免使用.*匹配过长字符串
   • 优先使用^和$锚定
   • 复杂正则拆分为多个简单规则

八、最佳实践总结

1. 301与302的选择原则：

   • 永久变更使用301（SEO友好）
   • 临时变更使用302（便于回滚）
   • 测试环境始终使用302

2. 配置验证流程：

   nginx -t  # 语法检查
   nginx -s reload  # 平滑重载
   curl -vL http://example.com/path  # 跟踪跳转链

3. 监控指标：

   • 3xx状态码占比（应<5%）
   • 跳转处理耗时（应<10ms）
   • 失败跳转次数（可通过错误日志统计）

通过系统掌握Nginx的rewrite配置技巧，开发者可以高效实现各种复杂的域名跳转需求，同时确保系统的安全性和性能。建议在实际部署前，先在测试环境充分验证规则的正确性，并通过日志监控持续优化配置。