VSCode Remote-SSH 连上了过一会儿又断，不一定是 SSH 本身的问题
连接海外开发机时，VSCode Remote-SSH 插件层的断开与底层 SSH 连接是否正常并不总是同步——社区报告过多起“直接 SSH 连接能一直保持，但 VSCode 里连到固定时长就自动断开”的情况，说明问题往往出在插件的管道封装层，而不是链路本身。但同时，连接海外服务器的场景下，跨境往返延迟确实会放大各种边界情况。本文先排查本地与服务端因素，再看跨境链路能帮上什么忙。
先清理服务端残留进程与缓存
连接异常中断后，远程机上往往会残留没正常退出的 vscode-server 进程，下次重连时新旧进程争用端口或状态文件就会引发奇怪行为。可以先登录远程机手动查找并 kill 掉残留的 vscode-server 进程，删除 ~/.vscode-server 目录后重新连接，让插件重新完整部署一次。
本地配置项容易踩到的坐坑
useLocalServer 设置
将 remote.SSH.useLocalServer 设为 false，与上面清理缓存的方法搭配使用，多个社区案例确认这个组合能缓解一部分连接异常断开的情况。
SSH keep-alive 参数
在本地 ~/.ssh/config 里给对应 Host 加上 ServerAliveInterval 和 ServerAliveCountInterval，让客户端定期发心跳包，避免长时间无数据传输时被中间设备判定为空闲连接而提前回收。
跨境往返延迟会放大这些问题
连接海外开发机时，每一次文件同步、终端交互都需要经过跨境链路往返，延迟本身就比境内服务器高，链路中间再叠加拥塞或丢包，就很容易触发前面提到的插件层断连重连机制。即便把 keep-alive 参数调得再合理，如果链路本身拥塞严重，心跳包也可能丢失。通宝 VPN 的 IEPL 国际专线针对这类长连接场景提供相对固定且跳数更少的出口路径，搭配 AI 智能路由自动择优，让 Remote-SSH 这类需要长时间保持连接的开发场景更不容易因为链路拥塞而被提前掐断。
先看日志,再判断是随机丢包还是固定超时
排查前先把现象记清楚。在 VSCode 的输出面板里选择 Remote - SSH 日志,能看到每次断开前后的提示;同时在终端里用 ssh -vvv 连同一台机器,对比两边的报错是否一致。
断开的时间规律很有参考价值。如果每次都在相近的时长后断开,例如空闲几分钟就掉线,多半是路径上某台中间设备的空闲超时或连接表项过期,调整保活心跳通常有效;如果断开时间毫无规律,并且常伴随终端回显卡顿,更像是链路丢包或抖动,心跳参数就帮不上太多忙。
另外有一处配置要核对:OpenSSH 里控制允许心跳无响应次数的选项叫 ServerAliveCountMax,和 ServerAliveInterval 搭配使用。一个常见的起步写法是 ServerAliveInterval 30 加 ServerAliveCountMax 3,表示每 30 秒发一次探测,连续 3 次没有回应才判定断开。这只是示例值,链路波动大时可以适当调高容忍次数。
自查清单与总结
Remote-SSH 连接不稳定先按下面这张清单逐条排查，如果都确认正常但仍然频繁断开，就要从接入链路本身入手：
- 登录远程机清理残留的 vscode-server 进程与缓存目录
- 将 remote.SSH.useLocalServer 设为 false
- 在 ~/.ssh/config 里配置 ServerAliveInterval 保活心跳
- 确认 VSCode 与 Remote-SSH 插件都升级到最新版本，排除已知插件 bug
- 开启 remote.SSH.showLoginTerminal 看连接过程是否卡在某个交互提示上
常见问题
直接 SSH 连接正常，为什么 VSCode 里还是断？
说明问题在 Remote-SSH 插件的管道封装层，而不是底层网络或 SSH 配置，优先清理服务端残留进程并升级插件。
keep-alive 参数调到多大比较合适？
没有固定数值，一般从 ServerAliveInterval 设为几十秒开始尝试，配合 ServerAliveCountInterval 控制允许丢包的次数，链路越不稳定，需要的容忍值越高。
为什么连接境内服务器很稳定，连海外服务器就容易断？
境内服务器往返延迟低，即便有短暂拥塞也不容易触发时间阈值；海外服务器需要经过跨境链路，基础延迟高且波动大，同样的超时阈值更容易被触发。
