Composer遇到Git协议端口封禁时强制回退HTTPS镜像-composer-PHP中文网

git@协议在内网或ci中卡住，因默认走ssh（端口22），而环境常禁用该端口或未配置ssh密钥；应使用git config --global url."https://..." insteadof "git@..."全局重写协议，使git自动将git@地址转为https，避免手动修改composer.json且兼容所有包。

composer遇到git协议端口封禁时强制回退https镜像

为什么`git@`协议在内网或CI里直接卡住？

Git 默认走 SSH（git@github.com:org/repo.git），但很多环境禁用 22 端口，或未部署 SSH key，导致 composer install 卡在 Cloning into 'vendor/package'...，且无明确错误提示。这不是 Composer 报错，而是 Git 层静默 hang 住。

常见现象：命令长时间无响应，Ctrl+C 后看到最后一行是 Cloning，但没报 Permission denied (publickey) 或 Connection refused
根本原因：Composer 生成的仓库地址含 git@，而 Git 尝试走 SSH 连接，但网络不通或认证缺失
不要改 composer.json 里的 URL —— 每个包都可能带 git@ 地址，手动替换不可维护，且上游迁移后立即失效

用`git config --global url.`重写协议最干净

让 Git 自己把所有 git@ 地址转成 HTTPS，不依赖 Composer 版本，也不影响 secure-http 判断（因为协议转换发生在 Git 层，Composer 只看到最终 URL）。

执行以下命令全局生效：

git config --global url."https://www.php.cn/link/536f4ea1075a3900f3791bf4097880fc".insteadOf "git@github.com:"
git config --global url."https://gitlab.com/".insteadOf "git@gitlab.com:"
git config --global url."https://gitee.com/".insteadOf "git@gitee.com:"

若私有 Git 服务域名是 git.internal.org，补上：

git config --global url."https://git.internal.org/".insteadOf "git@git.internal.org:"

注意：insteadOf 规则必须以 : 结尾（如 git@github.com:），否则不匹配
验证是否生效：运行 git ls-remote @#@#@#@#@#@#@#@#@#@0，应能列出 refs；再试 git ls-remote git@github.com:composer/composer.git，也应走 HTTPS 成功

`composer config -g default-protocol https`只管“自动推导”的地址

这条命令让 Composer 把没写死协议的 VCS 地址（比如 "vendor/package" 这种简写）默认补成 HTTPS，但它不会动已写死的 git@ 或 https://。

GitHub Safe Sync

检查、触发并清理使用安全同步 GitHub Actions 工作流的 GitHub 镜像仓库，用于 Codex 需要进行仓库镜像同步时。

下载

它适用于：项目里用的是包名简写，依赖由 Packagist 解析出地址，此时 Composer 会生成 @#@#@#@#@#@#@#@#@#@1... 而非 git@...
它不适用于：repositories 里显式写了 "url": "git@gitlab.com:org/repo.git"，这种硬编码地址完全绕过该配置
可选值只有 https、ssh、git、http；http 不推荐，secure-http 开启后会被直接拒绝

HTTPS 回退失败？检查认证和超时

Git 协议切到 HTTPS 后，常见新问题不是连不上，而是认证失败或超时：

私有仓库若需 Token 认证，确保已配置 Git 凭据管理器（如 git config --global credential.helper store），或在 URL 中嵌入 Token：@#@#@#@#@#@#@#@#@#@2
内网镜像若返回 502/404，Composer 默认会卡住等待，需加超时：设环境变量 COMPOSER_HTTP_TIMEOUT=5 或在全局 config 中加 "http": {"timeout": 5}
若用国内镜像（如阿里云），确认其 HTTPS 地址有效：@#@#@#@#@#@#@#@#@#@3；旧 HTTP 地址已被 secure-http 拒绝

真正卡住的地方往往不在协议切换本身，而在 Git 凭据缺失、镜像 DNS 解析失败、或缓存里还存着旧的 git@ 元数据快照——换协议前先 composer clear-cache，比反复调参数更省时间。