Composer安装提示无法访问GitHub？SSH代理与Access Token-composer-PHP中文网

composer安装失败90%因网络拦截或认证缺失，非自身故障；核心方案为https+代理+github token双保险，或ssh+正确代理配置，需清缓存、验全局配置并避免composer.json瞎改源。

composer安装提示无法访问github？ssh代理与access token

Composer安装失败、提示无法访问 GitHub，90% 是网络层阻断或认证缺失导致的，不是 Composer 本身的问题。核心解决路径只有两条：走 HTTPS + 代理 / Token，或走 SSH + 正确代理配置。别在 composer.json 里瞎改源，那治标不治本。

为什么 Composer 会卡在 GitHub 访问环节？

Composer 默认通过 HTTPS 协议拉取包元数据（如 packagist.org 的索引）和实际代码（多数包托管在 GitHub）。一旦 HTTPS 请求被拦截或超时，就会报类似 Failed to download vendor/package: Could not fetch https://api.github.com/... 或 Connection timed out 的错误。这不是 Composer 没权限，而是底层 HTTP 请求根本发不出去。

国内常见原因：GitHub API 域名解析正常但 HTTPS 连接被重置（非 DNS 问题）
企业环境常见原因：出口防火墙禁止对 api.github.com 的 443 出站连接
CI/CD 场景常见原因：容器内未配置代理，或 http_proxy 环境变量未透传

HTTPS 方式：用代理 + GitHub Personal Access Token（PAT）双保险

只配代理不够稳——GitHub 对未认证的 API 请求有严格限速（60次/小时），一旦触发限流，composer install 就会直接失败。必须搭配 PAT 才能绕过限速并提升成功率。

github-health-diagnosis

GitHub 项目健康度诊断 — 输入仓库地址，AI 自动分析 Issues、代码质量、CI 状态，生成诊断报告并发布到飞书 Wiki。

下载

生成 PAT：进入 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token，勾选 repo 权限（最小权限原则，无需 admin:org）
写入凭证：运行 git config --global github.token YOUR_TOKEN_HERE（Composer 会自动读取）
配 HTTPS 代理：执行 git config --global http.proxy 'socks5://127.0.0.1:7890' 和 git config --global https.proxy 'socks5://127.0.0.1:7890'（端口按你本地代理软件实际值调整）
验证是否生效：执行 curl -H "Authorization: token YOUR_TOKEN_HERE" https://api.github.com/rate_limit，返回 "rate": {"limit": 5000, ...} 表示成功

SSH 方式：绕过 HTTPS 限速，但代理配置更易出错

如果项目已用 SSH URL（如 git@github.com:vendor/package.git），Composer 会走 SSH 协议拉代码。这时 HTTPS 代理完全无效，必须单独配 SSH 代理，且容易因 ProxyCommand 路径或参数错位而静默失败。

确认 SSH URL：检查 composer.lock 或 vendor/ 下已安装包的 .git/config，看 remote origin 是否为 git@github.com:...
编辑 ~/.ssh/config，添加：
```
Host github.com
  User git
  ProxyCommand connect -S 127.0.0.1:7890 %h %p
```
注意：connect 是 proxy-connect 工具命令，不是系统自带；若未安装，需先 brew install proxy-connect（macOS）或从源码编译（Linux）
测试连通性：运行 ssh -T git@github.com，成功应返回 Hi username! You've successfully authenticated...
避免密钥权限错误：确保 ~/.ssh/id_rsa 权限是 600，否则 SSH 会拒绝加载

最容易被忽略的点：Composer 自身缓存与全局配置冲突

即使代理和 Token 都配好了，Composer 仍可能复用旧缓存或错误的全局配置，导致问题反复出现。

清空 Composer 缓存：运行 composer clear-cache，不要只删 ~/.composer/cache 目录
检查全局配置：执行 composer config --list --global，确认没有残留的 github-oauth 或错误的 repositories 配置
临时禁用插件：某些 Composer 插件（如 hirak/prestissimo）会绕过系统代理，加 -n 参数运行 composer install -n 可验证是否插件干扰
调试开关：加 -v 参数（如 composer update -v），看具体卡在哪一步——是 resolve 还是 download 阶段失败