企业级 Composer 代理配置必须同时设置 http-proxy 和 https-proxy,缺一不可;否则 HTTPS 请求静默直连,在防火墙下被拦截或超时,卡在 Loading composer repositories 且无报错。

企业级 Composer 代理配置必须同时设置 http-proxy 和 https-proxy,缺一不可;否则所有 HTTPS 仓库请求(包括 Packagist、私有 Composer 源)会静默 fallback 直连,卡在 Loading composer repositories 且无明确错误。
为什么只配 http-proxy 仍连不上 Packagist
因为 Packagist、阿里云镜像、Artifactory 等全量走 HTTPS,而 Composer 对代理是协议分离路由的:http-proxy 只处理 HTTP 请求,https-proxy 才用于建立 HTTPS 的 CONNECT 隧道。漏掉后者,实际流量就变成直连——在企业防火墙下直接被拦截或超时。
-
https-proxy的值必须是http://开头(不是https://),这是 Composer 的硬性约定,哪怕代理服务本身监听 TLS 端口 - 典型错误写法:
https://127.0.0.1:8080、127.0.0.1:8080、https-proxy字段缺失 - 密码含
@、/、:必须 URL 编码,例如pa@ss/word→pa%40ss%2Fword - 验证命令:
composer config -g --list | grep -E "(http|https)-proxy",两行都应输出且格式正确
https-proxy 配置后仍失败?先排除 NTLM 代理场景
Windows 域环境常用 NTLM 认证代理,但 Composer 原生不支持。设了 http-proxy 也会返回 407 Proxy Authentication Required 或连接拒绝。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 不能靠改 Composer 配置解决,必须引入中转代理工具:如
cntlm或px,让它们监听127.0.0.1:3128并处理 NTLM 认证 - Composer 再指向这个本地地址:
composer config -g https-proxy http://127.0.0.1:3128 - 临时验证是否为 NTLM 问题:
curl -x http://127.0.0.1:3128 -I https://packagist.org/packages.json,若curl同样报 407,说明中转层未配通 - 别指望系统
HTTP_PROXY环境变量——Composer 明确忽略它,只认自己的字段
CI/CD 和 Docker 中代理配置必须显式路径 + 全局作用域
全局配置默认写入 $HOME/.composer/config.json,但在 GitHub Actions、GitLab CI、Docker 构建中,$HOME 往往是空或只读路径(如 /root 或 /tmp),导致配置失效,退回到默认源。
- CI 脚本中禁用裸
composer config -g,改用显式COMPOSER_HOME:export COMPOSER_HOME="/tmp/composer" && composer config -g https-proxy http://127.0.0.1:3128 - Dockerfile 中建议提前预热:
RUN export COMPOSER_HOME="/tmp/composer" && composer config -g https-proxy http://host.docker.internal:3128 && composer clear-cache - 避免混用
sudo composer config -g:它会把配置写进/root/.composer/config.json,普通用户运行时读不到 - 验证是否生效:
composer install -vvv 2>&1 | grep "Downloading.*packages.json",确认域名和协议匹配预期代理链路
最常被忽略的一点:代理配置只是“通道”,不解决镜像源 fallback 问题。即使代理通了,若没禁用 packagist.org,Composer 仍会在镜像失败后重试官方源——这恰恰是企业防火墙识别并阻断开发流量的关键特征。所以代理 + 镜像 + "packagist.org": false 必须三者齐备,才构成完整的企业级防护链路。

















