Nginx反向代理502/Connection refused 如何配置经正向代理访问CDN
核心修改逻辑
Nginx默认不会自动读取服务器配置的正向代理环境变量,目前直连CDN的请求被防火墙拦截,是触发502报错的根本原因。要实现Nginx通过内网正向代理转发请求到CDN,不需要调整原有缓存配置,只需要修改代理转发目标、补充适配代理链路的请求头、调整请求格式适配正向代理的协议要求即可。
修改前需要确认的信息
- 内网正向代理的准确访问地址,格式一般为
http://正向代理IP:端口 - 正向代理是否需要身份认证,若需要提前准备好对应的用户名、密码
- 正向代理的访问策略是否允许转发到你的CDN域名,避免被正向代理的拦截规则挡住
具体配置修改说明
- 原有缓存配置完全保留,不需要做任何调整。Nginx的缓存逻辑和上游链路无关,只要请求URI、Host头一致,缓存命中规则不会受影响。
- 在http块抽离公共代理配置,减少两个location块的重复配置:
- 固定Host头为CDN的实际域名,避免转发的域名不匹配导致CDN返回错误
- 调整和代理链路匹配的超时参数,避免网络波动触发502
- 若正向代理需要认证,补充对应的Proxy-Authorization请求头
- 每个location块内新增rewrite规则,把原来的相对路径URI重写为带CDN域名的绝对URL,适配正向代理的协议要求(正向代理要求接收的请求行必须是完整的绝对URL,而非相对路径)。
- 把原来直连CDN的proxy_pass,替换为内网正向代理的地址。
修改后的完整配置示例
worker_processes 1; daemon on; error_log /var/log/error.log; pid /var/run/nginx.pid; events { worker_connections 1024; } http { # 原有缓存配置完全保留 proxy_cache_path /path/to/the/cache/folder/1 levels=1:2 keys_zone=cache_common:512m max_size=128g inactive=7d use_temp_path=off; proxy_cache_path /path/to/the/cache/folder/2 levels=1 keys_zone=cache_version:1m max_size=128M inactive=60s use_temp_path=off; # 新增公共代理配置 proxy_set_header Host this-is-my-cdn-url.com; proxy_set_header Proxy-Connection ""; # 正向代理需要认证时开启下面配置,替换为base64编码的 用户名:密码 内容 # proxy_set_header Proxy-Authorization "Basic 替换为实际编码内容"; proxy_connect_timeout 10s; proxy_read_timeout 30s; server { listen 8000 default; access_log /var/log/access.log; location /url1/ { proxy_cache cache_version; # 新增重写规则,构造适配正向代理的绝对URL rewrite ^(.*)$ http://this-is-my-cdn-url.com$1 break; # 修改为正向代理地址 proxy_pass http://你的正向代理IP:端口; } location / { proxy_cache cache_common; proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504; proxy_cache_valid 404 1d; # 新增重写规则 rewrite ^(.*)$ http://this-is-my-cdn-url.com$1 break; # 修改为正向代理地址 proxy_pass http://你的正向代理IP:端口; } } }
配置修改完成后,先执行
nginx -t校验语法合法性,确认无报错后执行nginx -s reload重载配置即可生效。
常见踩坑说明
- 不要直接在proxy_pass后面拼接CDN地址构造绝对URL:这种写法会被Nginx的URL解析逻辑误判,把后面的CDN域名部分当成正向代理的主机名,导致连接失败。正确的做法是用rewrite指令把URI重写为完整的绝对URL,再让proxy_pass把这个重写后的URI发给正向代理。
- 不要只把原proxy_pass的CDN地址替换成正向代理地址而不调整URI格式:这种写法会让Nginx把相对路径发给正向代理,正向代理会因为收到的是相对路径的请求(不是标准正向代理请求格式)返回错误,导致502。
- 不要依赖服务器系统层面的
http_proxy/https_proxy环境变量:Nginx的master进程启动时不会自动继承这类系统环境变量,就算在系统全局加了代理配置,Nginx也不会自动走代理链路,必须在配置文件里显式写转发规则。 - 不要原样透传客户端传入的Host头:如果直接把客户端请求里的Host值发给正向代理,CDN端会因为域名不匹配返回匹配错误,必须固定Host值为CDN的实际域名。
- 不要改动原有缓存配置:Nginx的缓存Key是基于请求URI、Host头计算的,不管上游链路是直连CDN还是走正向代理,缓存的命中、过期规则完全不受影响,改动反而可能破坏原有缓存效果。
内容的提问来源于stack exchange,提问作者Abhinav
相关产品推荐
相关产品推荐

