TortoiseGit 配置 PuTTY Key 避坑：OpenSSH 私钥转 PPK 完整步骤

TortoiseGit 配置 PuTTY Key 避坑指南

TortoiseGit 默认使用 PuTTY 格式密钥（.ppk），直接加载 OpenSSH 生成的 id_rsa 会报错 Couldn't load this key (OpenSSH SSH-2 private key)。本文给出标准转换流程。

错误现象

Settings → Git → Remote → Putty Key 选择 id_rsa
→ Couldn't load this key (OpenSSH SSH-2 private key)

三步转换法

1. 运行 PuTTYGen（随 PuTTY/TortoiseGit 安装）
2. 导入私钥：菜单 Conversions → Import key → 选择 id_rsa（或 id_ed25519）
3. 保存为 PPK：点击 Save private key → 确认无密码短语（或输入） → 保存为 xxx.ppk
4. 加载到 Pageant（可选，实现免密）：运行 Pageant → 系统托盘右键 Add Key → 选择刚生成的 .ppk

验证

TortoiseGit Settings → Putty Key 选择 .ppk 文件 → OK，随后 git pull/push 无需再输密码。

原理说明

• OpenSSH 私钥格式：PEM（-----BEGIN OPENSSH PRIVATE KEY-----）
• PuTTY 私钥格式：PPK（专有二进制结构）
• PuTTYGen 实现双向转换，Pageant 作为 SSH Agent 缓存解密后的私钥

替代方案

TortoiseGit 设置 → Network → SSH Client 选择 C:\Program Files\Git\usr\bin\ssh.exe（OpenSSH），可直接使用 id_rsa，无需转换。但需确保 GIT_SSH 环境变量未指向 PuTTY 的 plink.exe。