用 SSH Key 连接 GitHub、GitLab 和 Bitbucket
用 SSH Key 连接 GitHub、GitLab 和 Bitbucket：安全高效的 Git 协作
在现代软件开发中，版本控制系统 Git 已经成为不可或缺的工具。而 GitHub、GitLab 和 Bitbucket 作为主流的 Git 代码托管平台，为开发者提供了强大的协作和代码管理功能。为了确保与这些平台的安全高效交互，使用 SSH Key 进行身份验证是最佳实践。本文将详细介绍如何生成 SSH Key，以及如何在 GitHub、GitLab 和 Bitbucket 上配置 SSH Key，实现免密登录和安全可靠的代码推送与拉取。
一、理解 SSH Key 的工作原理
SSH Key 是一种非对称加密方式，它使用一对密钥：公钥和私钥。私钥保存在你的本地计算机上，绝不能泄露给他人。公钥则可以公开分享，上传到 Git 代码托管平台。
当你尝试连接到 Git 服务器时，服务器会向你的客户端发送一个随机字符串。客户端使用私钥对这个字符串进行加密，并将加密后的结果发送回服务器。服务器使用你预先上传的公钥对接收到的加密字符串进行解密。如果解密成功，则证明你拥有对应的私钥，从而验证你的身份并允许你进行操作。
这种机制避免了每次连接都需要输入用户名和密码，提高了效率和安全性，同时有效防止了密码被窃取的风险。
二、生成 SSH Key
- 检查现有密钥: 在生成新的 SSH Key 之前，最好先检查一下你的计算机上是否已经存在 SSH Key。打开终端或命令提示符，输入以下命令：
bash
ls -al ~/.ssh
如果看到 id_rsa 和 id_rsa.pub 文件，则表示你已经拥有一个 RSA 密钥对。如果看到 id_ed25519 和 id_ed25519.pub 文件，则表示你拥有一个 Ed25519 密钥对。Ed25519 算法更加现代和安全，建议优先使用。
- 生成新的 SSH Key: 如果没有找到现有的密钥，或者你想创建一个新的密钥，可以使用
ssh-keygen命令。推荐使用 Ed25519 算法：
bash
ssh-keygen -t ed25519 -C "[email protected]"
将 [email protected] 替换为你的邮箱地址。系统会提示你输入密钥文件的保存路径和密码。可以直接按 Enter 键使用默认路径（~/.ssh/id_ed25519）和空密码。
如果坚持使用 RSA 算法，可以使用以下命令：
bash
ssh-keygen -t rsa -b 4096 -C "[email protected]"
- 查看公钥: 生成密钥后，使用以下命令查看公钥内容：
bash
cat ~/.ssh/id_ed25519.pub
或者：
bash
cat ~/.ssh/id_rsa.pub
将输出的公钥内容复制下来，用于下一步在 Git 代码托管平台上进行配置。
三、在 GitHub 上配置 SSH Key
- 登录 GitHub 账号，点击右上角头像，选择 "Settings"。
- 在左侧菜单中选择 "SSH and GPG keys"。
- 点击 "New SSH key" 按钮。
- 在 "Title" 字段中输入一个描述性的名称，例如 "My Home Computer"。
- 在 "Key" 字段中粘贴你之前复制的公钥内容。
- 点击 "Add SSH key" 按钮保存。
四、在 GitLab 上配置 SSH Key
- 登录 GitLab 账号，点击右上角头像，选择 "Settings"。
- 在左侧菜单中选择 "SSH Keys"。
- 在 "Key" 字段中粘贴你之前复制的公钥内容。
- 在 "Title" 字段中输入一个描述性的名称，例如 "My Work Laptop"。
- 点击 "Add key" 按钮保存。
五、在 Bitbucket 上配置 SSH Key
- 登录 Bitbucket 账号，点击左下角头像，选择 "Personal settings"。
- 在左侧菜单中选择 "Security"，然后选择 "SSH keys"。
- 点击 "Add key" 按钮。
- 在 "Label" 字段中输入一个描述性的名称，例如 "My Desktop"。
- 在 "Key" 字段中粘贴你之前复制的公钥内容。
- 点击 "Add key" 按钮保存。
六、测试 SSH 连接
配置完成后，可以使用以下命令测试 SSH 连接是否成功：
- GitHub:
ssh -T [email protected] - GitLab:
ssh -T [email protected] - Bitbucket:
ssh -T [email protected]
如果看到类似 "Hi username! You've successfully authenticated, but GitHub/GitLab/Bitbucket does not provide shell access." 的消息，则表示 SSH 连接配置成功。
七、使用 SSH Key 克隆和推送代码
配置 SSH Key 后，可以使用 SSH 协议克隆代码仓库：
bash
git clone [email protected]:username/repository.git
或者：
bash
git clone [email protected]:username/repository.git
或者：
bash
git clone [email protected]:username/repository.git
之后，你就可以使用 Git 命令进行代码的推送和拉取，无需再次输入用户名和密码。
八、SSH Agent 转发
如果你需要通过一台服务器访问其他的 Git 服务器，可以使用 SSH Agent 转发功能。 SSH Agent 是一个后台程序，可以缓存你的 SSH Key 的解锁状态，从而避免在每次连接都需要输入密码。
- 启动 SSH Agent:
bash
eval "$(ssh-agent -s)"
- 添加 SSH Key 到 Agent:
bash
ssh-add ~/.ssh/id_ed25519
或者:
bash
ssh-add ~/.ssh/id_rsa
- 在 SSH 配置文件中启用 Agent 转发: 编辑
~/.ssh/config文件 (如果不存在则创建)，添加以下内容：
Host *
ForwardAgent yes
这样，当你通过 SSH 连接到另一台服务器时，你的 SSH Key 也会被转发到该服务器， allowing you to access other Git repositories without entering your password again.
九、安全注意事项
- 保护你的私钥: 私钥是你访问 Git 服务器的凭证，务必妥善保管，不要泄露给他人。
- 使用强密码: 如果你在生成 SSH Key 时设置了密码，请使用强密码，并妥善保管。
- 定期检查 SSH Key: 定期检查你添加到 Git 代码托管平台的 SSH Key，确保没有未经授权的密钥。
通过以上步骤，你可以成功地使用 SSH Key 连接 GitHub、GitLab 和 Bitbucket，实现安全高效的 Git 协作。 记住，SSH Key 是保障你的代码安全的重要工具，请务必重视并妥善管理。