1. Nginx Rewrite基础概念解析Rewrite是Nginx服务器中一个强大的URL重写模块它允许我们在请求到达后端应用前对URI进行修改和重定向。这个功能在日常运维和开发中扮演着关键角色特别是在以下场景保持旧URL兼容性同时进行站点结构更新实现SEO友好的URL规范化处理复杂的路由逻辑实现A/B测试分流Rewrite的核心原理是通过正则表达式匹配请求URI然后根据规则将其转换为新的URI。这个转换过程发生在Nginx的rewrite阶段早于其他处理阶段如代理、缓存等。重要提示rewrite规则会改变原始请求的URI但不会修改查询字符串即?后面的参数除非显式地进行处理。2. Rewrite指令详解2.1 基本语法结构Nginx的rewrite指令遵循以下标准格式rewrite regex replacement [flag];regex用于匹配URI的正则表达式replacement替换后的目标URIflag可选标志位控制重写行为2.2 常用flag参数Flag作用典型应用场景last停止处理当前rewrite规则集用新URI重新匹配location复杂的多级重写规则break停止处理当前rewrite规则集但不再重新匹配location最终重定向规则redirect返回302临时重定向临时URL跳转permanent返回301永久重定向永久URL迁移2.3 正则表达式技巧Nginx使用PCRE正则引擎支持以下常用匹配模式^匹配字符串开始$匹配字符串结束.*匹配任意字符贪婪模式[^/]匹配非斜杠字符\d匹配数字()创建捕获组可在replacement中用$1-$9引用3. 实战配置案例3.1 基础URL重写# 将/product/123重写为/product.php?id123 rewrite ^/product/(\d)$ /product.php?id$1 break;这个规则会匹配以/product/开头后接数字的URL将数字部分捕获为$1重写到product.php并传递id参数3.2 多条件组合规则# 同时处理带/和不带/的URL location /blog { rewrite ^/blog/([^/])/?$ /blog.php?slug$1 last; rewrite ^/blog/([^/])/(\d)/?$ /blog.php?slug$1page$2 last; }3.3 域名重定向# 将旧域名重定向到新域名 server { listen 80; server_name old-domain.com; return 301 https://new-domain.com$request_uri; }4. 高级应用场景4.1 动态路由实现# 实现类似框架的路由功能 location / { try_files $uri $uri/ rewrite; } location rewrite { rewrite ^/(.*)$ /index.php?route$1 last; }4.2 多环境配置# 根据不同环境重写URL set $env prod; if ($http_x_env) { set $env $http_x_env; } location / { rewrite ^/api/(.*)$ /api-$env/$1 break; proxy_pass http://backend; }4.3 前后端分离路由# 处理前端路由的HTML5 history模式 location / { try_files $uri $uri/ /index.html; }5. 性能优化与调试5.1 重写规则优化原则精确匹配优先将最具体的规则放在前面减少正则复杂度避免使用过于复杂的正则表达式合理使用flag理解last/break的区别避免重复匹配设置适当的终止条件5.2 调试技巧# 启用rewrite日志 rewrite_log on; error_log /var/log/nginx/rewrite.log notice;调试时可以添加临时规则rewrite ^/test/(.*)$ /debug.php?original$1;5.3 常见性能陷阱过度使用ifNginx中的if指令有特殊行为可能导致意外结果捕获组滥用不必要的捕获会增加CPU开销无限重定向循环规则设计不当会导致301循环6. 安全注意事项6.1 防止开放重定向漏洞错误的配置可能导致开放重定向# 不安全的写法容易被利用 rewrite ^/redirect/(.*)$ $1 permanent;安全做法# 安全的写法 rewrite ^/redirect/(https?://[^/]\.example\.com/.*)$ $1 permanent;6.2 敏感路径保护# 阻止对配置文件的直接访问 location ~* \.(ini|conf|env)$ { deny all; }6.3 请求限制# 限制/admin路径的访问 location /admin { allow 192.168.1.0/24; deny all; rewrite ^/admin/(.*)$ /admin.php?page$1 break; }7. 与其他模块的协作7.1 与try_files配合location / { try_files $uri rewrite; } location rewrite { rewrite ^/(.*)$ /index.php?q$1 last; }7.2 与proxy_pass结合location /api { rewrite ^/api/(.*)$ /$1 break; proxy_pass http://api_backend; }7.3 与map指令组合map $uri $new_uri { ~^/old/(.*) /new/$1; } server { ... rewrite ^ $new_uri permanent; }8. 实际案例解析8.1 电商网站URL优化# 产品页URL美化 rewrite ^/product/([a-z0-9-])-(\d)\.html$ /product.php?id$2slug$1 break; # 分类页分页处理 rewrite ^/category/([a-z])/page/(\d)$ /category.php?name$1page$2 break;8.2 多语言站点处理# 根据语言前缀路由 rewrite ^/(en|fr|de)/(.*)$ /$2?lang$1 break;8.3 移动端适配# 移动设备重定向 map $http_user_agent $mobile_rewrite { default 0; ~*(android|iphone|ipod) 1; } server { ... if ($mobile_rewrite) { rewrite ^(.*)$ /mobile$1 break; } }9. 常见问题排查9.1 重写规则不生效检查步骤确认配置文件已重载nginx -s reload检查错误日志tail -f /var/log/nginx/error.log使用curl测试curl -v http://example.com/test9.2 出现重定向循环典型症状浏览器显示重定向次数过多网络面板显示连续的301/302解决方案检查规则中是否有自引用确保有终止条件使用break代替last尝试9.3 特殊字符处理问题对于包含特殊字符的URL# 处理含中文的URL rewrite ^/search/(.*)$ /search.php?q$1? break;10. 最佳实践总结经过多年Nginx运维经验我总结了以下rewrite最佳实践保持规则简洁每个规则只处理一个明确的任务充分测试在生产环境部署前进行完整测试添加注释说明每条规则的用途和业务场景性能监控关注rewrite对QPS的影响版本控制所有rewrite规则纳入配置管理系统一个典型的良好实践示例# 将旧博客URL迁移到新系统 (2023-07更新) rewrite ^/blog/(\d{4})/(\d{2})/(\d{2})/(.*)$ /posts/$1-$2-$3-$4 permanent; # API版本控制 rewrite ^/api/v1/(.*)$ /api/internal/$1?version1.0 break; # 静态资源缓存优化 rewrite ^/static/(.*)\.v\d\.(css|js)$ /static/$1.$2 break;最后需要强调的是rewrite规则虽然强大但应该作为URL处理的最后手段。在可能的情况下优先考虑调整应用本身的路由逻辑保持Nginx配置的简洁性和可维护性。
Nginx Rewrite模块详解：从基础到高级应用
1. Nginx Rewrite基础概念解析Rewrite是Nginx服务器中一个强大的URL重写模块它允许我们在请求到达后端应用前对URI进行修改和重定向。这个功能在日常运维和开发中扮演着关键角色特别是在以下场景保持旧URL兼容性同时进行站点结构更新实现SEO友好的URL规范化处理复杂的路由逻辑实现A/B测试分流Rewrite的核心原理是通过正则表达式匹配请求URI然后根据规则将其转换为新的URI。这个转换过程发生在Nginx的rewrite阶段早于其他处理阶段如代理、缓存等。重要提示rewrite规则会改变原始请求的URI但不会修改查询字符串即?后面的参数除非显式地进行处理。2. Rewrite指令详解2.1 基本语法结构Nginx的rewrite指令遵循以下标准格式rewrite regex replacement [flag];regex用于匹配URI的正则表达式replacement替换后的目标URIflag可选标志位控制重写行为2.2 常用flag参数Flag作用典型应用场景last停止处理当前rewrite规则集用新URI重新匹配location复杂的多级重写规则break停止处理当前rewrite规则集但不再重新匹配location最终重定向规则redirect返回302临时重定向临时URL跳转permanent返回301永久重定向永久URL迁移2.3 正则表达式技巧Nginx使用PCRE正则引擎支持以下常用匹配模式^匹配字符串开始$匹配字符串结束.*匹配任意字符贪婪模式[^/]匹配非斜杠字符\d匹配数字()创建捕获组可在replacement中用$1-$9引用3. 实战配置案例3.1 基础URL重写# 将/product/123重写为/product.php?id123 rewrite ^/product/(\d)$ /product.php?id$1 break;这个规则会匹配以/product/开头后接数字的URL将数字部分捕获为$1重写到product.php并传递id参数3.2 多条件组合规则# 同时处理带/和不带/的URL location /blog { rewrite ^/blog/([^/])/?$ /blog.php?slug$1 last; rewrite ^/blog/([^/])/(\d)/?$ /blog.php?slug$1page$2 last; }3.3 域名重定向# 将旧域名重定向到新域名 server { listen 80; server_name old-domain.com; return 301 https://new-domain.com$request_uri; }4. 高级应用场景4.1 动态路由实现# 实现类似框架的路由功能 location / { try_files $uri $uri/ rewrite; } location rewrite { rewrite ^/(.*)$ /index.php?route$1 last; }4.2 多环境配置# 根据不同环境重写URL set $env prod; if ($http_x_env) { set $env $http_x_env; } location / { rewrite ^/api/(.*)$ /api-$env/$1 break; proxy_pass http://backend; }4.3 前后端分离路由# 处理前端路由的HTML5 history模式 location / { try_files $uri $uri/ /index.html; }5. 性能优化与调试5.1 重写规则优化原则精确匹配优先将最具体的规则放在前面减少正则复杂度避免使用过于复杂的正则表达式合理使用flag理解last/break的区别避免重复匹配设置适当的终止条件5.2 调试技巧# 启用rewrite日志 rewrite_log on; error_log /var/log/nginx/rewrite.log notice;调试时可以添加临时规则rewrite ^/test/(.*)$ /debug.php?original$1;5.3 常见性能陷阱过度使用ifNginx中的if指令有特殊行为可能导致意外结果捕获组滥用不必要的捕获会增加CPU开销无限重定向循环规则设计不当会导致301循环6. 安全注意事项6.1 防止开放重定向漏洞错误的配置可能导致开放重定向# 不安全的写法容易被利用 rewrite ^/redirect/(.*)$ $1 permanent;安全做法# 安全的写法 rewrite ^/redirect/(https?://[^/]\.example\.com/.*)$ $1 permanent;6.2 敏感路径保护# 阻止对配置文件的直接访问 location ~* \.(ini|conf|env)$ { deny all; }6.3 请求限制# 限制/admin路径的访问 location /admin { allow 192.168.1.0/24; deny all; rewrite ^/admin/(.*)$ /admin.php?page$1 break; }7. 与其他模块的协作7.1 与try_files配合location / { try_files $uri rewrite; } location rewrite { rewrite ^/(.*)$ /index.php?q$1 last; }7.2 与proxy_pass结合location /api { rewrite ^/api/(.*)$ /$1 break; proxy_pass http://api_backend; }7.3 与map指令组合map $uri $new_uri { ~^/old/(.*) /new/$1; } server { ... rewrite ^ $new_uri permanent; }8. 实际案例解析8.1 电商网站URL优化# 产品页URL美化 rewrite ^/product/([a-z0-9-])-(\d)\.html$ /product.php?id$2slug$1 break; # 分类页分页处理 rewrite ^/category/([a-z])/page/(\d)$ /category.php?name$1page$2 break;8.2 多语言站点处理# 根据语言前缀路由 rewrite ^/(en|fr|de)/(.*)$ /$2?lang$1 break;8.3 移动端适配# 移动设备重定向 map $http_user_agent $mobile_rewrite { default 0; ~*(android|iphone|ipod) 1; } server { ... if ($mobile_rewrite) { rewrite ^(.*)$ /mobile$1 break; } }9. 常见问题排查9.1 重写规则不生效检查步骤确认配置文件已重载nginx -s reload检查错误日志tail -f /var/log/nginx/error.log使用curl测试curl -v http://example.com/test9.2 出现重定向循环典型症状浏览器显示重定向次数过多网络面板显示连续的301/302解决方案检查规则中是否有自引用确保有终止条件使用break代替last尝试9.3 特殊字符处理问题对于包含特殊字符的URL# 处理含中文的URL rewrite ^/search/(.*)$ /search.php?q$1? break;10. 最佳实践总结经过多年Nginx运维经验我总结了以下rewrite最佳实践保持规则简洁每个规则只处理一个明确的任务充分测试在生产环境部署前进行完整测试添加注释说明每条规则的用途和业务场景性能监控关注rewrite对QPS的影响版本控制所有rewrite规则纳入配置管理系统一个典型的良好实践示例# 将旧博客URL迁移到新系统 (2023-07更新) rewrite ^/blog/(\d{4})/(\d{2})/(\d{2})/(.*)$ /posts/$1-$2-$3-$4 permanent; # API版本控制 rewrite ^/api/v1/(.*)$ /api/internal/$1?version1.0 break; # 静态资源缓存优化 rewrite ^/static/(.*)\.v\d\.(css|js)$ /static/$1.$2 break;最后需要强调的是rewrite规则虽然强大但应该作为URL处理的最后手段。在可能的情况下优先考虑调整应用本身的路由逻辑保持Nginx配置的简洁性和可维护性。