目录

Tortoisegit配置ssh教程

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

HostNamessh.github.com
PortNumber443
Protocolssh
UserNamegit
PublicKeyFileC:\Users\YourName.ssh\github.ppk#这一项可以不要, Pageant自动加载即可