如何在 Composer 中为私有仓库配置双因素认证（2FA）？

Composer不直接支持2FA，需通过PAT或SSH实现兼容：用个人访问令牌替代密码配置auth.json的http-basic，或改用SSH URL并确保密钥可用。

Composer 本身不直接支持双因素认证（2FA），它依赖 Git 或 HTTP 客户端（如 curl）来拉取私有仓库代码，而 2FA 是由托管平台（如 GitHub、GitLab、Bitbucket）在访问层强制实施的。因此，“为 Composer 配置 2FA” 实际上是配置凭证方式，使其能绕过交互式密码输入、兼容平台启用 2FA 后的认证要求。

使用个人访问令牌（PAT）替代密码

GitHub、GitLab 等平台在启用 2FA 后，会禁用基于用户名+密码的 Git 操作（如 git clone https://...）。你需要生成一个带足够权限的个人访问令牌，并用它代替密码：

• GitHub：进入 Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token，勾选 repo（私有仓库需此权限）
• GitLab：Settings → Access Tokens → Create personal access token，至少勾选 read_repository
• 将令牌用于 HTTPS 克隆 URL：把 https://user:password@github.com/org/repo.git 改成 https://user:TOKEN@github.com/org/repo.git

配置 Composer 使用令牌（推荐：auth.json）

在项目根目录或全局 Composer 配置目录（~/.composer/auth.json）中添加认证信息，避免硬编码到 composer.json：

{
    "http-basic": {},
    "github-oauth": {
        "github.com": "ghp_abc123..." 
    }
}

注意：github-oauth 仅适用于 GitHub 的 OAuth Token（旧版），对新版 PAT 推荐统一使用 http-basic：

标签： composer 双因素认证 linux word js git json windows github 编码 acce