要让nginx正向代理稳定支持大型软件包下载，需延长超时参数、禁用响应缓冲、启用https connect透传并正确配置dns解析。
要让 Nginx 正向代理稳定支持下载大型软件包（如 ISO、deb、rpm、tar.gz 等），关键不是“能转发”，而是确保连接不中断、缓冲不截断、超时不触发、传输不被限速或截断。默认配置下，Nginx 很容易在大文件传输中因超时、缓冲区小或 SSL 握手问题失败。
必须调整的超时与连接参数
大型下载往往耗时长、流量大，需显式延长以下超时时间（单位：秒）：
- proxy_connect_timeout：建立到目标服务器 TCP 连接的最长时间，建议设为 60
- proxy_send_timeout：Nginx 向上游（目标服务器）发送请求体的超时，下载大文件时需足够长，建议 300
- proxy_read_timeout：Nginx 等待上游响应数据的时间，尤其影响大文件流式传输，建议 600（10 分钟）或更高
- keepalive_timeout：客户端与 Nginx 之间的长连接保持时间，建议设为 75，避免频繁重连
关闭缓冲、启用流式传输
默认开启的 proxy_buffering 会缓存整个响应再返回，对 GB 级下载极易 OOM 或延迟巨大。必须禁用：
- proxy_buffering off; —— 关闭响应缓冲，实现边收边发
- proxy_buffer_size 128k; —— 仅保留基础 header 缓冲，够用即可
- proxy_buffers 4 256k; —— 若仍需少量缓冲，设小值且数量少
- proxy_max_temp_file_size 0; —— 彻底禁用磁盘临时文件，防止写满磁盘
HTTPS 下载特别注意：CONNECT + SSL 透传
下载软件包多走 HTTPS（如 https://repo.ubuntu.com/、https://mirrors.tuna.tsinghua.edu.cn/），必须启用 proxy_connect 模块并正确配置：
- 确保已编译安装
ngx_http_proxy_connect_module，且 patch 版本与 Nginx 匹配 - proxy_connect_allow 443 563; —— 明确放行 HTTPS 和 SNEWS 端口
- resolver 114.114.114.114 valid=30s; —— 使用可靠 DNS，避免域名解析失败导致下载中断
- 不要在 CONNECT server 块中加
proxy_pass或location，那是反向代理逻辑，会干扰隧道
完整可运行的正向代理 server 配置示例
监听 8030 端口，专用于大文件下载场景：
server {
listen 8030;
resolver 114.114.114.114 ipv6=off valid=30s;
<pre class="brush:php;toolbar:false;"># HTTPS CONNECT 支持
proxy_connect;
proxy_connect_allow 443 563;
proxy_connect_connect_timeout 60s;
proxy_connect_read_timeout 60s;
proxy_connect_send_timeout 60s;
# HTTP/HTTPS 通用转发（非 CONNECT 请求，如部分镜像站用 HTTP）
location / {
proxy_pass http://$host$request_uri;
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_buffering off;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_max_temp_file_size 0;
proxy_connect_timeout 60s;
proxy_send_timeout 300s;
proxy_read_timeout 600s;
keepalive_timeout 75s;
}}
配置后执行 nginx -t && nginx -s reload 生效。
