生成SSH密钥并添加公钥到Git服务，确保ssh-agent加载私钥；2. 在composer.json中用git@格式的SSH地址定义私有仓库；3. 确保私钥权限为600且能手动git clone；4. CI/CD中配置部署密钥并设置known_hosts。
要在 Composer 中为私有包配置 SSH 密钥认证，关键是让 Git 能通过 SSH 正确拉取代码，Composer 本身不直接管理密钥，而是依赖系统或 Git 的 SSH 配置。以下是具体操作步骤。
1. 生成并配置 SSH 密钥
如果还没有为私有仓库服务（如 GitHub、GitLab 或自建 Git 服务器）配置 SSH 密钥，先生成一对：
ssh-keygen -t ed25519 -C "your_email@example.com"保存路径可以使用默认值，会生成 id_ed25519 和 id_ed25519.pub。将公钥（.pub 文件内容）添加到你的 Git 服务账户的 SSH Keys 设置中。
确保 SSH agent 正在运行并已加载私钥：
eval $(ssh-agent -s)ssh-add ~/.ssh/id_ed25519
2. 使用 SSH 协议定义仓库
在项目的 composer.json 中添加私有包的仓库，并使用 SSH 格式的 Git 地址：
{ "repositories": [ { "type": "vcs", "url": "git@github.com:username/private-package.git" } ], "require": { "username/private-package": "dev-main" } }
注意：git@... 是 SSH 协议格式，不能使用 HTTPS 地址。
3. 确保 SSH 可自动认证
Composer 执行时会调用 Git，Git 再通过 SSH 拉取代码。必须保证以下几点：
- SSH 私钥文件权限正确（chmod 600 ~/.ssh/id_ed25519）
- SSH config 文件（~/.ssh/config）可选配置主机别名或指定密钥
- 测试是否能手动克隆：git clone git@github.com:username/private-package.git
4. 在 CI/CD 或服务器上配置密钥
在非交互环境（如部署服务器或 CI）中，需要设置部署密钥或机器用户密钥：
- 生成专用密钥对，将公钥添加为仓库的“Deploy Key”
- 在 CI 中注入私钥（如 GitHub Secrets），写入 ~/.ssh/id_ed25519 并设置权限
- 确保 SSH known_hosts 包含目标主机指纹，避免首次连接确认
基本上就这些。只要 Git 能通过 SSH 免密拉取，Composer 就能正常安装私有包。
