目录前言实现方式核心原理配置步骤第1步定义服务名与端口的映射表第2步用正则捕获服务名并动态转发前言在实际的项目开发中我们经常遇到这样一个场景随着微服务架构的普及后端服务被拆分成多个独立的业务模块如用户服务、订单服务、商品服务等每个模块都运行在不同的端口上。传统的做法是在 Nginx 中为每个服务单独配置一个location进行转发但这样会导致配置文件越来越臃肿每新增一个服务就要复制粘贴一大段配置。比如当你需要代理/v1/aaa/**、/v1/bbb/**、/v1/ccc/**等多个服务路径到不同的后端端口时如果采用常规写法配置文件会变成如下location /v1/aaa/ { proxy_pass http://192.168.71.254:3001/v1/aaa/; } location /v1/bbb/ { proxy_pass http://192.168.71.254:3002/v1/bbb/; } location /v1/ccc/ { proxy_pass http://192.168.71.254:3003/v1/ccc/; }每加一个服务就要复制一份维护起来非常痛苦。那么有没有一种方式可以动态地根据请求路径中的服务名自动转发到对应的端口呢答案就是Nginx 动态端口映射。本文将介绍如何利用 Nginx 的正则捕获和map指令实现「一个location搞定所有服务」的动态端口映射方案。实现方式核心原理动态端口映射的核心是「正则捕获 变量映射」两步走捕获服务名通过正则表达式从请求路径中提取服务名如Teacher查表转发根据服务名查表得到对应的端口号然后拼接proxy_pass转发地址配置步骤第1步定义服务名与端口的映射表在http块中定义map作用是「根据服务名查端口」http { # 服务名 → 端口映射表 map $service $backend_port { default 3000; # 未匹配时的默认端口 aaa 3001; bbb 3002; ccc 3003; # 新增服务只需加一行 } }map就相当于一个字典输入aaa输出3001第2步用正则捕获服务名并动态转发server { listen 80; server_name localhost; # 动态转发规则 location ~ ^/v1/([^/])/(.*)$ { set $service $1; # 捕获服务名 → aaa set $remaining $2; # 捕获剩余路径 → abc/1/2 proxy_pass http://192.168.xxx.xxx:$backend_port/v1/$service/$remaining; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }关键点说明location ~ ^/v1/([^/])/(.*)$正则匹配/v1/xxx/...格式的路径$1和$2分别代表第一个和第二个括号捕获的内容由 Nginx 自动赋值$backend_port通过map根据$service动态查表得到的端口号$remaining剩余路径原样保留不受层级限制
