1. 为什么需要Git免密登录每次推送代码都要输入密码这大概是开发者最讨厌的事情之一。我在团队协作项目中深有体会——频繁的密码输入不仅打断工作流在自动化场景下更是直接导致脚本中断。SSH密钥认证就是解决这个痛点的标准方案。传统HTTPS协议每次push都需要验证账号密码而SSH协议通过非对称加密实现身份认证。简单来说你本地生成一对密钥公钥私钥把公钥上传到Git服务端。之后每次连接服务端会用你上传的公钥来验证本地私钥的签名整个过程无需人工干预。提示虽然主流平台都推荐使用SSH但企业内网环境可能强制使用HTTPS。建议先确认所在团队的协议要求。2. 密钥对的生成与管理2.1 检查现有密钥首先打开终端Windows用户用Git Bash执行ls -al ~/.ssh如果看到id_rsa和id_rsa.pub等文件说明已有密钥。可以直接使用现有密钥但建议为不同平台创建独立密钥。2.2 生成新密钥运行以下命令替换邮箱为你的实际地址ssh-keygen -t ed25519 -C your_emailexample.com这里有几个关键点-t ed25519指定密钥算法比传统RSA更安全高效提示输入保存路径时建议修改为~/.ssh/github_ed25519这样的有意义的名称密码短语passphrase可以为空但建议设置并配合ssh-agent使用生成后查看公钥内容cat ~/.ssh/github_ed25519.pub你会看到类似这样的输出ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJu3wX... your_emailexample.com3. 配置Git平台公钥3.1 GitHub配置示例登录GitHub → Settings → SSH and GPG keys点击New SSH keyTitle填写识别名称如办公电脑Key type保持默认的Authentication Key将之前cat命令输出的内容完整粘贴到Key字段注意公钥内容必须完整且无多余空格建议用pbcopy ~/.ssh/github_ed25519.pubMac或clip ~/.ssh/github_ed25519.pubWindows直接复制到剪贴板。3.2 其他平台差异平台配置路径特殊要求GitLabProfile → SSH Keys支持多密钥自动识别BitbucketAccount settings → SSH keys需要单独配置仓库权限Gitee设置 → SSH公钥中文界面但流程相同4. 本地SSH配置优化4.1 多平台密钥管理当你有多个Git平台账户时需要创建~/.ssh/config文件Host github.com HostName github.com User git IdentityFile ~/.ssh/github_ed25519 IdentitiesOnly yes Host gitlab.company.com HostName gitlab.company.com User git IdentityFile ~/.ssh/company_ed255194.2 测试连接验证配置是否生效ssh -T gitgithub.com成功时会显示Hi username! Youve successfully authenticated...5. 常见问题排查5.1 权限问题SSH对文件权限非常严格确保chmod 700 ~/.ssh chmod 600 ~/.ssh/*5.2 连接超时如果出现Connection timed out检查网络是否限制SSH端口22尝试改用HTTPS端口Host github.com HostName ssh.github.com Port 4435.3 密钥被拒绝错误信息Permission denied (publickey)通常是因为公钥未正确上传到Git平台本地使用了错误的私钥文件SSH agent未加载密钥执行ssh-add ~/.ssh/your_key6. 进阶配置技巧6.1 使用ssh-agent管理密码如果密钥设置了passphrase可以启动ssh-agenteval $(ssh-agent -s) ssh-add ~/.ssh/github_ed25519建议将这两行加入shell的启动配置文件如.zshrc。6.2 VS Code集成配置在VS Code的settings.json中添加{ git.sshCommand: ssh -i ~/.ssh/github_ed25519 }6.3 临时切换协议对于已经用HTTPS克隆的仓库可以修改远程URLgit remote set-url origin gitgithub.com:user/repo.git我在团队中推行这套方案时发现90%的配置问题都源于以下三个原因公钥复制时漏掉开头/结尾字符.ssh目录权限设置不正确忘记在Git平台点击Add SSH key按钮有个小技巧用ssh -vT gitgithub.com查看详细连接过程输出信息能精准定位问题环节。比如看到Offering public key: /Users/you/.ssh/github_ed25519就说明密钥已被尝试使用而Authentication succeeded则确认验证通过。
1. 为什么需要Git免密登录每次推送代码都要输入密码这大概是开发者最讨厌的事情之一。我在团队协作项目中深有体会——频繁的密码输入不仅打断工作流在自动化场景下更是直接导致脚本中断。SSH密钥认证就是解决这个痛点的标准方案。传统HTTPS协议每次push都需要验证账号密码而SSH协议通过非对称加密实现身份认证。简单来说你本地生成一对密钥公钥私钥把公钥上传到Git服务端。之后每次连接服务端会用你上传的公钥来验证本地私钥的签名整个过程无需人工干预。提示虽然主流平台都推荐使用SSH但企业内网环境可能强制使用HTTPS。建议先确认所在团队的协议要求。2. 密钥对的生成与管理2.1 检查现有密钥首先打开终端Windows用户用Git Bash执行ls -al ~/.ssh如果看到id_rsa和id_rsa.pub等文件说明已有密钥。可以直接使用现有密钥但建议为不同平台创建独立密钥。2.2 生成新密钥运行以下命令替换邮箱为你的实际地址ssh-keygen -t ed25519 -C your_emailexample.com这里有几个关键点-t ed25519指定密钥算法比传统RSA更安全高效提示输入保存路径时建议修改为~/.ssh/github_ed25519这样的有意义的名称密码短语passphrase可以为空但建议设置并配合ssh-agent使用生成后查看公钥内容cat ~/.ssh/github_ed25519.pub你会看到类似这样的输出ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJu3wX... your_emailexample.com3. 配置Git平台公钥3.1 GitHub配置示例登录GitHub → Settings → SSH and GPG keys点击New SSH keyTitle填写识别名称如办公电脑Key type保持默认的Authentication Key将之前cat命令输出的内容完整粘贴到Key字段注意公钥内容必须完整且无多余空格建议用pbcopy ~/.ssh/github_ed25519.pubMac或clip ~/.ssh/github_ed25519.pubWindows直接复制到剪贴板。3.2 其他平台差异平台配置路径特殊要求GitLabProfile → SSH Keys支持多密钥自动识别BitbucketAccount settings → SSH keys需要单独配置仓库权限Gitee设置 → SSH公钥中文界面但流程相同4. 本地SSH配置优化4.1 多平台密钥管理当你有多个Git平台账户时需要创建~/.ssh/config文件Host github.com HostName github.com User git IdentityFile ~/.ssh/github_ed25519 IdentitiesOnly yes Host gitlab.company.com HostName gitlab.company.com User git IdentityFile ~/.ssh/company_ed255194.2 测试连接验证配置是否生效ssh -T gitgithub.com成功时会显示Hi username! Youve successfully authenticated...5. 常见问题排查5.1 权限问题SSH对文件权限非常严格确保chmod 700 ~/.ssh chmod 600 ~/.ssh/*5.2 连接超时如果出现Connection timed out检查网络是否限制SSH端口22尝试改用HTTPS端口Host github.com HostName ssh.github.com Port 4435.3 密钥被拒绝错误信息Permission denied (publickey)通常是因为公钥未正确上传到Git平台本地使用了错误的私钥文件SSH agent未加载密钥执行ssh-add ~/.ssh/your_key6. 进阶配置技巧6.1 使用ssh-agent管理密码如果密钥设置了passphrase可以启动ssh-agenteval $(ssh-agent -s) ssh-add ~/.ssh/github_ed25519建议将这两行加入shell的启动配置文件如.zshrc。6.2 VS Code集成配置在VS Code的settings.json中添加{ git.sshCommand: ssh -i ~/.ssh/github_ed25519 }6.3 临时切换协议对于已经用HTTPS克隆的仓库可以修改远程URLgit remote set-url origin gitgithub.com:user/repo.git我在团队中推行这套方案时发现90%的配置问题都源于以下三个原因公钥复制时漏掉开头/结尾字符.ssh目录权限设置不正确忘记在Git平台点击Add SSH key按钮有个小技巧用ssh -vT gitgithub.com查看详细连接过程输出信息能精准定位问题环节。比如看到Offering public key: /Users/you/.ssh/github_ed25519就说明密钥已被尝试使用而Authentication succeeded则确认验证通过。
