Composer如何通过SSH协议拉取私有Git仓库-composer-PHP中文网

Composer如何通过SSH协议拉取私有Git仓库

尼克

发布： 2025-12-19 15:38:55

原创

574人浏览过

答案：Composer通过SSH拉取私有仓库需先配置SSH密钥，将公钥添加至Git服务，测试连接后在composer.json中使用SSH地址，最后执行composer install或update命令即可拉取。

composer如何通过ssh协议拉取私有git仓库

Composer 可以通过 SSH 协议 拉取私有 Git 仓库，前提是你的服务器或本地环境已配置好 SSH 密钥，并且远程 Git 服务（如 GitHub、GitLab、Gitee 等）已添加对应的公钥授权访问。

以下是具体实现步骤：

1. 生成并配置 SSH 密钥

确保你已在运行 Composer 的机器上生成了 SSH 密钥对（通常为 id_rsa 和 id_rsa.pub）：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

登录后复制

将生成的公钥（默认在 ~/.ssh/id_rsa.pub）内容复制并添加到你的 Git 服务账户中：

GitHub: Settings → SSH and GPG keys
GitLab: Preferences → SSH Keys
Gitee: 设置 → 安全设置 → SSH 公钥

测试连接是否成功：

ssh -T git@github.com
# 或
ssh -T git@gitlab.com

登录后复制

看到类似 “Welcome to GitLab” 表示配置成功。

2. 在 composer.json 中使用 SSH 地址

修改 composer.json 文件中的仓库地址，使用 SSH 格式的 Git URL：

{
    "repositories": [
        {
            "type": "vcs",
            "url": "git@github.com:username/private-repo.git"
        }
    ],
    "require": {
        "username/private-repo": "dev-main"
    }
}

登录后复制

注意：

Copysmith

Copysmith是一款面向企业的 AI 内容创建解决方案

168

查看详情

url 必须是 SSH 格式：git@host:username/repo.git
Composer 会自动识别该仓库为 Git 类型，并通过 SSH 拉取代码
分支名如 dev-main、dev-master 需与远程分支一致

3. 运行 Composer 命令

执行安装或更新命令时，Composer 会通过 SSH 自动拉取私有仓库：

composer install
# 或
composer update

登录后复制

如果未配置 SSH 密钥或权限不足，会提示克隆失败，例如：

fatal: Could not read from remote repository.

登录后复制

此时请检查 SSH 配置和网络连通性。

4. （可选）使用 SSH 别名简化主机管理

如果你管理多个 Git 服务或自建 Git 服务器，可在 ~/.ssh/config 中设置别名：

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_github
    IdentitiesOnly yes

登录后复制

这样可以指定不同项目使用不同的密钥。

基本上就这些。只要 SSH 通了，Composer 就能顺利拉取私有仓库。

以上就是Composer如何通过SSH协议拉取私有Git仓库的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

如何在Mac/Linux系统下全局安装Composer？（命令行教程）如何使用 Composer 来管理一个基于 WordPress 的 Headless CMS 项目？ Composer如何处理PHP版本不兼容的依赖问题如何为Composer创建一个命令行别名（alias）来简化操作？如何使用 composer exec 命令运行 vendor/bin 中的工具？