基于请求路径环境变量实现HAProxy动态端口路由需求

要实现你描述的动态路由需求，我们需要结合HAProxy的环境变量映射、路径重写和动态变量匹配功能，以下是完整的配置方案，我会一步步拆解说明：

1. 核心配置思路 #

我们需要完成三个核心动作：

• 移除请求路径中的/api前缀
• 从路径中提取服务标识（如a、b）
• 根据服务标识匹配对应的环境变量（支持直接匹配或prefix_前缀的变量），转发到对应的端口

2. 完整配置示例 #

global
    # 确保HAProxy可以读取进程环境变量（默认已开启，显式声明更清晰）
    env *

defaults
    mode http
    timeout connect 5s
    timeout client 50s
    timeout server 50s

# 定义环境变量映射：直接服务名 -> 端口（比如环境变量a=9873会生成映射a→9873）
map_from_env /var/run/haproxy/service_ports map -
# 定义带prefix_前缀的环境变量映射：服务名（去掉prefix_）-> 端口（比如prefix_b=9874会生成映射b→9874）
map_from_env /var/run/haproxy/prefix_service_ports map prefix_

frontend api_frontend
    bind *:80
    # 匹配所有/api开头的请求
    acl api_request path_beg /api
    # 移除/api前缀，完整保留后续路径（例：/api/a/action → /a/action）
    reqrep ^([^\ ]*\ /)api(/.*) \1\2 if api_request
    # 从重写后的路径中提取第一个服务标识（例：/a/action → a）
    set-variable req.service path,regsub(^/([^/]+).*$,\1) if api_request
    # 查找对应端口：优先匹配直接服务名的环境变量，找不到则尝试带prefix_前缀的变量
    set-variable req.port map(req.service,/var/run/haproxy/service_ports,/var/run/haproxy/prefix_service_ports) if api_request
    # 验证是否找到有效端口
    acl port_found var(req.port) -m found
    # 将请求转发到动态后端
    use_backend api_backend if api_request port_found

backend api_backend
    # 动态指定目标服务器：localhost+匹配到的端口，保留重写后的完整路径
    server dynamic localhost:%[var(req.port)]

3. 配置细节解释 #

• 环境变量映射：
  • map_from_env指令会自动将环境变量转化为HAProxy可识别的映射关系，无需手动维护映射文件；
  • 两个映射分别处理直接匹配和带prefix_前缀的场景，确保灵活性。
• 路径重写：精准的正则匹配避免误处理其他包含api字符串的路径，保证后续路径完整保留。
• 服务标识提取：通过正则表达式regsub(^/([^/]+).*$,\1)快速提取路径中的第一个服务标识，逻辑简洁高效。
• 动态端口匹配：map()函数会依次查询两个映射，优先使用直接匹配的环境变量，满足你对两种变量格式的需求。
• 动态服务器：%[var(req.port)]是HAProxy的变量引用语法，会自动替换为匹配到的端口值，实现动态路由。

4. 使用说明 #

1. 确保你的HAProxy版本在2.0及以上（set-variable和map_from_env是2.0版本引入的功能）；
2. 启动HAProxy前，设置好对应的环境变量，比如：

   export a=9873
   export prefix_b=9874
   export c=9875
   haproxy -f haproxy.cfg
   

3. 测试请求：
   • 发送GET /api/a/action会被转发到localhost:9873/a/action；
   • 发送GET /api/b/action会被转发到localhost:9874/b/action（匹配prefix_b=9874）；
   • 发送GET /api/c/action会被转发到localhost:9875/c/action。

5. 容错处理（可选） #

如果需要处理找不到对应端口的情况，可以添加默认后端：

frontend api_frontend
    # ... 原有配置 ...
    # 未找到端口时转发到默认后端
    use_backend default_backend if api_request !port_found

backend default_backend
    server default localhost:9871
    # 返回自定义404错误
    http-request return status 404 content-type text/plain "Service not found"

内容的提问来源于stack exchange，提问作者S. Jacob Powell