Git Bash 和 Pageant 中的 SSH 密钥：如何使用和故障排除
2024-03-11 15:12:38
Git Bash 和 Pageant 中的 SSH 密钥：使用和故障排除指南
简介
保护你的 Git 仓库免受未经授权的访问至关重要，SSH 密钥是实现这一目标的理想工具。在本指南中，我们将逐步介绍如何在 Git Bash 中配置和使用 SSH 密钥，并提供解决常见问题的故障排除提示。
生成 SSH 密钥对
首先，我们需要创建一个 SSH 密钥对。这是你的公钥和私钥的集合，其中公钥用于加密数据，而私钥用于解密数据。在 Git Bash 中，运行以下命令：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
按照提示指定密钥的存储位置和密码。
将公钥添加到 Pageant
Pageant 是一个密钥管理工具，将你的 SSH 公钥添加到 Pageant，以便 Git Bash 可以访问它们进行身份验证。
- 启动 Pageant。
- 右键单击 Pageant 图标并选择“添加密钥”。
- 浏览并选择存储在
~/.ssh/id_rsa.pub的公钥文件。 - 输入密钥密码。
将公钥添加到 Bitbucket
接下来，将公钥添加到你的 Bitbucket 帐户，这样 Bitbucket 就可以识别你的密钥并允许你访问你的仓库。
- 登录 Bitbucket 帐户。
- 导航到“设置”>“SSH 密钥”。
- 单击“添加密钥”。
- 从 Pageant 复制公钥并将其粘贴到文本框中。
- 单击“添加”。
配置 Git Bash 使用 SSH 代理
Git Bash 需要连接到 Pageant 中的密钥才能使用它们进行身份验证。让我们通过配置 Git Bash 来实现这一点。
- 在 Git Bash 终端中，运行以下命令：
eval "$(ssh-agent -s)"
- 运行
ssh-add命令将密钥添加到 SSH 代理：
ssh-add ~/.ssh/id_rsa
- 输入密钥密码。
故障排除：Permission denied (publickey)
如果你遇到这个错误，可能是以下原因造成的：
- SSH 密钥未正确添加到 Pageant 或 Bitbucket。
- Git Bash 未配置为使用 SSH 代理。
- 你尝试访问的仓库不是你的。
解决步骤：
- 检查你的密钥是否已添加到 Pageant 和 Bitbucket。
- 确保存码 Git Bash 已配置为使用 SSH 代理。
- 确认你有权访问目标仓库。
如果问题仍然存在：
- 重新启动 Pageant 和 Git Bash。
- 生成新的 SSH 密钥对并重试。
- 联系 Bitbucket 支持以寻求帮助。
常见问题解答
1. 为什么使用 SSH 密钥？
SSH 密钥提供了比使用用户名和密码更安全的身份验证方法，因为它们很难伪造或窃取。
2. Pageant 的作用是什么？
Pageant 是一个密钥管理工具，存储和管理你的 SSH 密钥，使你可以在不同设备和应用程序中轻松使用它们。
3. 如果我丢失了 SSH 私钥怎么办？
丢失 SSH 私钥会导致你无法访问使用该私钥加密的任何数据。因此，请妥善保管你的私钥并考虑创建备份。
4. 可以有多个 SSH 密钥吗？
是的，你可以拥有多个 SSH 密钥。例如，你可以在不同的设备上使用不同的密钥，或者为不同的帐户使用不同的密钥。
5. 如何查看我的 SSH 密钥？
在 Git Bash 终端中，运行以下命令：
cat ~/.ssh/id_rsa.pub
