SSH Agent Forwarding可将本地SSH密钥安全转发至远程服务器，用于VS Code远程开发时访问私有Git仓库。1. 配置~/.ssh/config文件，添加Host、HostName、User、ForwardAgent yes及IdentityFile；2. 确保本地SSH agent运行并添加密钥；3. 连接后检查$SSH_AUTH_SOCK环境变量及ssh-add -l输出以确认转发生效；4. 安全起见仅在可信主机启用该功能，避免私钥暴露风险。配置正确后，远程Git操作无需重复认证。
在使用 VS Code 进行远程开发时，SSH Agent Forwarding 是一个非常实用的功能，尤其当你需要在远程服务器上访问受保护的 Git 仓库（如公司内网或 GitHub 私有项目）时。它允许你将本地的 SSH 密钥“转发”到远程主机，而无需把私钥实际存储在服务器上，既安全又方便。
什么是 SSH Agent Forwarding
SSH Agent Forwarding 是 SSH 协议的一项功能，它通过本地运行的 SSH agent 将认证请求从远程服务器“回传”到你的本地机器。这意味着：
- 远程服务器需要连接 GitHub、GitLab 等服务时，不会使用自己的密钥
- 而是通过加密通道向你的本地电脑请求签名
- 私钥始终保留在本地，不会暴露在远程主机上
如何在 VS Code 中启用 SSH Agent Forwarding
要让 VS Code 远程开发支持 Agent Forwarding，关键在于配置 SSH 客户端配置文件（~/.ssh/config），而不是在 VS Code 内部设置。
编辑或创建 ~/.ssh/config 文件，添加或修改对应远程主机的配置：
Host your-remote-hostHostName 192.168.1.100
User yourname
ForwardAgent yes
IdentityFile ~/.ssh/id_rsa
注意：确保 ForwardAgent yes 被正确设置。VS Code Remote-SSH 扩展会读取这个配置并自动启用代理转发。
验证 Agent Forwarding 是否生效
连接到远程主机后，可以通过以下命令检查：
echo $SSH_AUTH_SOCK如果输出类似 /tmp/ssh-XXXXXX/agent.XXXX 的路径，说明 agent 已经成功转发。
进一步测试：
ssh-add -l该命令会列出当前 agent 中可用的密钥指纹。如果能看到你本地的密钥，说明转发正常工作。
此时你在远程终端中执行：
git clone git@github.com:your-company/private-repo.git应该可以无需输入密码直接克隆，因为请求会通过 agent 回传到本地完成认证。
安全注意事项
虽然 Agent Forwarding 很方便，但也存在风险：一旦你在不受信任的服务器上启用了转发，该服务器的 root 用户或恶意程序可能利用你的 agent 进行认证。
- 只在你完全信任的远程主机上启用 ForwardAgent yes
- 避免在公共或共享服务器上使用 agent forwarding
- 考虑使用 ssh -A 临时开启，而非全局配置
基本上就这些。只要配置好 SSH config 文件并确认 agent 正常运行，VS Code 的 Remote-SSH 就能无缝使用本地密钥，让你在远程开发时像在本地一样顺畅操作 Git。不复杂但容易忽略细节。
