ubuntu composer如何认证

ubuntu

小樊

2026-10-13 13:29:55

栏目: 智能运维

在 Ubuntu 上使用 Composer 进行“认证”，通常分为几种常见场景。下面按最常见需求给你说明。

一、Composer 访问私有仓库（GitHub / GitLab / Gitee 等）

1️⃣ 使用 GitHub Token 认证（最常用）

生成 Token

GitHub → Settings → Developer settings → Personal access tokens
勾选 repo（私有库需要）

配置方式一：命令行登录（推荐）

composer config -g github-oauth.github.com <your_token>

配置方式二：手动编辑

编辑 ~/.config/composer/auth.json（全局）或项目 auth.json：

{
    "github-oauth": {
        "github.com": "your_token"
    }
}

二、使用 GitLab / Gitee 私有仓库

GitLab

composer config -g gitlab-oauth.gitlab.com <token>

Gitee

composer config -g gitee-oauth.gitee.com <token>

或 auth.json：

{
    "gitlab-oauth": {
        "gitlab.com": "token"
    }
}

三、Composer 私有包仓库（如 Satis / Private Packagist）

HTTP Basic 认证

composer config -g http-basic.repo.example.com username password

auth.json 示例：

{
    "http-basic": {
        "repo.example.com": {
            "username": "user",
            "password": "pass"
        }
    }
}

四、Composer 自身登录（Packagist / 官方源）

如果你使用的是 Private Packagist：

composer login

按提示输入账号密码或 Token。

五、Ubuntu 常见问题排查

1️⃣ 权限问题

不要用 sudo composer

sudo chown -R $USER:$USER ~/.composer

2️⃣ 查看当前认证

composer config -g --list
cat ~/.config/composer/auth.json

3️⃣ 调试认证失败

composer -vvv require vendor/package

六、总结一句话

Ubuntu 上 Composer 认证 = Token / 账号密码写入 auth.json 或 composer config

如果你能告诉我：

是 GitHub / GitLab / 私有仓库？
是 安装包失败还是发布包？

我可以直接给你精确命令。