如何在composer中配置对Bitbucket私有仓库的访问

配置Composer访问Bitbucket私有仓库需使用认证方式：1. 推荐app Password，在Bitbucket创建具仓库读取权限的App Password，于composer.json添加VCS仓库并执行composer require时输入用户名及该密码，后续可全局配置保存凭证；2. SSH方式适用于服务器环境，将SSH公钥添加至Bitbucket，仓库URL改为git@bitbucket.org格式，Composer将自动通过系统SSH密钥认证；3. OAuth Token适合CI/CD场景，创建启用相应权限的OAuth consumer后，用access token配置bitbucket-oauth全局设置。建议开发用App Password，部署用SSH。

要在 Composer 中配置对 Bitbucket 私有仓库的访问，关键在于提供正确的认证方式，让 Composer 能够拉取受权限保护的代码库。Composer 支持使用 OAuth、App Passwords 或 SSH 方式连接 Bitbucket。以下是具体配置方法。

1. 使用 App Password（推荐方式）

Bitbucket 不直接支持个人密码访问 Git，但可以通过创建 App Password 实现安全认证。

步骤：

• 登录 Bitbucket 账户，进入“个人设置”（Personal Settings）
• 选择“App passwords” → “Create app password”
• 命名密码（如 composer-read），勾选“Repository: Read”权限
• 生成后复制该密码（只显示一次）

在项目的 composer.json 中添加仓库信息：

{     "repositories": [         {             "type": "vcs",             "url": "https://bitbucket.org/your-team/your-private-repo.git"         }     ] }

然后运行 composer require your-vendor/package-name，Composer 会提示输入用户名和密码：

• 用户名：你的 Bitbucket 用户名（不是邮箱）
• 密码：刚才生成的 App Password

为避免每次手动输入，可将凭证保存到 Composer 的全局配置中：

composer config --global http-basic.bitbucket.org username app-password

2. 使用 SSH 访问（适用于服务器环境）

如果你更习惯用 SSH，可以配置通过 SSH 克隆私有仓库。

确保你已在本地或服务器上生成 SSH 密钥，并将公钥添加到 Bitbucket 账户的“SSH keys”设置中。

有道小P

有道小P，新一代AI全科学习助手，在学习中遇到任何问题都可以问我。

64

查看详情

修改仓库 URL 为 SSH 格式：

{     "repositories": [         {             "type": "vcs",             "url": "git@bitbucket.org:your-team/your-private-repo.git"         }     ] }

Composer 会使用系统 SSH 配置自动认证，无需额外输入凭据。

3. 使用 OAuth Token（适合自动化流程）

Bitbucket Cloud 支持 OAuth，可用于 CI/CD 环境。

创建 OAuth consumer，启用“项目读取”和“仓库读取”权限，获取 token 后可在脚本中使用：

composer config --global bitbucket-oauth.bitbucket.org access-token-here

注意：此方式需在 Bitbucket 设置中启用 OAuth 并妥善保管 token。

基本上就这些。选择合适的方式后，Composer 就能正常访问你的私有 Bitbucket 仓库了。推荐开发环境用 App Password，部署环境用 SSH。