Composer在mTLS环境下走代理失败的本质是代理链路不兼容,而非镜像源问题;镜像源不参与TLS握手且不启用双向认证,而https-proxy需支持透传客户端证书的CONNECT隧道,否则握手失败。

composer 在 HTTPS 双向认证(mTLS)环境下走代理,本质不是「镜像源问题」,而是「代理链路不兼容」——镜像源本身不参与 TLS 握手,它只提供静态文件;真正卡住的是 composer 试图通过代理连接 repo.packagist.org(或任何启用客户端证书校验的上游)时,代理无法透传或协商客户端证书。
为什么镜像源配置对双向认证无效
你改 repo.packagist.org 的 URL 为 https://mirrors.aliyun.com/composer/,composer 就直接连阿里云镜像,绕过所有代理逻辑。但阿里云镜像本身不启用双向认证,所以你根本碰不到 mTLS 场景。一旦你必须连真实 repo.packagist.org(比如公司私有 Packagist + mTLS),镜像源就退场了,只剩代理一条路。
- 镜像源是独立 HTTP(S) 站点,不继承原站的 TLS 策略
-
composer config -g repo.packagist和http-proxy/https-proxy是互斥配置项:设了前者,后者自动失效 - 所谓“HTTPS 双向认证下的镜像源”,实际不存在——镜像站没配 client CA,也不要求你传证书
https-proxy 必须支持 CONNECT 隧道且透传 client cert
composer 对 HTTPS 请求只走 https-proxy 配置,并依赖代理建立 CONNECT 隧道。如果代理本身不支持透传客户端证书(比如 Nginx proxy_pass、旧版 Squid),或者你在代理层做了 TLS 终止(terminating TLS),那么 composer 的 client cert 根本发不到远端服务器,握手直接失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证方式:
curl -x http://127.0.0.1:8080 --cert /path/to/client.pem --key /path/to/client.key https://your-mtls-repo.example.com/packages.json—— 若失败,说明代理不透传 cert - Clash、mitmproxy、cntlm 默认不透传 client cert,需显式开启
allow_localhost或配置tls段落 - 企业级代理(如 Zscaler、Blue Coat)往往主动剥离 client cert,这是策略行为,非配置可调
正确做法:跳过代理,用本地证书直连
如果你控制得了 composer 运行环境,最稳解法不是硬调代理,而是让 composer 自己带证书直连目标域名——绕过代理层的 TLS 干预。
- 把 client cert 和 key 放到
~/.composer/auth.json(Linux/macOS)或%APPDATA%\Composer\auth.json(Windows)里:
{
"http-basic": {
"your-mtls-repo.example.com": {
"username": "",
"password": ""
}
},
"certs": {
"your-mtls-repo.example.com": {
"cert": "/full/path/to/client.pem",
"key": "/full/path/to/client.key"
}
}
}composer 会自动在请求该 host 时加载证书,无需代理参与composer 进程有读取权限openssl rsa -in key.pem -out key-unlocked.pem 解锁代理能配但容易被忽略的三个细节
真要走代理,以下三点漏一个,composer install 就静默卡在 Loading composer repositories,不报错也不超时:
-
https-proxy值必须是http://开头,哪怕代理监听在https://端口——填https://127.0.0.1:8443会静默失效 -
http-proxy和https-proxy必须同时存在且格式合法;只设一个,HTTPS 请求就 fallback 直连 - 代理地址含
@(如user@corp.proxy)或密码含@/://,必须对对应字段做rawurlencode(),否则 URI 解析截断,Invalid URI supplied
最终,mTLS 场景下优先走直连 + certs 配置,比折腾代理更可控。代理只是网络中转,不该承担 TLS 协商职责;让它干好 CONNECT 隧道就行,证书的事交给 composer 自己。

















