首先配置ssh跳板机连接内网开发机,通过编辑本地SSH配置文件添加跳板机和目标机信息,使用proxyJump实现中转;随后在终端测试ssh连通性,确认无误后在vscode中通过Remote-SSH插件连接目标主机别名dev-inside,即可实现远程开发。

在实际开发中,很多内网服务器无法直接访问,必须通过跳板机(Jump Server)进行中转连接。使用 VSCode 的 Remote-SSH 插件配合跳板机,可以实现无缝连接内网开发机进行远程开发。以下是具体配置方法。
1. 准备工作
确保以下条件已满足:
- 本地已安装 OpenSSH 客户端(windows 10/11 建议启用 OpenSSH Client)
- VSCode 已安装 Remote-SSH 插件
- 拥有跳板机和目标开发机的 SSH 登录权限(推荐使用密钥认证)
2. 配置 SSH Config 文件
编辑本地 SSH 配置文件:~/.ssh/config(macOS/linux)或 %USERPROFILE%.sshconfig(windows)。
添加如下配置:
Host jump HostName 跳板机公网IP User 跳板机用户名 IdentityFile ~/.ssh/id_rsa_jump # 跳板机私钥路径 <p>Host dev-inside HostName 内网开发机私有IP User 开发机用户名 IdentityFile ~/.ssh/id_rsa_dev # 目标机私钥路径 ProxyJump jump
说明:
-
jump是跳板机的别名,方便后续引用 -
dev-inside是目标内网开发机的别名 -
ProxyJump jump表示连接此主机时,先通过 jump 主机跳转
3. 测试 SSH 连通性
打开终端,执行:
ssh dev-inside
如果能成功登录内网开发机,说明 SSH 隧道配置正确。
4. 在 VSCode 中连接
打开 VSCode,点击左下角绿色图标“>dev-inside。
VSCode 会自动通过跳板机连接到内网开发机,并加载远程环境。
连接成功后,即可像操作本地项目一样打开远程目录、编辑文件、运行调试等。
5. 常见问题处理
- 连接超时:检查跳板机是否允许转发、防火墙是否开放对应端口
- 权限被拒:确认私钥权限为 600(
chmod 600 ~/.ssh/id_rsa*) - 无法解析主机:确认 config 文件语法正确,Host 名唯一且无拼写错误
基本上就这些。只要 SSH 层能通,VSCode 就能连上。关键是把 ProxyJump 配对,其余交给工具自动处理。