TeamCity启动SSH Agent失败求助：无法解析ssh-agent输出

排查与修复步骤 #

• 更新构建代理的OpenSSH版本
  Windows Server 2022自带的OpenSSH可能存在兼容性问题，手动替换为最新稳定版：

  1. 卸载系统自带的OpenSSH Client和Server组件
  2. 安装微软官方的最新OpenSSH包，安装完成后重启代理服务器
  3. 打开命令提示符执行ssh-agent，确认输出能正常返回SSH_AUTH_SOCK和SSH_AGENT_PID环境变量

• 调整TeamCity代理的SSH配置
  编辑构建代理目录下的conf/buildAgent.properties，添加或修改以下配置：

  teamcity.ssh.use.bundled.agent=false
  teamcity.ssh.executable.path=C:\\Windows\\System32\\OpenSSH\\ssh-agent.exe
  

  注意路径要匹配实际的ssh-agent安装位置，修改后重启TeamCity构建代理服务

• 检查代理服务的运行账户权限
  若TeamCity代理以Local System账户运行，可能无法访问用户级的SSH配置：

  1. 打开服务管理器，找到TeamCity Build Agent服务
  2. 切换到「登录」选项卡，改为使用具备管理员权限的本地账户运行
  3. 重启服务后重新触发构建测试

• 验证构建代理端的SSH密钥有效性
  不要只在主服务器测试克隆，在代理服务器上手动执行：

  git clone git@github.com:<你的仓库地址>.git
  

  如果失败，说明代理端未正确配置GitHub公钥（需把代理服务器生成的公钥添加到GitHub账户）

• 查看代理日志获取细节
  打开代理日志目录下的teamcity-agent.log，搜索ssh-agent相关条目，找到更具体的错误信息（比如权限不足、路径错误等）

内容的提问来源于stack exchange，提问作者Princy