必须同时配置http-proxy和https-proxy,缺一不可;https-proxy值必须为http://开头,用于HTTPS CONNECT隧道,漏配或协议错误会导致静默直连、卡在“Loading composer repositories”或超时。

为什么只配 https-proxy 还是连不上
因为 Composer 对 HTTP 和 HTTPS 流量完全分离路由:http-proxy 只管 http:// 请求,而所有 Packagist、GitHub、私有源实际都走 HTTPS,必须由 https-proxy 承担 CONNECT 隧道建立。漏掉它,请求就直连——没报错,只有卡在 “Loading composer repositories” 或超时。
https-proxy 的值必须是 http:// 开头
这是硬性约定,哪怕代理本身监听 HTTPS 端口(比如 https://127.0.0.1:8080),填进去也会静默失效或触发 502。正确写法永远是:
http://127.0.0.1:7890-
http://user:pass@127.0.0.1:7890(密码含@、/、:必须先rawurlencode()) -
socks5://127.0.0.1:7891(仅 Composer ≥ 2.2 支持,旧版本会忽略)
验证代理是否真生效,别信日志
Composer 日志里不会写 “连不上代理”,只会模糊报错或卡住。绕过它,直接用 curl 复现:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
-
curl -x http://127.0.0.1:7890 https://repo.packagist.org/packages.json→ 返回 JSON:代理通,问题在 Composer 配置(比如漏了https-proxy) - Connection refused:代理进程没开,或端口填错,或防火墙拦截
- 502 Bad Gateway:代理把 HTTPS 请求错发给了 HTTP 后端,换
http://地址再试 - SSL certificate problem:本地 CA 不被信任,临时加
-k测试是否能通
NTLM 代理怎么办
Composer 原生不支持 NTLM 认证,设了 http-proxy 也只会返回 407 或连接拒绝。这不是配置错,是协议不兼容。
唯一可行路径是本地起中转代理:
- Windows 下用
cntlm或px,监听127.0.0.1:3128并处理 NTLM - 然后统一配
composer config -g http-proxy http://127.0.0.1:3128和https-proxy http://127.0.0.1:3128 - 验证:用同样
curl -x http://127.0.0.1:3128 -I https://packagist.org/packages.json,若也 407,说明中转层没跑起来
http:// 协议头的强制要求、NTLM 必须靠中转、以及验证必须跳过 Composer 直接用 curl ——这些地方出错,都不会报明确错误,只会让整个流程卡住。

















