Composer 默认不走代理，国内直连阿里云、清华等镜像源即可；仅当遇到特定场景（如内网强制代理、GitHub dist 包限流且无 Token、CI 无公网出口）才需配置 http-proxy 或 HTTP_PROXY/HTTPS_PROXY 环境变量。
Composer 本身不走代理，除非你明确配了 http-proxy 或环境变量；国内直连镜像源（如阿里云、清华）完全不需要代理，强行配反而容易出错。
为什么你看到的“需要代理”说法大多是误导
很多教程把“换源”和“配代理”混为一谈。实际上：
- 镜像源（如
https://mirrors.aliyun.com/composer/）是真实可访问的 HTTPS 服务，国内大部分网络环境直连即可，无需任何代理 - 所谓“代理”常被误用于解决 GitHub dist 包下载慢的问题——但那是另一个链路，和 Composer 元数据源无关
- 如果本地已能
curl -I https://mirrors.aliyun.com/composer/packages.json返回 200，就证明根本不需要代理
真正要配代理的场景只有这几种
不是“Composer 下载慢”，而是你遇到以下具体现象时才该考虑代理：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
file could not be downloaded: failed to open stream且确认allow_url_fopen已开启、镜像 URL 可 curl 通 → 很可能是公司内网只放行了代理出口 - 执行
composer install卡在下载某个 GitHub dist 包（URL 含github.com/xxx/archive/），且你没配 GitHub Token → 这时 proxy 是绕过限流的临时手段，非长久之计 - CI 环境跑在无公网出口的私有云中，所有外网请求必须经企业统一代理 → 需设
composer config -g http-proxy http://proxy.example.com:8080
配代理前先确认是否真有必要
多数人以为“卡住 = 要代理”，其实更大概率是：
- 没清缓存：
composer clear-cache再试 - IPv6 fallback 卡顿：加
COMPOSER_IPV4=1强制走 IPv4 - GitHub API 限速：优先用
composer config -g github-oauth.github.com <your-token>，比代理更稳定、更安全 - 镜像地址写错或已停服：比如还用
https://packagist.phpcomposer.com（2025 年底起已不可用）
如果真要配，只认这两个配置项
Composer 官方只支持两种代理设置方式，其他都是无效的：
- 全局 HTTP 代理：
composer config -g http-proxy http://user:pass@proxy:port（支持带认证） - 环境变量方式（优先级更高）：
export HTTP_PROXY=http://proxy:port或export HTTPS_PROXY=https://proxy:port
别碰 secure-http false 或 disable-tls true —— 这不是代理，是关安全校验，会带来中间人风险。
