解决Composer镜像源在自建私有云中的Ingress带宽限速问题-composer-PHP中文网

ingress控制器默认策略限制导致parallel-downloads=15更慢，需调参：限连数设为50、关rps限制、proxy-read-timeout设600秒、加路径白名单关闭限速，并优化后端pod的php-fpm和nginx配置。

解决composer镜像源在自建私有云中的ingress带宽限速问题

自建私有云中 Composer 镜像源走 Ingress 出现带宽限速，不是镜像本身限流，而是 Ingress 控制器（如 Nginx Ingress、Traefik）默认的连接数、带宽或超时策略卡住了大并发下载请求；必须从 Ingress 层调参，而非只改 Composer 配置。

为什么 `parallel-downloads=15` 在私有云里反而更慢

Composer 的并发下载会发起大量短连接请求到镜像域名，而 Ingress 默认配置往往没为静态资源分发做过优化：

nginx.ingress.kubernetes.io/limit-connections 未设或设得太低（如默认 10），导致多余请求排队等待
nginx.ingress.kubernetes.io/limit-rps 或 limit-rpm 被误启用，把镜像流量当成 API 流量限速
Ingress 后端 Service 的 maxConnections 或 readTimeout 过短，composer install 中大量 .tar.gz 下载中途被断连
Traefik 的 http.routers.xxx.middlewares 若挂了 rateLimit 中间件，且未对 /dists/ 和 /p2/ 路径白名单放行，就会全局限速

`ingress-nginx` 必须加的 Annotation

针对 Composer 镜像服务（如 mirrors.example.com），Ingress 对象需显式放开以下限制：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

nginx.ingress.kubernetes.io/limit-connections: "50"（别用 0，某些版本不支持无限制）
nginx.ingress.kubernetes.io/limit-rps: "0"（明确关掉每秒请求数限制）
nginx.ingress.kubernetes.io/proxy-read-timeout: "600"（防止大 tarball 下载超时中断）
nginx.ingress.kubernetes.io/proxy-buffering: "on"（开启缓冲，避免后端小块写触发频繁 flush）
nginx.ingress.kubernetes.io/configuration-snippet 加路径白名单：
```
location ~ ^/(dists|p2|packages\.json) { limit_rate off; }
```

镜像后端 Pod 也要调：别让 PHP-FPM 成瓶颈

Ingress 只是入口，真正服务镜像文件的是后端 Pod（比如用 nginx 或 php:apache 托管的 mirror 服务）。常见坑点：

PHP-FPM 的 pm.max_children 太小（如默认 5），parallel-downloads=15 时大量请求排队等 worker
Nginx 的 worker_connections 未随 CPU 核数调高，events { worker_connections 4096; } 是底线
静态文件没启用 sendfile on; 和 tcp_nopush on;，小文件传输效率低
Pod 没配 resources.limits.memory，OOMKilled 后反复重启，composer install 卡在半中间

验证是否真走通 Ingress 带宽路径

别只信 composer -vvv 日志，得确认流量确实经过你调过的 Ingress：

进 Ingress Controller Pod，kubectl logs -f -l app=ingress-nginx-controller | grep mirrors.example.com，看是否有大量 200 且 bytes_sent 达 MB 级
用 curl -I https://mirrors.example.com/dists/packages.json，检查响应头是否有 X-Content-Type-Options: nosniff 和正确 Content-Length，排除重定向或代理截断
在客户端跑 watch -n1 'ss -nt | grep :443 | wc -l'，开 parallel-downloads=15 时连接数应稳定在 10–20，而不是卡在 3–5
如果用了 Service Mesh（如 Istio），确认 DestinationRule 没对镜像域名加 connectionPool 限流