现象:仓库地址没错,就是推不上去
本地提交都正常,执行 git push 时终端输出 git@github.com: Permission denied (publickey). fatal: Could not read from remote repository。换成别人电脑同样的仓库地址就能推,说明不是权限或仓库配置的问题。
原因:SSH 这一层没认出来
- 本机没有密钥,或者生成在别的用户目录下,比如用 root 操作但密钥在普通用户里。
- 密钥没加载进 ssh-agent,每次连接都找不到可用的身份。
- 公钥没上传,或者复制时漏了开头结尾,平台侧校验不通过。
- 22 端口不通,网络层直接超时,报错却被误读成鉴权失败。
- 同一台机器上有多把密钥,SSH 拿错了那把。
解决步骤
第一步,打开详细日志看它到底在试哪个密钥:
ssh -vT git@github.com
ssh-add -l
日志里出现 Offering public key 但随后被拒,说明密钥存在但服务端不认;如果一行都没有,说明本机压根没找到密钥。
第二步,生成并加载密钥,然后确认公钥内容完整:
ssh-keygen -t ed25519 -C "you@example.com"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub
第三步,把公钥贴到代码平台,内容从 ssh-ed25519 开头到邮箱结尾,一行不能断。
第四步,用配置文件指定身份,多密钥场景避免拿错:
Host github.com
HostName ssh.github.com
Port 443
User git
IdentityFile ~/.ssh/id_ed25519
顺带把端口改成 443,能绕开 22 端口被限制的网络。
第五步,检查权限。私钥必须是 600,目录 700,权限过宽 SSH 会直接忽略这个文件,且日志里只给一句含糊的提示。
小结
先用 ssh -vT 判断是"没找到密钥"还是"服务端拒绝",再决定是补公钥还是加配置。多密钥环境建议统一写在 Config 里,比临时敲命令可靠。
另外两个常见误判:一是地址栏里的 remote 用的是 https 而不是 git@,这种情况下 SSH 密钥根本不参与鉴权,报的是账号密码错误,用 git remote -v 先确认协议;二是首次连接时的 Are you sure you want to continue connecting 提示,在脚本里被自动拒绝后同样表现为 publickey 失败,检查 known_hosts 里是否已有对应记录。把这两点排除掉,剩下的基本就是密钥本身的问题。
