composer提示“Could not read from remote repository”的SSH密钥配置方法

首先检查并生成SSH密钥，确保SSH agent运行且密钥已添加，将公钥配置到GitHub/GitLab/Gitee账户，测试SSH连接成功后，在composer.json中使用SSH格式URL，并清除Composer缓存以拉取私有包。

当你在使用 Composer 安装私有包时遇到 "Could not read from remote repository" 错误，通常是因为 SSH 密钥未正确配置，导致无法通过 SSH 访问 Git 仓库（如 GitHub、GitLab 或 Gitee）。以下是解决该问题的完整步骤。

检查本地是否已有 SSH 密钥

打开终端，运行以下命令查看是否已生成过 SSH 密钥：

ls -al ~/.ssh

如果看到 id_rsa 和 id_rsa.pub（或 id_ed25519 等），说明已有密钥。如果没有，继续下一步生成。

生成新的 SSH 密钥

运行以下命令生成一个新的 SSH 密钥（替换为你自己的邮箱）：

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

按提示操作，推荐设置一个密码（可选），密钥将保存在 ~/.ssh/id_rsa。

启动 SSH Agent 并添加密钥

确保 SSH agent 正在运行，并将私钥添加进去：

eval $(ssh-agent -s)
ssh-add ~/.ssh/id_rsa

如果你的私钥文件名不同（如 id_ed25519），请对应修改路径。

将公钥添加到 Git 服务

复制公钥内容：

cat ~/.ssh/id_rsa.pub

全选输出内容并复制。然后登录你的 Git 服务（GitHub/GitLab/Gitee）：

OmniAudio

OmniAudio 是一款通过 AI 支持将网页、Word 文档、Gmail 内容、文本片段、视频音频文件都转换为音频播客，并生成可在常见 Podcast ap

111

查看详情

• GitHub: Settings → SSH and GPG keys → New SSH key
• GitLab: Preferences → SSH Keys
• Gitee: 设置 → SSH 公钥

粘贴公钥并保存。

测试 SSH 连接

运行以下命令测试是否能连接成功：

ssh -T git@github.com
ssh -T git@gitlab.com
ssh -T git@gitee.com

首次连接会提示确认，输入 yes。如果看到类似 "Hi username! You've successfully authenticated..." 的消息，说明配置成功。

确保 Composer 使用 SSH 地址

检查 composer.json 中的仓库配置，确保使用的是 SSH 格式的 URL：

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

不能使用 https 形式：https://github.com/username/private-repo.git，否则仍会失败。

清除 Composer 缓存（必要时）

如果之前克隆失败，Composer 可能缓存了错误状态。清除缓存再试：

composer clear-cache
composer install

基本上就这些。只要 SSH 密钥正确生成、添加到代理、并注册到 Git 服务，Composer 就能顺利通过 SSH 拉取私有仓库。不复杂但容易忽略细节。

以上就是composer提示“Could not read from remote repository”的SSH密钥配置方法的详细内容，更多请关注php中文网其它相关文章！