Private Packagist 配 access token 不报 401 的关键是:用带 read:packages 权限的 API token,auth.json 中 username 填 token、password 必须为 ""(空字符串),文件置于项目根目录且 chmod 600;同时后台需开启“Enable development version support”并 Resync。

Private Packagist 怎么配 access token 才不 401?
Private Packagist 必须用带 read 权限的 API token 做 HTTP Basic 认证,用户名填 token、密码字段留空字符串,否则 composer install 会卡在 401 Unauthorized —— 尤其在 CI 环境里,容易误判成网络或缓存问题。
-
auth.json必须放在项目根目录(和composer.json同级),不能只靠composer config --global写进用户级配置(CI 容器里通常不生效) - 内容格式严格:
username字段填完整 token 字符串,password字段必须是空字符串"",不是null,也不能删掉该键 - token 必须在 Private Packagist 后台为对应组织生成,scope 选
read:packages,且已绑定目标仓库 - Linux/macOS 下执行
chmod 600 auth.json,权限不对 Composer 会静默忽略,不报错也不提示
GitHub/GitLab 私有仓库怎么传 PAT?
GitHub 和 GitLab 不支持密码登录,必须用 Personal Access Token(PAT)。但两者认证机制不同:GitHub 走 github-oauth 字段,GitLab 推荐用 gitlab-token 或 http-basic,不能混用。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- GitHub:运行
composer config --global github-oauth.github.com <your-token></your-token>,token 需含repo权限;auth.json中对应字段是github-oauth - GitLab:推荐用
gitlab-token字段,命令为composer config --global gitlab-token.gitlab.com <your-token></your-token>;若走 HTTPS +http-basic,则username填 token、password留空,域名必须和请求 URL 完全一致(如gitlab.com≠my.gitlab.internal) - 所有 token 都不能硬编码进
composer.json或 URL 里,否则有泄露风险 - VCS 类型仓库(
"type": "vcs")的url必须是可直接克隆的地址,比如https://gitlab.com/org/pkg.git,不能是网页链接
为什么 composer update 找不到 dev 分支?
Private Packagist 默认只同步 tagged release(如 v1.2.0),dev-main、dev-feature/x 这类开发分支不会自动出现。这不是认证问题,而是后台开关没开。
- 进入 Private Packagist 后台 → 对应组织 → Settings → “Enable development version support” 必须手动开启
- 开启后需点击 “Resync” 强制刷新元数据,否则
composer require vendor/pkg:dev-main仍报Could not find package - 不要指望
"packagist.org": false能解决这个问题——它只是禁用公共源,跟 dev 分支可见性无关 - 如果用的是 VCS 类型(GitHub/GitLab),dev 分支天然可见,但前提是认证通过且仓库 URL 可访问
多个私有源共存时怎么避免包名冲突?
Composer 查找包时按 repositories 数组顺序匹配,第一个命中就停。同名包(如 acme/utils)若在 Public Packagist 和私有源中都存在,顺序错了就会拉错源。
- 私有源必须放在
repositories数组最前面,尤其是 Private Packagist 这种"type": "composer"源 - 不要删掉默认公共源,除非你真想完全隔离;保留
"packagist.org": true(默认行为)更安全 -
repositories必须是 JSON 数组,不能写成对象;每项必须有"type"和"url",type只能是vcs、composer或path - URL 域名必须和
auth.json中的域名完全一致,https://repo.packagist.com/org/≠repo.packagist.com(少斜杠也会失败)
composer update 就安静失败,连错误提示都藏得深。

















