脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网站技巧 → 服务器 → nginx → nginx动态端口映射

nginx动态端口映射的配置方法

 更新时间：2026年07月13日 09:26:41   作者：树若逝花若殇  
在Nginx中,动态端口映射通常指的是将Nginx配置为监听一个或多个端口,并根据请求的某些条件（如请求的URL、头部信息等）动态地选择后端服务,本文介绍nginx动态端口映射的配置方法,感兴趣的朋友一起看看吧

在Nginx中，动态端口映射通常指的是将Nginx配置为监听一个或多个端口，并根据请求的某些条件（如请求的URL、头部信息等）动态地选择后端服务。这种配置通常用于负载均衡、服务发现或根据不同条件将请求路由到不同的后端服务器。

前言

在实际的项目开发中，我们经常遇到这样一个场景：随着微服务架构的普及，后端服务被拆分成多个独立的业务模块（如用户服务、订单服务、商品服务等），每个模块都运行在不同的端口上。传统的做法是在 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 搞定所有服务」的动态端口映射方案。

实现方式

核心原理

动态端口映射的核心是 「正则捕获 + 变量映射」 两步走：

  1. 捕获服务名：通过正则表达式从请求路径中提取服务名（如 Teacher）
  2. 查表转发：根据服务名查表得到对应的端口号，然后拼接 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：剩余路径原样保留，不受层级限制

到此这篇关于nginx动态端口映射的配置方法的文章就介绍到这了,更多相关nginx动态端口映射内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • Nginx限流触发原因排查及前端优化方案

    Nginx限流触发原因排查及前端优化方案

    在日常项目开发中,为保障后端服务稳定性,通常会为接口配置Nginx限流策略,但实际应用中常出现一种情况：已实现前端并发控制,却仍频繁触发限流规则,本文结合近期项目实战,详细拆解Nginx限流日志、剖析触发根源,需要的朋友可以参考下
    2026-02-02
  • Nginx 代理转发阿里云OSS上传的实现代码

    Nginx 代理转发阿里云OSS上传的实现代码

    这篇文章主要介绍了Nginx 代理转发阿里云OSS上传的实现代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2018-09-09
  • Nginx 负载均衡实现上游服务健康检查功能

    Nginx 负载均衡实现上游服务健康检查功能

    这篇文章主要介绍了Nginx 负载均衡实现上游服务健康检查,演示如何通过 nginx_upstream_check_module 实现负载均衡上游服务器的故障转移,需要的朋友可以参考下
    2024-06-06
  • 在Debian上安装最新版Nginx实践

    在Debian上安装最新版Nginx实践

    文章介绍了Nginx安装的官方文档流程,涵盖先决条件、密钥验证、存储库设置、安装步骤及常用命令,如启动/停止/重启服务、检查配置、查看版本与日志等,帮助用户完成Nginx部署与管理
    2025-09-09
  • Nginx通过geo模块设置白名单的例子

    Nginx通过geo模块设置白名单的例子

    今天小编就为大家分享一篇Nginx通过geo模块设置白名单的例子，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2019-08-08
  • Nginx服务器中414错误和504错误的配置解决方法

    Nginx服务器中414错误和504错误的配置解决方法

    这篇文章主要介绍了Nginx服务器中414错误和504错误的配置解决方法,分别对应Request-URI Too Large和Gateway Time-out这样的错误提示,需要的朋友可以参考下
    2015-12-12
  • keepalived双机热备nginx的配置方法

    keepalived双机热备nginx的配置方法

    这篇文章主要介绍了keepalived双机热备nginx的配置方法,需要的朋友可以参考下
    2018-03-03
  • Nginx的流式响应配置小结

    Nginx的流式响应配置小结

    Nginx的流式响应功能是一项非常实用的特性,它允许Nginx在接收后端服务器响应的同时,逐步将内容发送给客户端,本文主要介绍了Nginx的流式响应配置,具有一定的参考价值,感兴趣的可以了解一下
    2025-04-04
  • Nginx启用GZIP压缩网页传输方法(推荐)

    Nginx启用GZIP压缩网页传输方法(推荐)

    Gzip压缩我很早已经就启用了，不过从未与大家分享过。今天小编给大家分享Nginx启用GZIP压缩网页传输方法，需要的朋友参考下吧
    2017-01-01
  • Nginx 禁用静态文件缓存的配置方法

    Nginx 禁用静态文件缓存的配置方法

    禁用缓存可能会导致性能下降,因为每次请求都需要从后端服务器获取文件,因此,你需要根据具体情况权衡利弊并做出决策,这篇文章给大家介绍Nginx 禁用静态文件缓存的方法,感兴趣的朋友一起看看吧
    2024-02-02

最新评论