Nginx配置：从URI捕获端口并实现反向代理转发

问题场景 #

单个端口转发的手动配置可正常运行，示例如下：

location /port {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_pass http://localhost:5001;
}

但需转发5001-5228端口范围时，手动创建大量location块过于繁琐。尝试用正则捕获URI中的端口号简化配置：

location ~^/port/(.*)$ {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_pass http://localhost:$1;
    add_header X-debug-message "input: $1" always;
    add_header X-debug-message-2 "request_uri: $request_uri" always;
    add_header X-uri "uri: $uri" always;
}

此时响应头可正确捕获端口（如X-Debug-Message: input: 5002），但Nginx日志报错：

error 4512#4512: *1 no resolver defined to resolve localhost

配置resolver 0.0.0.0或127.0.0.1后，仍出现解析超时：

*1 localhost could not be resolved (110: Operation timed out)

又尝试添加rewrite和set $upstream优化：

location ~^/port/(.*)$ {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    rewrite /port/(.*) $1 break;
    set $upstream http://localhost:$1;
    proxy_pass $upstream;
    add_header X-debug-message "input: $1" always;
    add_header X-debug-message-2 "request_uri: $request_uri" always;
    add_header X-uri "uri: $uri" always;
}

响应头显示uri: 5002，但日志仍报错：

error 4638#4638: *5 invalid URL prefix in ""

正确配置方案 #

直接使用127.0.0.1替代localhost，同时通过正则限制端口范围避免非法请求，最终配置如下：

location ~^/port/(50[0-9][0-9]|51[0-9][0-9]|52[0-2][0-8])$ {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $http_host;
    proxy_pass http://127.0.0.1:$1;
    # 可选：保留调试头用于验证
    add_header X-debug-message "forward to port: $1" always;
}

配置说明 #

1. 用127.0.0.1替代localhost：Nginx在proxy_pass目标包含变量时，会强制触发DNS解析，哪怕是localhost也会走DNS查询流程。直接使用127.0.0.1（IP地址）无需DNS解析，彻底绕过resolver相关问题。
2. 正则精准限制端口范围：50[0-9][0-9]|51[0-9][0-9]|52[0-2][0-8]严格匹配5001-5228区间的端口，防止非法端口号被捕获导致无效转发。
3. 无需额外rewrite操作：正则捕获的$1直接作为目标端口，不需要修改请求URI，保持转发逻辑简洁。

若必须使用localhost，可在http块中配置可靠的resolver：

http {
    resolver 127.0.0.1 valid=300s;
    resolver_timeout 5s;
    # 其他HTTP配置...
}

但优先推荐IP地址方案，更简单高效，避免DNS解析带来的潜在问题。

内容的提问来源于stack exchange，提问作者adsanvar