SSH Key 配置 GitHub / GitLab 完整指南:从生成到多账号管理

SSH Key 看起来是很基础的东西,但真正到多台电脑、多平台、多账号同时存在时,问题一点都不少。公钥传错、权限不对、known_hosts 冲突、config 没写清,都会让看似简单的 clone / push 变得麻烦。

先分清 id_rsa、id_ed25519 和 config 的作用

公私钥本身只是凭证,真正决定你连接哪个平台、用哪把钥匙的是 ssh config。很多人生成了多把 key,却没有写 Host 别名和 IdentityFile,最终还是靠默认 key 去连所有仓库,自然会乱。

多账号管理的关键不在平台,而在本机组织方式

如果你同时有个人 GitHub、公司 GitHub、GitLab 或自建 Git 服务,最稳妥的方式不是反复替换默认 key,而是为每类账号建立固定别名,并在 clone 时直接使用别名域名。这样仓库归属和身份会清楚很多。

连接失败时最先看哪里

先看本地 ~/.ssh/config 是否生效,再用 ssh -T 或 ssh -v 观察实际使用了哪把 key。如果一上来就去网页里重新上传公钥,往往是在错方向上排查。

作者说明

长期维护小型网站和服务器,关注真正能解决问题的技术教程、部署经验与排障方法。