Nginx 中 location 不能直接映射多端口，端口由 server 块监听决定，路径分发靠 location + proxy_pass 协同实现；推荐单 server 多 location 按路径代理至不同后端端口。
在 Nginx 中，location 本身不能直接映射“多端口”——因为 location 是基于请求的 URI 路径（即 URL 中 /xxx 那部分）进行匹配的，而端口属于连接层信息，由 server 块监听决定。真正实现“多端口统一映射到主域名不同目录”的核心方式是：多个 server 块监听不同端口，各自用 proxy_pass 将请求转发到同一后端服务的不同路径（或不同后端），再通过主域名的 location 规则做统一入口和路径重写。
明确架构逻辑：端口分离 + 主域名统一路由
典型场景如：
- 访问
http://example.com:8080→ 映射为/admin/... - 访问
http://example.com:8081→ 映射为/api/... - 访问
http://example.com（默认 80 端口）→ 主站/
但浏览器直接访问带端口的 URL 时，不会自动改写路径。所以更合理、更常用的实践是：所有端口都反向代理到同一个主域名下，靠路径区分服务，而非依赖用户访问带端口的地址。也就是说：用户只访问 https://example.com，Nginx 内部根据 location 分发到不同后端（可能运行在不同端口上）。
推荐方案：单 server + 多 location 按路径分发（后端服务运行在不同端口）
假设你有三个本地服务：
- 前端静态站：运行在
localhost:3000（对应/） - 管理后台：运行在
localhost:8001（希望暴露为/admin/） - API 接口：运行在
localhost:8002（希望暴露为/api/）
配置示例如下：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># 主站（根路径）
location / {
proxy_pass http://localhost:3000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# 管理后台（路径前缀 /admin/）
location /admin/ {
proxy_pass http://localhost:8001/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# API 接口（路径前缀 /api/）
location /api/ {
proxy_pass http://localhost:8002/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}}
⚠️ 注意：proxy_pass 末尾的 / 很关键——它会剥离匹配的 location 前缀。例如请求 /admin/user 会被转发为 http://localhost:8001/user（不是 /admin/user）。
如果真要“对外暴露多个端口并映射到不同目录”，需配合 rewrite 或内部跳转
极少数情况需要保留端口访问入口（如测试环境），可这样设计：
server {
listen 8080;
server_name example.com;
<pre class="brush:php;toolbar:false;">location / {
rewrite ^/(.*)$ /admin/$1 break;
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
}}
server { listen 8081; server_name example.com;
location / {
rewrite ^/(.*)$ /api/$1 break;
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
}}
主 server 仍负责实际路径路由
server { listen 80; server_name example.com;
location /admin/ {
proxy_pass http://localhost:8001/;
}
location /api/ {
proxy_pass http://localhost:8002/;
}
location / {
proxy_pass http://localhost:3000/;
}}
这样访问 example.com:8080/user 会先被 rewrite 成 /admin/user，再由主 server 的 location /admin/ 规则处理。但该方式增加复杂度，且需确保 DNS 或 Hosts 允许同域名多端口访问（浏览器策略一般允许）。
关键细节与避坑提示
- 端口监听权限：Linux 下非 root 用户无法监听 1024 以下端口（如 80、443），开发建议用 8000+；生产应配 HTTPS 并用 443/80，端口映射交给负载层
-
location 匹配优先级：精确匹配
= /xxx> 长前缀匹配^~ /xxx> 正则匹配~> 普通前缀匹配。路径嵌套需注意顺序 -
避免路径重复代理：比如
location /api/和location /api/v1/同时存在，后者必须写在前面，否则被前者吞掉 -
CORS 与 Cookie：跨路径代理后，若后端校验
Origin或设置Path=/的 Cookie，需在proxy_cookie_path或响应头中调整
不复杂但容易忽略。核心始终是：端口由 server { listen ... } 控制，路径分发靠 location + proxy_pass，二者协同才能干净解耦。
