1. Nginx Rewrite 基础概念解析Rewrite 是 Nginx 服务器中一个极其重要的功能模块它允许我们在不改变客户端请求的情况下在服务器端修改请求的 URI。这个功能在以下场景中特别有用URL 重定向301/302动态 URL 伪装成静态 URL域名切换时的流量迁移多条件路由转发rewrite 指令的基本语法格式为rewrite regex replacement [flag];其中regex用于匹配 URI 的正则表达式replacement匹配成功后用于替换的字符串flag标志位用于控制重写行为2. Rewrite 指令详解2.1 正则表达式匹配规则Nginx 使用的正则表达式与 Perl 兼容PCRE以下是一些常用匹配模式^匹配字符串开头 $匹配字符串结尾 .匹配任意单个字符 *匹配前一个字符0次或多次 匹配前一个字符1次或多次 ?匹配前一个字符0次或1次 \d匹配数字 \w匹配字母、数字或下划线 {n}精确匹配n次 {n,}匹配至少n次 {n,m}匹配n到m次2.2 常用 Flag 标志位Nginx rewrite 支持以下几种 flaglast停止处理当前 rewrite 指令集并用修改后的 URI 重新匹配 locationbreak停止处理当前 rewrite 指令集redirect返回302临时重定向permanent返回301永久重定向重要提示last 和 break 的区别在于是否会重新发起 location 匹配这在复杂配置中需要特别注意。3. 实战应用场景3.1 基础重定向示例将旧URL重定向到新URLrewrite ^/old-page.html$ /new-page.html permanent;动态URL伪静态化rewrite ^/product/(\d).html$ /product.php?id$1 last;3.2 多条件重写规则复杂业务场景下的多条件判断location / { if ($http_user_agent ~* mobile) { rewrite ^(.*)$ /mobile/$1 break; } if ($request_method POST) { rewrite ^/api/(.*)$ /backend/$1 last; } }3.3 域名重定向配置全站HTTPS重定向server { listen 80; server_name example.com; return 301 https://$host$request_uri; }多域名统一规范server { listen 80; server_name www.example.com; rewrite ^(.*)$ https://example.com$1 permanent; }4. 高级技巧与性能优化4.1 重写规则优化建议将最常匹配的规则放在前面避免过于复杂的正则表达式尽量使用 break 而非 last 减少匹配次数对静态资源使用 break 直接终止匹配4.2 常见问题排查重写循环问题rewrite ^/(.*)$ /$1 last; # 错误的循环示例变量使用不当rewrite ^/path$ /new-path?param$arg_param; # 保留原始参数特殊字符转义rewrite ^/search/([^/])/?$ /search.php?q$1 last;5. 实际案例解析5.1 电商网站URL优化商品详情页重写rewrite ^/product-([0-9])-([a-z])\.html$ /product.php?id$1name$2 last;分类页分页处理rewrite ^/category/([^/])/page/([0-9])$ /category.php?name$1page$2 last;5.2 API版本控制RESTful API版本管理location /api { rewrite ^/api/v1/(.*)$ /api_v1/$1 last; rewrite ^/api/v2/(.*)$ /api_v2/$1 last; }5.3 多语言站点路由语言前缀处理rewrite ^/(en|fr|de)/(.*)$ /$2?lang$1 last;6. 性能监控与调试6.1 日志记录配置调试rewrite规则时可以开启rewrite日志server { rewrite_log on; error_log /var/log/nginx/rewrite.log notice; }6.2 变量查看技巧在配置中输出调试信息location /debug { add_header X-Debug-URI $uri; add_header X-Debug-Args $args; return 200 Debug Info; }7. 安全注意事项避免开放重定向漏洞# 不安全的写法 rewrite ^/redirect/(.*)$ $1 permanent; # 安全的写法 rewrite ^/redirect/(https?://example\.com/.*)$ $1 permanent;限制重写范围location /safe-area { rewrite ^/safe-area/(.*)$ /$1 last; }敏感路径保护location ~* \.(php|asp|jsp)$ { deny all; }8. 最佳实践总结经过多年Nginx配置经验我总结了以下rewrite最佳实践保持规则简洁明了适当添加注释复杂规则先在小范围测试使用return替代rewrite进行简单重定向定期审查rewrite规则移除不再使用的部分重要变更先在测试环境验证对于高频访问的路径建议使用map指令进行优化map $uri $new_uri { include /etc/nginx/rewrite-maps/*.conf; } server { rewrite ^ $new_uri last; }最后分享一个实用技巧在修改rewrite规则后可以使用nginx -t测试配置语法然后通过nginx -s reload平滑重启这样可以避免服务中断。
1. Nginx Rewrite 基础概念解析Rewrite 是 Nginx 服务器中一个极其重要的功能模块它允许我们在不改变客户端请求的情况下在服务器端修改请求的 URI。这个功能在以下场景中特别有用URL 重定向301/302动态 URL 伪装成静态 URL域名切换时的流量迁移多条件路由转发rewrite 指令的基本语法格式为rewrite regex replacement [flag];其中regex用于匹配 URI 的正则表达式replacement匹配成功后用于替换的字符串flag标志位用于控制重写行为2. Rewrite 指令详解2.1 正则表达式匹配规则Nginx 使用的正则表达式与 Perl 兼容PCRE以下是一些常用匹配模式^匹配字符串开头 $匹配字符串结尾 .匹配任意单个字符 *匹配前一个字符0次或多次 匹配前一个字符1次或多次 ?匹配前一个字符0次或1次 \d匹配数字 \w匹配字母、数字或下划线 {n}精确匹配n次 {n,}匹配至少n次 {n,m}匹配n到m次2.2 常用 Flag 标志位Nginx rewrite 支持以下几种 flaglast停止处理当前 rewrite 指令集并用修改后的 URI 重新匹配 locationbreak停止处理当前 rewrite 指令集redirect返回302临时重定向permanent返回301永久重定向重要提示last 和 break 的区别在于是否会重新发起 location 匹配这在复杂配置中需要特别注意。3. 实战应用场景3.1 基础重定向示例将旧URL重定向到新URLrewrite ^/old-page.html$ /new-page.html permanent;动态URL伪静态化rewrite ^/product/(\d).html$ /product.php?id$1 last;3.2 多条件重写规则复杂业务场景下的多条件判断location / { if ($http_user_agent ~* mobile) { rewrite ^(.*)$ /mobile/$1 break; } if ($request_method POST) { rewrite ^/api/(.*)$ /backend/$1 last; } }3.3 域名重定向配置全站HTTPS重定向server { listen 80; server_name example.com; return 301 https://$host$request_uri; }多域名统一规范server { listen 80; server_name www.example.com; rewrite ^(.*)$ https://example.com$1 permanent; }4. 高级技巧与性能优化4.1 重写规则优化建议将最常匹配的规则放在前面避免过于复杂的正则表达式尽量使用 break 而非 last 减少匹配次数对静态资源使用 break 直接终止匹配4.2 常见问题排查重写循环问题rewrite ^/(.*)$ /$1 last; # 错误的循环示例变量使用不当rewrite ^/path$ /new-path?param$arg_param; # 保留原始参数特殊字符转义rewrite ^/search/([^/])/?$ /search.php?q$1 last;5. 实际案例解析5.1 电商网站URL优化商品详情页重写rewrite ^/product-([0-9])-([a-z])\.html$ /product.php?id$1name$2 last;分类页分页处理rewrite ^/category/([^/])/page/([0-9])$ /category.php?name$1page$2 last;5.2 API版本控制RESTful API版本管理location /api { rewrite ^/api/v1/(.*)$ /api_v1/$1 last; rewrite ^/api/v2/(.*)$ /api_v2/$1 last; }5.3 多语言站点路由语言前缀处理rewrite ^/(en|fr|de)/(.*)$ /$2?lang$1 last;6. 性能监控与调试6.1 日志记录配置调试rewrite规则时可以开启rewrite日志server { rewrite_log on; error_log /var/log/nginx/rewrite.log notice; }6.2 变量查看技巧在配置中输出调试信息location /debug { add_header X-Debug-URI $uri; add_header X-Debug-Args $args; return 200 Debug Info; }7. 安全注意事项避免开放重定向漏洞# 不安全的写法 rewrite ^/redirect/(.*)$ $1 permanent; # 安全的写法 rewrite ^/redirect/(https?://example\.com/.*)$ $1 permanent;限制重写范围location /safe-area { rewrite ^/safe-area/(.*)$ /$1 last; }敏感路径保护location ~* \.(php|asp|jsp)$ { deny all; }8. 最佳实践总结经过多年Nginx配置经验我总结了以下rewrite最佳实践保持规则简洁明了适当添加注释复杂规则先在小范围测试使用return替代rewrite进行简单重定向定期审查rewrite规则移除不再使用的部分重要变更先在测试环境验证对于高频访问的路径建议使用map指令进行优化map $uri $new_uri { include /etc/nginx/rewrite-maps/*.conf; } server { rewrite ^ $new_uri last; }最后分享一个实用技巧在修改rewrite规则后可以使用nginx -t测试配置语法然后通过nginx -s reload平滑重启这样可以避免服务中断。
