为什么选择ssh连接
平时用git推代码,很多人习惯输入账号密码。每次都要输一遍确实麻烦,而且容易输错。改用ssh协议后,只需要一次性配置好密钥,以后克隆和推送代码就不需要再验证身份了。ssh不仅更安全,还能省去重复输入的麻烦,是开发者的标配操作。它通过非对称加密技术建立安全通道,数据传输过程不会被第三方窃取,非常适合长期协作的项目环境。
检查本地是否已有密钥
在动手生成新密钥之前,先看看电脑里是不是已经装好了旧钥匙。打开终端或者命令行工具,输入命令查看默认路径下的文件。如果提示找不到文件,说明你还没配过,可以直接跳到下一步。如果找到了叫id_rsa或者id_ed25519的文件,说明系统里已经有现成的密钥,可以跳过生成环节,直接把公钥加到远程平台就行。建议顺手备份一下旧密钥,防止误删导致其他项目无法拉取。
生成新的ssh密钥对
没有旧密钥的话,就用命令行工具生成一对。推荐用ed25519算法,比传统的rsa更短更快,安全性也更高。输入生成命令时,系统会问你要不要设置密码短语。直接回车留空就行,这样后面推代码不会弹窗让你输密码。生成过程中它会显示一个随机画板,随便敲敲键盘就能加快进度。完成后去对应的文件夹里找找,后缀带.pub的就是公钥,必须把它交出去,而带私钥后缀的文件绝对要保密。
把公钥添加到代码托管平台
公钥就像一把公开的锁,谁都能拿到,但只有对应的私钥才能开门。打开你的github或者gitlab后台,找到账户设置里的ssh密钥管理页面。点击新增按钮,给密钥起个名字方便以后辨认,然后把刚才生成的公钥内容完整粘贴进去。注意别漏掉开头的ssh开头和结尾的用户名,整行复制最稳妥。保存之后,平台就认识这台电脑了。如果是企业自建服务器,通常还需要找运维同事把公钥加到authorized_keys文件里。
修改仓库的远程地址
很多老项目一开始用的是https链接,配好ssh密钥后得把地址换掉。在项目根目录运行查看远程地址的命令,确认当前用的是https。然后执行替换命令,把原来的网址改成ssh格式的。语法很简单,就是把前面的https换成git@,中间加上平台域名,最后保留用户名和仓库名。改完之后下次拉取推送都会走ssh通道。如果不想全局改,也可以单独针对某个分支调整,灵活控制传输方式。
测试连通性
所有步骤做完,最后得验证一下到底通不通。在终端输入连接测试命令,第一次访问时会弹出一个指纹确认提示。直接输入yes并回车即可,系统会自动把这个平台加入信任列表。看到欢迎界面和端口号说明配置彻底成功。如果报错说权限拒绝,通常是公钥没粘贴全,或者远程地址还没切到ssh模式,回去核对两遍就能解决。连续失败三次以上记得清一下ssh缓存再试。
日常维护与排错
换了新电脑或者重装系统后,记得重新生成密钥并绑定到平台。如果多个项目混用,可以在用户目录下新建配置文件,为不同主机指定不同的密钥文件,避免冲突。遇到连不上的情况,先检查防火墙有没有拦截两千二号端口,再跑一遍诊断命令看具体卡在哪一步。保持密钥定期轮换也是好习惯,尤其是团队多人协作的时候,及时移除离职成员的密钥能防止安全隐患。掌握这些基础操作,以后玩git就会顺畅得多。



