GitHub私有仓库需用Personal Access Token(PAT)替代密码认证,因GitHub自2021年8月起已停用密码方式;Composer拉取时若报403或Authentication failed,主因是未配置PAT,须通过composer config --global github-oauth.github.com 写入auth.json,并确保权限为600、URL为HTTPS格式且域名严格匹配。

GitHub私有仓库:用Personal Access Token替代密码认证
GitHub早在2021年8月就停用了密码认证,现在composer install拉取私有仓库时若报403 Forbidden或Authentication failed,基本就是没配Token。必须用Personal Access Token(PAT)代替密码。
操作路径:GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token。关键权限只勾选repo(别开admin:org这种高危权限)。生成后页面只显示一次,务必立刻复制保存。
配置到Composer的命令是:
composer config --global github-oauth.github.com <your-token-here>
这会把Token写进~/.composer/auth.json(Linux/macOS)或%APPDATA%\Composer\auth.json(Windows),后续所有composer install都会自动携带认证头。
- 如果项目CI/CD中也要拉私有包,得在构建环境里也执行这条
composer config命令,或直接往auth.json里写入Token(注意权限掩码设为600) - Token失效或被吊销后,Composer不会主动提示,只会卡在“Cloning into…”或报
Could not fetch,此时要重生成并更新配置 - 不要在
composer.json里硬编码Token,哪怕加了HTTPS URL——那属于严重安全风险
GitLab私有仓库:用gitlab-oauth配置Token
GitLab的Token机制和GitHub类似,但配置键名不同。生成方式:GitLab → 我的 → 设置 → 访问令牌 → 创建个人访问令牌,权限至少勾选read_repository(如果还要推送Tag或打分支,需加write_repository)。
配置命令不是github-oauth,而是:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
composer config --global gitlab-oauth.gitlab.com <your-gitlab-token>
注意域名必须严格匹配你GitLab实例地址,比如自建GitLab是gitlab.example.com,就得用gitlab-oauth.gitlab.example.com,不能简写成gitlab.com。
- GitLab CE/EE 15.0+ 默认禁用密码认证,但部分旧版仍允许;即便能通,也建议统一迁移到Token,避免后续升级突然中断
- 若使用GitLab Group级Token(非个人),需确保该Token所属用户对目标仓库有至少Reporter权限
- GitLab的OAuth配置不支持通配符,每个子域名都要单独配一条
gitlab-oauth.*
为什么不用SSH密钥?它比Token更难自动化
SSH方式确实安全、免输密码,但实际落地时容易卡在三个地方:CI/CD环境无ssh-agent、Docker容器内缺少~/.ssh/config、多Git平台共存时Host别名冲突。
比如在GitHub和GitLab都用SSH,composer.json里写git@github.com:user/repo.git和git@gitlab.com:user/repo.git,但两者都指向gitlab.com这个Host,就会因密钥错配失败。
- SSH方案适合本地开发,不适合部署脚本或无人值守构建
- Token可明文注入环境变量(如
COMPOSER_AUTH),而SSH私钥需要挂载文件+chmod+ssh-add,步骤多、容错低 - Token可设置过期时间、可随时吊销;SSH密钥一旦泄露,除非手动删公钥,否则长期有效
Token配完还拉不下来?检查这几个隐藏点
即使Token已配置,仍可能失败。最常被忽略的是composer.json里的仓库定义是否匹配认证方式:
- 用了
github-oauth,但repositories里URL写的是git@github.com:user/repo.git(SSH格式)——必须改成https://github.com/user/repo.git - GitLab私有Group仓库,URL写成
https://gitlab.com/group/subgroup/repo.git,但Token只对gitlab.com生效;若实际是gitlab.example.com,URL和配置域名必须完全一致 - 私有包的
name字段(如"myorg/my-private-lib")和require里写的包名不一致,Composer会跳过该仓库,根本不会触发认证流程 - 运行
composer clear-cache后再试——旧缓存可能存着失败的401响应,导致反复复用错误状态
Token本身没有“生成算法”可言,它就是一串随机字符串,关键是配对、权限、URL三者严丝合缝。漏掉任意一环,Composer都只会静默失败,不会告诉你哪错了。

















