nginx反向代理是提升跨网段后端访问体验最稳定低延迟且无需改代码的方式，需部署于能通公网与内网的桥接节点，核心配置含路径转发、头透传、连接健壮性及跨域处理。
直接用 Nginx 做反向代理，是提升跨网段后端服务访问体验最稳定、低延迟且无需修改业务代码的方式。核心不是“绕过限制”，而是让请求路径统一、协议可控、网络路径可优化。
明确代理角色与网络定位
跨网段访问失败，常见原因是：客户端无法直连内网 IP（如 192.168.x.x）、DNS 解析异常、防火墙拦截或 IPv6 尝试失败。Nginx 应部署在能同时访问公网和目标内网的“桥接节点”上——比如云服务器、DMZ 区主机或具备双网卡的边界设备。
- 它不代替客户端发起请求，而是接收请求后，以自身身份主动连接后端（所以必须确保 Nginx 机器能 ping 通并 telnet 通目标端口）
- 避免把 Nginx 装在纯内网机器上再试图对外暴露——那只是把问题前移，未解决出口可达性
- 若后端在私有云或 VPC 内，需确认安全组/ACL 已放行 Nginx 服务器的源 IP
关键配置：精简可靠，避开常见坑
一份能落地的 server 块应聚焦三件事：路径转发、头信息透传、连接健壮性。不需要堆砌所有 proxy_* 指令。
-
基础转发：用
proxy_pass http://192.168.5.20:8080/;（注意末尾斜杠），确保路径拼接正确；若后端依赖原始 Host，加proxy_set_header Host $host; -
真实客户端识别：加
proxy_set_header X-Real-IP $remote_addr;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;，方便后端日志和限流 -
规避 IPv6 失败：在
http块开头加resolver 8.8.8.8 valid=30s ipv6=off;，禁用 IPv6 DNS 查询，防止 connect() failed (101: network is unreachable)
跨域场景下的一体化处理
如果前端页面（如 http://fe.example.com）要调用跨网段后端（如 http://192.168.5.20:8080/api），浏览器会因同源策略拦截。此时不应在后端加 CORS 头，而应在 Nginx 层统一封装：
- 在对应 location 块中添加：
add_header Access-Control-Allow-Origin *;add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";add_header Access-Control-Allow-Headers "Origin, Content-Type, Authorization";add_header Access-Control-Allow-Credentials "true"; - 对预检请求（OPTIONS）快速响应：
if ($request_method = 'OPTIONS') {<br> add_header Access-Control-Allow-Origin *;<br> add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";<br> add_header Access-Control-Allow-Headers "Origin, Content-Type, Authorization";<br> add_header Access-Control-Allow-Credentials "true";<br> add_header Access-Control-Max-Age 1728000;<br> add_header Content-Length 0;<br> add_header Content-Type text/plain;<br> return 204;<br> }
验证与可观测性建议
配置生效后，别只看页面是否“能打开”。真正影响体验的是稳定性与排障效率：
- 用
curl -v http://your-domain.com/api/test查看响应头、状态码、真实后端 IP（viaX-Proxy-Upstream可自定义添加） - 开启 access_log 并记录 upstream_addr：
log_format upstream '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$upstream_addr" "$upstream_response_time" $request_time'; - 定期检查
nginx -t和systemctl status nginx，避免 reload 后配置未生效
