镜像同步卡在502/504是因nginx响应缓冲不足而非网络慢：需调大proxy_buffer_size、proxy_buffers、proxy_busy_buffers_size，并配套启用proxy_max_temp_file_size落盘、延长proxy_read_timeout和proxy_send_timeout，且须在独立location中配置以隔离大包流量。

为什么镜像同步卡在502/504，不是网络慢而是Nginx缓冲被撑爆

Composer镜像同步（如用packagist-mirror拉取ZIP包）本质是Nginx代理大量大体积文件（单个.zip常超100MB），此时默认的proxy_buffers和proxy_buffer_size根本不够用——Nginx会把整个响应体缓存在内存里，一两个大包就触发upstream sent too big response或直接502。这不是后端没响应，是Nginx自己扛不住了。

必须调大的三个proxy缓冲参数

只改client_max_body_size没用，那是管上传的；镜像同步是Nginx从上游下载再转发给下游，关键在响应缓冲：

• proxy_buffer_size 64k：响应头可能含长Content-Disposition、自定义X-Package-Hash等字段，4k默认值极易溢出
• proxy_buffers 16 32k：共512KB内存缓冲，比默认8 4k（32KB）提升16倍，足够暂存大部分ZIP头部和元数据
• proxy_busy_buffers_size 128k：必须≤总buffer大小且≥proxy_buffer_size，否则Nginx启动报错

磁盘缓冲和超时必须配套打开

光加内存缓冲风险高——万一并发拉10个200MB包，内存直接吃满。得让Nginx该落盘就落盘：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• proxy_max_temp_file_size 4096m：允许单个临时文件最大4GB，确保大ZIP能写入磁盘（确认client_body_temp_path所在分区有足够空间）
• proxy_read_timeout 1200：上游镜像站下载大包可能耗时数分钟，此值必须覆盖最慢链路，否则Nginx在读取中途断连
• proxy_send_timeout 600：客户端（如packagist-mirror进程）接收慢时，避免因两次写间隔超时被中断

别漏掉location粒度控制和静态资源隔离

镜像同步流量和普通Web请求混在同一server块里？危险。必须精准隔离：

• 把镜像同步路径（如/dists/、/p2/）单独写location ~ ^/(dists|p2)/块，在里面启用上述缓冲配置
• 普通静态资源（.js、.css）走另一套轻量配置，避免被大包缓冲拖垮
• 如果镜像服务本身不校验签名，建议在location里加proxy_buffering off直通，避免Nginx二次缓存放大风险

缓冲区调大只是表象，真正要盯住的是proxy_max_temp_file_size对应磁盘的I/O稳定性——SSD空闲空间低于10%时，临时文件写入延迟飙升，照样触发超时。