蛙扑下载站:安全、绿色、放心的专业下载站! 首页|最近更新|专题集合|站内导航

Git SSH配置与使用完整教程

时间:2026-09-24 22:06:07 来源:www.vaopo.com 人气:人

为什么推荐用SSH代替HTTPS

平时我们用Git拉取或推送代码时,默认走的是HTTPS协议。这种方式虽然直观,但每次操作都需要手动输入账号和密码,不仅打断开发节奏,在自动化部署脚本里也极易因为密码过期而中断。换成SSH协议后,只需要一次性配置好密钥对,之后所有交互都会自动完成身份验证。这种方式不仅免去了反复输密码的烦恼,而且加密强度更高,传输过程不容易被中间人劫持,是专业开发者的标配做法。

第一步检查本地是否已有密钥

在动手配置之前,先确认电脑里是否已经存在现成的SSH密钥。打开系统的终端或命令行窗口,运行查看系统用户目录的命令。重点留意隐藏的.ssh文件夹,点进去看里面有没有id_rsa.pub或者id_ed25519.pub这类以pub结尾的文件。如果找到了对应的公钥文件,可以直接跳过生成步骤,去提取内容绑定平台。如果目录下空空如也,那就说明需要从零开始创建一对新的密钥。

第二步生成全新的SSH密钥对

目前主流的代码托管平台都强烈建议采用Ed25519算法,它的加密效率比老式的RSA更高,生成的文件也更轻量。在终端输入生成指令,务必把参数换成你自己的常用邮箱,方便日后排查归属问题。执行过程中会询问保存路径,直接按下回车键接受默认路径最为稳妥。紧接着系统会要求设置密码短语,这一步千万别偷懒,填入复杂的自定义密码并再次确认。带上密码保护的私钥能有效防止设备丢失后密钥被恶意盗用。

第三步将公钥添加到代码托管平台

密钥生成完毕后,下一步是把公钥上传到服务器端认账。在终端输入查看公钥内容的命令,系统会把一串乱码似的字符打印出来。用鼠标全选并复制这段文本。随后登录你的GitHub、GitLab或Gitee账户,依次进入设置页面找到SSH Keys管理入口。点击新建按钮,给这次绑定的设备起个容易记住的名称,把刚才复制的长字符串完整粘贴进大文本框,最后点击保存。平台收到数据后会立刻解析并记录你的公钥指纹。

第四步测试连接是否真正打通

上传公钥只是完成了服务端准备,客户端还需要验证握手能否成功。切回终端窗口,输入针对具体平台的连通性测试命令。首次连接陌生服务器时,终端会弹出警告询问是否继续,输入yes并回车确认。等待几秒后,如果界面顺利打印出欢迎语以及你的用户名,没有任何报错提示,就证明安全通道已经完全建立。此时你可以尝试拉取一个公开仓库,体验一下无需密码的流畅操作。

第五步把现有仓库切换成SSH地址

对于以前已经克隆下来的项目,如果想改走SSH通道,操作非常直接。进入项目根目录打开终端,运行命令查看当前绑定的远程仓库地址。拿到那串https开头的链接后,直接将其替换为对应项目的ssh格式链接。替换成功后,后续的fetch和push动作都会自动匹配新的认证方式。如果是新建项目,建议在初始化克隆阶段就直接选用ssh模板,省去二次修改的麻烦。

常见问题与日常维护建议

配置过程中最容易踩的坑就是权限报错。Linux和macOS系统对私钥文件的读写权限极其敏感,必须严格设置为仅所有者可读写。如果发现推代码失败,可以运行修正权限的命令来恢复。Windows系统通常会自动处理权限,较少出现此类干扰。另外要注意复制公钥时绝对不允许有多余的空格或换行符,否则平台校验会直接失败。如果更换了新电脑或重装了系统,必须在新环境重新生成密钥并同步到云端。保持密钥定期轮换,配合良好的保管习惯,能让版本控制流程一直稳定高效运行。