1. 为什么选择SSH而非HTTPS连接GitHub第一次接触GitHub时很多人会直接使用HTTPS协议克隆仓库。输入用户名密码就能操作看起来确实简单。但实际开发中SSH才是更专业的选择。我刚开始也图省事用HTTPS直到某次连续推送代码被要求反复输入密码才意识到问题的严重性。SSH协议通过密钥对实现身份验证就像给你的电脑配了把专属钥匙。每次连接GitHub时系统会自动核对密钥省去手动输入密码的麻烦。更关键的是SSH采用非对称加密数据传输全程被加密保护。去年有个朋友用HTTPS协议推送代码时因为公共WiFi不安全导致账号泄露这就是活生生的教训。具体来说SSH有三大优势免密操作配置成功后git pull/push等操作不再需要输入密码安全性高加密强度远超HTTPS有效防止中间人攻击稳定性强连接不易中断特别适合大型仓库的传输# HTTPS克隆需要每次输入密码 git clone https://github.com/user/repo.git # SSH克隆一次配置终身受用 git clone gitgithub.com:user/repo.git2. 生成SSH密钥对2.1 检查现有密钥在生成新密钥前建议先检查是否已有密钥。打开终端输入ls -al ~/.ssh如果看到id_rsa和id_rsa.pub这类文件说明已有密钥对。没有的话会显示No such file or directory。我就犯过重复生成的错误导致多个密钥互相冲突最后不得不全部删除重新配置。2.2 生成新密钥执行以下命令生成密钥对记得替换成你的GitHub邮箱ssh-keygen -t rsa -b 4096 -C your_emailexample.com这里解释下参数含义-t rsa指定密钥类型为RSA-b 4096设置密钥长度为4096位更安全-C添加注释方便识别接下来会提示保存位置直接回车用默认路径即可。然后会让你输入密码passphrase这是个额外保护层。我的建议是个人电脑可不设密码直接回车公共设备建议设置复杂密码# 典型生成过程示例 Generating public/private rsa key pair. Enter file in which to save the key (/home/ubuntu/.ssh/id_rsa): [回车] Enter passphrase (empty for no passphrase): [直接回车] Enter same passphrase again: [直接回车]2.3 密钥文件说明生成的密钥对默认存放在~/.ssh目录下id_rsa私钥文件相当于家门钥匙绝不能外泄id_rsa.pub公钥文件可公开类似钥匙编号重要安全提示曾经有开发者不小心把私钥上传到GitHub结果被人利用入侵了服务器。切记私钥权限应设为600不要通过任何方式分享私钥定期检查~/.ssh目录权限# 设置正确权限 chmod 600 ~/.ssh/id_rsa chmod 644 ~/.ssh/id_rsa.pub3. 将公钥添加到GitHub3.1 复制公钥内容在终端执行以下命令将公钥内容复制到剪贴板# 适用于Ubuntu桌面版 cat ~/.ssh/id_rsa.pub | xclip -selection clipboard # 如果没有xclip可以安装或者用传统方法 sudo apt install xclip # 先安装工具 gedit ~/.ssh/id_rsa.pub # 然后手动复制公钥内容类似这样ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC9... userexample.com复制时要注意确保复制完整内容从ssh-rsa到邮箱不要添加多余空格或换行如果使用vim查看注意不要在可视模式下漏掉首尾字符3.2 GitHub后台配置登录GitHub点击右上角头像 → Settings左侧选择SSH and GPG keys点击New SSH key绿色按钮填写信息Title给密钥起个识别名如My Ubuntu LaptopKey type保持默认Authentication KeyKey字段粘贴刚才复制的公钥内容注意添加密钥后GitHub可能会要求重新输入密码确认身份。这是正常的安全验证步骤。常见问题处理如果提示Key is already in use说明该公钥已被添加出现Invalid key错误通常是复制时漏了字符添加后依然连接失败可能需要检查密钥权限4. 测试SSH连接4.1 基本连接测试执行以下命令验证连接ssh -T gitgithub.com成功时会看到Hi username! Youve successfully authenticated...如果首次连接会询问是否信任主机指纹输入yes即可The authenticity of host github.com cant be established. Are you sure you want to continue connecting (yes/no)? yes4.2 解决连接问题当遇到Permission denied错误时可按以下步骤排查检查密钥加载ssh-add -l如果显示The agent has no identities需要手动添加ssh-add ~/.ssh/id_rsa验证密钥类型 GitHub已不再支持DSA等老旧密钥类型。可通过以下命令查看ssh-keygen -l -f ~/.ssh/id_rsa.pub正常应显示RSA 4096或ED25519检查配置文件 ~/.ssh/config文件配置错误也会导致问题。可以临时重命名该文件测试mv ~/.ssh/config ~/.ssh/config.bak5. 实际应用示例5.1 克隆现有仓库配置成功后克隆仓库时改用SSH地址git clone gitgithub.com:username/repository.git对比HTTPS方式SSH克隆有两个明显优势无需反复输入密码传输速度更快特别是大仓库5.2 修改现有仓库协议如果已经用HTTPS克隆了仓库可以修改远程地址git remote -v # 查看当前远程地址 git remote set-url origin gitgithub.com:username/repository.git我曾经维护的一个项目因为历史原因用了HTTPS每次推送都要输密码。改成SSH后效率提升明显特别是自动化部署时再也不用处理密码问题了。5.3 多账号配置对于需要管理多个GitHub账号的情况可以创建config文件# ~/.ssh/config 文件示例 Host github.com-personal HostName github.com User git IdentityFile ~/.ssh/id_rsa_personal Host github.com-work HostName github.com User git IdentityFile ~/.ssh/id_rsa_work使用时替换地址中的github.comgit clone gitgithub.com-personal:username/repo.git这种方案我用了两年多个人和工作项目完全隔离再也不用担心误操作。唯一需要注意的是克隆时要指定正确的host别名。