在 Windows 上自动加载 SSH 密钥 (PuTTY)

如果您使用 PuTTY 及其身份验证代理 (Pageant) 而不是 Windows 自带的 OpenSSH 客户端，请按照以下步骤操作。例如，如果您使用 SourceTree 作为 Git 客户端，它会自带 PuTTY（和 Pageant）来代替 OpenSSH。

开始之前

确保您已安装 PuTTY 套件，其中包含 Pageant。如果未安装，其下载链接可在 https://www.putty.org/ 获取。

检查您是否有任何现有的 SSH 密钥。请参阅 GitHub 文档文章 检查现有 SSH 密钥。

如果您没有 SSH 密钥

1. 使用 PuTTYgen 应用程序生成私钥/公钥对，并将其保存为私钥。请参阅 PuTTY 用户手册中的 使用 PuTTYgen，PuTTY 密钥生成器。
2. 按照 GitHub 文档文章 将新的 SSH 密钥添加到您的 GitHub 帐户，将新的 SSH 密钥添加到您的 GitHub 帐户。

过程

按照以下步骤在 Windows 上自动加载密钥和密码

1. 从 PuTTY 文件夹启动 Pageant：开始菜单 > 所有程序 > PuTTY > Pageant
2. 在系统托盘中找到 Pageant 图标。
3. 右键单击系统托盘中的 Pageant 图标，然后选择查看密钥。将打开Pageant 密钥列表窗口。
4. 单击添加密钥。
5. 使用文件资源管理器窗口选择要加载的 SSH 密钥文件。确保选择扩展名为 .ppk 的文件，然后单击打开。
6. 如果密钥受密码保护，请输入您的密码。
7. 确保您选择的密钥现在已列在Pageant 密钥列表窗口中。此密钥现在可用于在您的 PuTTY 会话期间连接到任何服务器。

您可能已配置 Git 使用 PuTTY 的 plink.exe 程序。要检查 Git 在使用 SSH 密钥时是否使用 Pageant

1. 检查您是否有 GIT_SSH_COMMAND 环境变量。如果没有，请创建它。
2. 将其值设置为 PuTTY 的 plink.exe 文件的完整路径。默认情况下，此位置为 "C:\Program Files\PuTTY\plink.exe"。重要提示：如果路径包含空格，请确保将其值用引号括起来。

要在启动时自动加载私钥

1. 打开“开始”菜单，然后右键单击Pageant。

2. 选择更多 > 打开文件位置。将打开一个文件资源管理器窗口。

3. 右键单击Pageant，然后选择属性。将打开Pageant 属性窗口。

4. 通过附加您想要在启动时加载的私钥的完整路径来更新目标字段。用空格分隔每个密钥。例如

     "C:\Program Files\PuTTY\pageant.exe" "C:\Users\user1\myKeys\privatekey.ppk"
   

5. 选择应用，然后选择确定。

6. 通过打开命令行并在您的存储库中运行 git 命令来测试您的配置，以确保您可以在无需提示输入密码的情况下完成操作。

当 Pageant 正在运行并且您输入了密码后，您可以使用 Unity 包管理器通过 SSH 使用您的受密码保护的 SSH 密钥从该 Git 存储库获取包。

下次 Pageant 启动时，如果它受密码保护，它会提示您输入密码。

要使 Windows 启动时自动加载 Pageant，请参阅 Microsoft 支持文章 在 Windows 10 中添加要在启动时自动运行的应用。

其他资源

• 在 Windows 上自动加载 SSH 密钥 (OpenSSH)
• 使用带密码保护的 SSH 密钥与 SSH Git URL
• PuTTY 用户手册