Composer 不代理 GitHub ZIP 下载,仅镜像 Packagist 元数据;dist.url 由 composer.lock 固定且不受 repo.packagist 影响,需删 lock 文件并重装才能更新,或用 ghproxy 等反向代理/自建镜像解决。

Composer 本身不提供 GitHub 的 HTTPS 协议镜像 —— 它只代理 Packagist 元数据,不重写或转发 codeload.github.com 或 api.github.com 的请求。 配置 repo.packagist 镜像后仍卡在 Downloading https://codeload.github.com/...,不是配错了,而是根本没走通“镜像 ZIP 包”这一步。
为什么 composer config --global repo.packagist 不影响 GitHub 下载
Composer 的下载流程分两层:
- 元数据(
packages.json、版本列表、依赖关系)走repo.packagist配置的镜像源 - 实际 ZIP 包(
dist.url)从composer.lock里读取,原始值就是 GitHub 的https://codeload.github.com/... - 镜像服务(如阿里云、清华)不托管
dist文件,只同步p2/下的 JSON 元数据
所以即使你执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,只要 composer.lock 里还存着旧的 dist.url,它就继续直连 GitHub。
怎样让 dist.url 变成镜像地址(或代理地址)
必须触发 Composer 重新生成 composer.lock,且让它从镜像源拉取元数据、再拼出新的 dist.url。关键动作是:
- 删掉
vendor/和composer.lock(不能只删 vendor) - 确保全局镜像配置已正确生效(
composer config -g repo.packagist输出完整 JSON,含"type": "composer"和末尾带/的 URL) - 运行
composer clear-cache,否则可能复用旧缓存里的packages.json - 执行
composer install(不是update),让 Composer 重新解析所有包并写入新dist.url
此时 composer.lock 中的 dist.url 可能仍是 GitHub 地址 —— 因为国内镜像不改写它;但如果你用了 ghproxy.com 类反向代理(如 https://ghproxy.com/https://codeload.github.com/...),就得在 repositories 里显式覆盖:
使用 gitlab-ci-local 解析器和 YAML AST 转换来将 GitLab CI .gitlab-ci.yml 流水线转换为 GitHub Actions 工作流程。将 GitLab 阶段、服务和构件映射到等效的 GitHub Actions 语法。
{
"repositories": [
{
"type": "composer",
"url": "https://ghproxy.com/https://packagist.org"
}
]
}
项目级 repositories 会完全屏蔽全局镜像
哪怕你只写了空对象 {} 或 {"packagist.org": false},Composer 就认为你主动接管了仓库逻辑,直接忽略 repo.packagist 全局配置。
- 检查
composer.json顶层是否有repositories字段 - 如果存在,且你又想用全局镜像,要么删掉该字段,要么把它设为
null(无效值,会被跳过) - CI 环境尤其容易中招:某些脚手架模板默认加了
"repositories": [{}],导致镜像静默失效
验证方式很简单:运行 composer config -g repo.packagist 输出正常,但 composer install -vvv | grep "GET.*packages.json" 却请求了 packagist.org,八成是这个原因。
真正能加速 GitHub ZIP 下载的方案只有两类
一类是代理类服务,一类是自建缓存:
-
ghproxy.com或gh.api.996.icu这类公开反向代理,把https://codeload.github.com/...请求转到它们的边缘节点(注意:部分已不可用,需实测) - 企业级可部署
satis或packagist-mirror(阿里开源版),配置DIST_URL指向内部 OSS 或 CDN,让dist.url直接变成内网地址 - CI 流水线中可提前
curl -L把 ZIP 下载到缓存目录,再用composer config --global artifact-path指向该路径
别在 repo.packagist 上反复试错——它的作用域非常明确,越想让它干它不该干的事,问题越隐蔽。










