如何在 Windows 上为 Bitbucket 设置 SSH 密钥

已编辑 2 几个月前 通过 ExtremeHow 编辑团队

Bitbucket代码托管视窗SSH 密钥安全认证设置Git版本控制版本控制开发软件

在 Windows 操作系统上为 Bitbucket 设置 SSH 密钥可以增强 Git 工作流程的安全性和效率。使用 SSH 密钥进行身份验证，不需要每次从仓库推送或拉取代码时输入密码。

了解 SSH 密钥

SSH（Secure Shell）是一种用于在不安全网络上安全访问网络服务的协议。SSH 密钥通过使用一对加密密钥认证您的设备与远程服务器，提供了一种比密码更安全的替代方案。

SSH 密钥对包含两个密钥：一个公钥和一个私钥。公钥可以安全地与他人共享。私钥则保存在您的计算机上，保持安全和机密。当您尝试使用密钥访问 Bitbucket 时，它通过检查您的私钥与您 Bitbucket 帐户中注册的公钥之间的匹配来验证您的身份。

先决条件

在设置 SSH 密钥之前，请确保您的系统满足以下要求：

• 运行 Windows 操作系统。
• 安装了 Git 版本，包括可执行 Git 命令的命令行界面 Git Bash。
• 一个 Bitbucket 帐户用以存储您的仓库。

分步指南

步骤 1：生成 SSH 密钥

在 Windows 计算机上生成 SSH 密钥对，请按照以下步骤操作：

1. 打开计算机上的 Git Bash 应用程序。您可以在“开始”菜单中找到它，或使用 Windows 搜索进行搜索。

2. 输入以下命令以创建新的 SSH 密钥对：

   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

   替换 "your_email@example.com" 为您的实际邮箱地址。

3. 输入命令后，将要求您指定一个位置来保存生成的密钥。默认情况下，密钥保存在 /c/Users/YourUser/.ssh/id_rsa 中。您可以按 Enter 键接受默认位置，也可以选择自定义路径。

4. 接下来，将要求您输入一个密码短语。密码短语为您的 SSH 密钥增加了一个额外的安全层。强烈建议设置它，但您可以在不设置密码短语的情况下留空。输入您的密码短语并按 Enter，或直接按 Enter 以在没有密码短语的情况下继续。

成功执行这些步骤后，将创建两个密钥：一个名为 id_rsa 的私钥和一个名为 id_rsa.pub 的公钥。私钥应始终保持安全且不予分享，而公钥将在下一步中使用。

步骤 2：将 SSH 密钥添加到 Bitbucket

当公钥准备好后，便可以将其添加到您的 Bitbucket 帐户中以启用身份验证：

1. 首先，需要复制 id_rsa.pub 文件的内容。打开 Git Bash 并输入以下命令以显示密钥：

   cat ~/.ssh/id_rsa.pub

   选择 Git Bash 中显示的整个密钥输出，右键点击以复制。

2. 使用您的网络浏览器登录到 Bitbucket 帐户。

3. 在右上角，点击您的头像图标，然后从下拉菜单中选择 Bitbucket 设置。

4. 在左侧菜单中，找到 SSH 密钥，位于安全部分下，点击进入。

5. 点击添加密钥按钮以打开一个需要密钥标签及之前复制的密钥的提示。

6. 输入描述密钥的标签，例如 我的 Windows PC。将公钥粘贴到标记为 密钥 的文本框中。

7. 最后，保存更改。您的 SSH 密钥现在已与 Bitbucket 帐户关联！

步骤 3：验证 SSH 设置

将 SSH 密钥添加到 Bitbucket 后，建议验证 SSH 设置。这可确保您的系统已正确配置，并且 SSH 身份验证将正常工作：

1. 进入 Git Bash，输入以下命令以开始与 Bitbucket 的 SSH 连接：

   ssh -T git@bitbucket.org

2. 如果您是第一次连接，您可能会看到有关 Bitbucket 真实性的消息。输入 yes 然后按 Enter 继续。

3. 如果 SSH 配置正确，您将看到确认您连接的欢迎消息。这一状态表明您的 SSH 密钥已成功设置并准备使用。

管理多个 SSH 密钥

如果您有不同的 Bitbucket 帐户或需要从不同设备访问，可以管理多个 SSH 密钥。以下是一份简单的指南：

1. 使用相同的 ssh-keygen 命令生成额外的 SSH 密钥对，并使用不同的文件名保存它们。

2. 对于每个密钥，在 .ssh 目录中创建一个配置文件。

   touch ~/.ssh/config

   使用文本编辑器（如记事本）编辑 config 文件，以指定针对不同帐户或系统使用的私钥：

   Host bitbucket-account1
       HostName bitbucket.org
       User git
       IdentityFile ~/.ssh/id_rsa_account1
   
   Host bitbucket-account2
       HostName bitbucket.org
       User git
       IdentityFile ~/.ssh/id_rsa_account2

3. 确保用对应的密钥文件位置替换 IdentityFile 字段。

安全注意事项

保持 SSH 私钥安全非常重要，因为拥有这些密钥即可以访问您的 Bitbucket 仓库。为了确保密钥的安全性，请考虑以下方法：

• 切勿与他人分享您的私钥。保持其在计算机上的安全与私密。
• 创建 SSH 密钥时使用密码短语，以增加安全性。
• 定期审查并管理您在 Bitbucket 帐户上的 SSH 密钥。删除任何不再使用的密钥。
• 备份您的私钥文件以便恢复，将它们存放在安全的地方。

解决 SSH 问题

如果在设置 SSH 时遇到问题，请尝试以下故障排除步骤：

1. 确保 ssh-agent 正在运行并且密钥已加载。您可以通过以下命令启动代理并加载密钥：

   eval $(ssh-agent -s)
   ssh-add ~/.ssh/id_rsa

2. 验证您在 Bitbucket 中的公钥是否正确。拼写错误可能会导致身份验证问题。

3. 检查 .ssh 目录和密钥文件的文件权限。私钥不应具有除所有者外的任何人可读/写权限。

4. 检查 SSH 日志，以发现可能的错误消息或诊断详细信息：

   ssh -vT git@bitbucket.org

   -v 标志启用详细模式，提供有关连接尝试的更多信息。

结论

在 Windows 上为 Bitbucket 设置 SSH 密钥是一个简单的任务。通过利用 SSH，您可以建立一个安全的、无密码的身份验证系统，以有效地管理您的 Git 仓库。记得保持安全最佳实践并定期管理您的 SSH 密钥，以维护安全的开发环境。通过正确的配置，您的编码工作流程将变得既无缝又安全。

  分享本文

如果你发现文章内容有误, 您可以 请求更新