Deployer配置SSH部署密钥后Git克隆报仓库不存在/退出码128
Deployer 部署Git拉取报错排查指南
针对你遇到的Repository not found、ssh -A -tt执行失败、退出码128的问题,结合你已完成的配置,按以下顺序排查即可定位解决:
- 关闭Deployer默认的SSH代理转发逻辑。Deployer默认开启
ssh -A代理转发模式,会将你本地机器的SSH密钥优先转发到远程服务器,直接覆盖你在配置里指定的服务器本地私钥,导致Git认证时用了错误的密钥身份,出现仓库找不到的报错。在主机配置里添加->forwardAgent(false),强制Deployer在服务器执行Git操作时使用你指定的form_simple_id_rsa私钥,不启用本地密钥转发。 - 验证root用户的实际Git克隆权限。你之前测试的SSH连接正常,大多是验证本地到服务器的登录链路,没有检查服务器上root用户(Deployer配置的部署用户)实际克隆目标仓库的能力:
- 切换到服务器的root用户
- 手动执行
git clone git@github.com:company/project.git /tmp/test_clone - 如果这一步就报仓库找不到,说明问题不在Deployer,而在服务器root用户的多密钥匹配逻辑:因为服务器上存在多把SSH密钥,SSH默认会按顺序挨个尝试认证,Deployer执行非交互式任务时,不会加载你之前手动
ssh-add到当前交互shell的agent私钥,导致SSH匹配到了其他不具备权限的密钥完成认证,自然拉不到仓库。
对应修复:给root用户的~/.ssh/config添加GitHub专属配置,明确密钥匹配规则:
重点是添加Host github.com HostName github.com User git IdentityFile ~/.ssh/form_simple_id_rsa IdentitiesOnly yesIdentitiesOnly yes,强制SSH只使用指定的这把密钥,不要尝试发送所有密钥挨个认证,避免多密钥场景下的身份匹配错误。 - 强制Deployer执行Git命令时使用指定私钥。为了避免依赖系统SSH的配置匹配逻辑,可以在主机配置里添加专属Git SSH参数:
这样所有Git拉取、更新操作都会直接调用指定的私钥,不受系统环境变化影响。->set('git_ssh_command', 'ssh -i ~/.ssh/form_simple_id_rsa -o IdentitiesOnly=yes') - 核对GitHub部署密钥的添加位置。你提到仓库是团队所有、你是协作者,要注意:如果把
form_simple_id_rsa.pub加到了你的个人账号SSH密钥列表里、而不是对应团队仓库的Deploy Keys板块,一旦你的个人协作者权限被调整、或者部署密钥设置了权限限制,就会出现能成功SSH认证到GitHub、但读取不到目标仓库的报错,提示信息和“仓库不存在”完全一致。
验证方式:在服务器root用户下执行ssh -T git@github.com,查看返回的认证身份和权限提示,确认当前使用的密钥对应的身份,是否真的绑定了目标团队仓库的访问权限。 - 关闭伪终端分配解决
ssh -tt执行失败的问题。Deployer默认开启ssh -tt强制分配伪终端,在很多非交互的服务器执行环境下,伪终端创建失败会直接返回退出码128,在主机配置里添加->set('ssh_pty', false),关闭伪终端分配即可解决这类执行中断问题。
内容的提问来源于stack exchange,提问作者Ryan H
相关产品推荐
相关产品推荐

