如何在VSCode开发容器中通过PuTTY Pageant实现SSH代理转发（无需Windows内置OpenSSH）

核心问题 #

VSCode DevContainer默认仅适配Windows内置OpenSSH Agent，无法直接识别Pageant的Windows命名管道代理，导致设置SSH_AUTH_SOCK=pageant无效。

解决方案（无管理员权限，无需修改Docker镜像） #

1. 准备便携转发工具

获取便携版npiperelay.exe，放入主机本地目录（如C:\local-tools），并将该目录添加到用户级PATH环境变量（无需管理员权限）。

2. 启动主机端代理转发

打开命令提示符，运行以下命令（保持窗口持续运行，关闭则转发终止）：

npiperelay.exe -ei -s \\.\pipe\pageant -l 127.0.0.1:1234

此命令将Pageant的Windows命名管道流量转发到本地1234 TCP端口。

3. 配置DevContainer

修改.devcontainer/devcontainer.json，添加以下配置项：

{
  "remoteEnv": {
    "SSH_AUTH_SOCK": "/tmp/ssh-agent.sock"
  },
  "forwardPorts": [1234],
  "postCreateCommand": "socat UNIX-LISTEN:/tmp/ssh-agent.sock,fork TCP:host.docker.internal:1234 &"
}

• remoteEnv：指定容器内SSH客户端识别的代理套接字路径
• forwardPorts：将主机1234端口转发到容器内部
• postCreateCommand：容器启动后，通过socat把TCP端口转为UNIX套接字，适配容器内SSH工具的使用习惯

4. 验证配置

进入DevContainer后，执行以下命令：

ssh-add -l

若能列出主机Pageant中加载的SSH密钥，说明代理生效，此时可正常通过Git拉取/推送内部GitLab代码。

备选方案（需修改容器环境） #

若无法获取npiperelay.exe，可在容器内配置Git使用plink对接Pageant：

1. 在容器内安装putty工具集（以Debian/Ubuntu为例）：

apt update && apt install -y putty-tools

2. 设置Git默认SSH客户端为plink：

git config --global core.sshCommand "plink -agent"

此方法需修改容器环境，若上游镜像更新后需重复操作，仅作为临时替代。

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