Tortoisegit配置ssh教程

TortoiseGit的SSH配置方案解析

方案对比表

配置方式	优点	缺点	适用适场景
Git原生SSH	直接使用标准SSH配置(~/.ssh/config) 与命令行Git保持统一	需手动指定ssh.exe路径	已配置OpenSSH环境的用户
TortoiseGitPlink	默认集成，使用Pageant管理密钥	需要转换密钥格式(.ppk)	习惯PuTTY工具链的用户

---

TortoiseGit SSH配置识别问题深度解析

TortoiseGit默认使用TortoiseGitPlink作为SSH客户端，而Plink是PuTTY工具链的一部分，不会读取标准的OpenSSH配置文件(~/.ssh/config)

1. 客户端差异‌：TortoiseGitPlink不解析OpenSSH格式的config文件
2. ‌密钥格式冲突‌：TortoiseGit需要.ppk格式密钥而非标准的id_rsa
3. ‌配置存储位置‌：PuTTY系列工具将配置存储在Windows注册表中而非文件系统

---

详细配置指南

方案一：Git原生SSH配置方法（推荐, 依赖ssh.exe）

1. 确保已安装Git for Windows并包含SSH组件
2. 右键任意文件夹 → TortoiseGit → 设置 → Network
3. 在"SSH Client"字段指定Git的ssh.exe路径（如D:\Program Files\Git\usr\bin\ssh.exe）
4. 应用设置后，TortoiseGit将直接读取您的~/.ssh/config文件

    config文件内容:
          Host github.com
          HostName ssh.github.com      
          User git
          Port 443
          IdentityFile ~/.ssh/id_rsa
          AddKeysToAgent yes
          IdentitiesOnly yes

方案二：TortoiseGitPlink配置方法(创建PuTTY会话, 无需 putty.exe）

1. 打开注册表编辑器：
   按 Win+R 输入 regedit
2. 导航到 PuTTY 会话注册表位置：
   HKEY_CURRENT_USER\SOFTWARE\SimonTatham\PuTTY\Sessions
   没有Sessions则创建Sessions键：右键PuTTY键 → 新建 → 项, 命名为Sessions（区分大小写）
3. 创建 github.com 会话‌：
   右键 Sessions → 新建 → 项 → 命名为 github.com，在右侧窗口创建字符串值：

HKEY_CURRENT_USER\SOFTWARE\SimonTatham\PuTTY\Sessions

项	值
HostName	ssh.github.com
PortNumber	443
Protocol	ssh
UserName	git
PublicKeyFile	C:\Users\YourName\.ssh\github.ppk	#这一项可以不要, Pageant自动加载即可