代理配置后composer update仍慢,大概率是代理未生效或与镜像冲突;已配阿里云镜像时代理基本无效,应优先确认元数据是否刷新(如用composer update --refresh)和依赖约束是否过宽。

代理配置后 composer update 仍慢,是不是代理没生效?
大概率是代理配置了但没走通——Composer 的 update 命令会先查元数据(packages.json),再下载 ZIP 或 Git。如果代理只配了 http-proxy 没配 https-proxy,HTTPS 请求就会 fallback 到直连,而国内访问 packagist.org 通常超时或极慢。
验证方法很简单:curl -x http://127.0.0.1:7890 https://packagist.org/packages.json 能返回 JSON 就说明代理通;如果报 SSL 错误,换 http:// 协议重试(绕过证书校验);如果直接 Connection refused,说明代理进程没开或端口错。
-
composer config -g repo.packagist.org.proxy和repo.packagist.org.ssl-proxy必须同时设置,缺一不可 - SOCKS5 代理(如
socks5://127.0.0.1:7891)仅在 Composer ≥ 2.2 支持,旧版本会静默忽略 - 代理配置不作用于镜像源——如果你已配了阿里云镜像,
update默认根本不会访问packagist.org,此时代理完全无效
为什么开了代理反而更卡?常见协议和证书陷阱
典型现象是日志里反复出现 file_get_contents(): SSL operation failed 或 Connection timed out,这不是 Composer bug,而是代理层 TLS 处理异常。
根本原因有两个:一是本地 CA 证书不被代理信任(尤其企业自签证书环境),二是代理本身不支持透传 HTTPS 流量(比如只做 HTTP tunnel)。这时候强行走 HTTPS 代理只会失败。
- 临时绕过:把
ssl-proxy改成http://地址(例如http://127.0.0.1:7890),让 Composer 降级走明文代理 - CI/CD 中慎用代理:多数内网 CI 已直连阿里云/腾讯云镜像,加代理反而多一跳,还可能触发鉴权拦截
- Clash、Sing-Box 等工具开启 TUN 模式后,建议优先用系统级代理(如 Windows 的 WinHTTP 或 macOS 的 network proxy),而非 Composer 单独配
代理 vs 镜像:哪个对 composer update 速度影响更大?
镜像赢在元数据同步快、ZIP 下载近;代理赢在能穿透网络限制——但二者不是互斥关系,而是分阶段起作用。
update 分三步:① 拉取 provider 列表(如 provider-2024-07.json)→ ② 解析依赖图 → ③ 下载 ZIP 包。镜像加速①和③;代理只可能加速①(且仅当没配镜像时);②完全本地计算,跟网络无关。
- 已配阿里云镜像(
https://mirrors.aliyun.com/composer/):代理配置基本无意义,删掉更干净 - 未配镜像、纯靠代理访问
packagist.org:延迟波动大,受代理稳定性、TLS 握手、DNS 解析三重影响 - 清华源元数据同步延迟可达 15 分钟以上,此时即使代理通畅,
update也拿不到最新版——得用composer show -a vendor/package看实际可见版本
如何确认代理正在被 composer update 使用?
别信 config -g 输出,要看实际请求日志。加 -vvv 是唯一可靠方式:
composer update -vvv 2>&1 | grep -E "(GET|POST) https?:"
如果看到 GET https://packagist.org/...,说明没走镜像也没走代理;如果看到 GET http://127.0.0.1:7890/https://packagist.org/... 或类似带代理前缀的 URL,才表示代理生效。
- 全局代理配置写错键名(如写成
repos.packagist.org.proxy)会导致静默失效,必须是repo.packagist.org.proxy -
composer create-project也会走同一套代理逻辑,但它内部会额外请求https://repo.packagist.org/packages.json,漏配ssl-proxy就会卡住 - 删除代理只需两条命令:
composer config -g --unset repo.packagist.org.proxy和composer config -g --unset repo.packagist.org.ssl-proxy
真正影响 update 速度的,从来不是“有没有代理”,而是“元数据是否新鲜”和“约束是否宽松”。一个 "*" 版本号带来的求解爆炸,比所有网络优化加起来都慢。











