如何在Git中使用SSH连接远程仓库-git-PHP中文网

能用ssh连上远程仓库，前提是本地私钥、远程公钥、git远程地址三者对得上；缺一不可，错一个就提示permission denied (publickey)或连接超时。

如何在git中使用ssh连接远程仓库

能用 SSH 连上远程仓库，前提是本地私钥、远程公钥、Git 远程地址三者对得上；缺一不可，错一个就提示 Permission denied (publickey) 或连接超时。

私钥不是密码，不能“记住”或“共享”，必须由你本机生成：

ssh-keygen -t ed25519 -C "your_email@example.com" 是当前推荐方式（比 rsa 更快更安全）；若系统不支持 ed25519，再退回到 ssh-keygen -t rsa -b 4096
全程按回车使用默认路径 ~/.ssh/id_ed25519（Windows 是 C:\Users\用户名\.ssh\id_ed25519），避免路径空格或中文导致后续失效
不要设密码（passphrase）——除非你愿意每次 git push 都输一遍；设了就得配合 ssh-agent 启动并 ssh-add ~/.ssh/id_ed25519
生成后务必检查：运行 ls -l ~/.ssh/（Linux/macOS）或进文件夹看，确保 id_ed25519（私钥）权限是 -rw-------，否则 SSH 会直接拒绝加载

常见错误是只复制了中间一长串字符，漏掉开头的 ssh-ed25519 或结尾的邮箱注释；Gitee/GitHub/GitLab 都依赖这整行做校验：

使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...

下载

用命令复制最稳：cat ~/.ssh/id_ed25519.pub | clip（Windows Git Bash）或 pbcopy （macOS）
粘贴到 Gitee 的「SSH 公钥」页、GitHub 的「SSH and GPG keys」页时，Title 可随便写（如 work-laptop-win11），但 Key 内容必须原样
不要手动换行、删空格、加引号；如果看到 ssh-rsa AAAA... 开头却没结尾邮箱，说明复制不全

即使你已经配好密钥，只要 git remote -v 显示的是 https:// 地址，SSH 就完全不会被触发：

查看当前地址：git remote -v
替换成 SSH：git remote set-url origin git@gitee.com:yourname/yourrepo.git（Gitee）或 git remote set-url origin git@github.com:yourname/yourrepo.git（GitHub）
注意：GitHub 的 SSH 地址域名是 github.com，不是 ssh.github.com ——后者只在 22 端口被墙时才需通过 config 文件重定向，且要改 Port 443 和 Hostname ssh.github.com
测试是否生效：执行 ssh -T git@gitee.com，成功返回类似 Hi yourname! You've successfully authenticated... 才算通

很多连接失败不是密钥问题，而是 SSH 客户端根本没走到认证那步：

检查 ~/.ssh/config 是否存在且格式正确：Host 名必须和远程地址里的域名一致（Host gitee.com 对应 git@gitee.com），大小写敏感
执行 ssh -T -v git@gitee.com（加 -v 查看详细过程），重点看输出里有没有 debug1: Offering public key ——没有就说明密钥根本没被加载
Windows 上常见问题是 OpenSSH 服务未启用或被杀毒软件拦截；可临时关掉 Windows Defender 防火墙测试
公司网络有时会拦截 SSH 流量，此时 ssh -T 卡在 Connecting to... 就得换网络或走 HTTPS（非推荐）