Nginx反向代理与URL重写详解（从零开始掌握Nginx高级路由技巧）

为什么需要URL重写？

有时候，前端请求的URL路径和后端服务实际需要的路径不一致。例如，用户访问 /api/users，但后端服务只接受 /users。这时就需要用到URL重写功能，将请求路径“改写”后再转发给后端。

准备工作

确保你已经安装了Nginx。在Ubuntu/Debian系统中，可以使用以下命令安装：

sudo apt updatesudo apt install nginx  

基础反向代理配置

假设你的后端服务运行在 http://localhost:3000，你想通过访问 http://your-domain.com 来代理到这个服务。编辑Nginx配置文件（通常位于 /etc/nginx/sites-available/default 或新建一个站点配置）：

server {    listen 80;    server_name your-domain.com;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}  

保存后，测试配置并重载Nginx：

sudo nginx -tsudo systemctl reload nginx  

使用URL重写实现路径转换

现在我们来实现一个常见的场景：用户访问 /api/v1/users，但后端服务只接受 /users。我们需要去掉 /api/v1 前缀。

修改 location 块如下：

location /api/v1/ {    rewrite ^/api/v1/(.*)$ /$1 break;    proxy_pass http://localhost:3000/;    proxy_set_header Host $host;    proxy_set_header X-Real-IP $remote_addr;}  

解释一下关键点：

• rewrite ^/api/v1/(.*)$ /$1 break;：这是一个正则表达式重写规则。
  • ^/api/v1/(.*)$ 匹配以 /api/v1/ 开头的路径；
  • /$1 表示将匹配到的部分（即 (.*)）替换为 / 加上该部分；
  • break 表示重写后不再继续处理其他重写规则。
• proxy_pass 末尾加了 /，这很重要！它确保重写后的路径能正确拼接到后端地址后面。

常见问题与调试技巧

如果你发现重写没有生效，可以：

1. 检查Nginx错误日志：/var/log/nginx/error.log
2. 使用 curl -v http://your-domain.com/api/v1/test 查看请求是否被正确转发
3. 确认 proxy_pass 是否以 / 结尾（影响路径拼接）

总结

通过本教程，你应该已经掌握了如何使用Nginx进行反向代理和URL重写。这两个功能是构建高性能、可维护Web架构的基础。无论你是运维工程师还是开发者，理解这些概念都能帮助你更好地部署应用。

记住，Web服务器配置不仅仅是写几行代码，更是对整个请求流程的理解。多实践、多调试，你会越来越熟练！

关键词回顾：Nginx反向代理、URL重写、Nginx配置教程、Web服务器配置。