VSCode插件引起远程连接断开的排查技巧-VSCode-PHP中文网

remote-ssh 卡在“setting up ssh host”阶段通常是因密钥认证失败、代理跳转异常、远程命令无响应或插件干扰所致，需结合 verbose 日志与系统状态排查。

vscode插件引起远程连接断开的排查技巧

Remote-SSH 插件本身卡在“Setting up SSH Host”阶段

这不是插件“崩溃”，而是它在等待某个阻塞操作完成，比如密钥认证、代理跳转或远程命令响应。VSCode 不会明确提示卡在哪一步，但日志里有线索。

打开命令面板（Ctrl+Shift+P），运行 Remote-SSH: Show Log (Verbose)，重点看是否出现：

Permission denied (publickey)：本地私钥没被读取（权限不是 600，或 IdentityFile 路径写错）
Connection closed by remote host：远程 sshd 主动拒接，常见于 PubkeyAuthentication no 或 MaxStartups 耗尽
ProxyCommand failed：跳转主机不可达，或中间节点上缺少 nc / ssh 命令

临时禁用所有非 Remote-SSH 插件（尤其是那些带终端注入、文件系统钩子的扩展），再重试——很多“断连”其实是其他插件干扰了 SSH 进程的 stdin/stdout 流。

远程端 vscode-server 被 OOM 杀死或僵死

VSCode Remote-SSH 在远程启动的 vscode-server 是个 Node.js 进程，它不只转发编辑器请求，还托管语言服务、文件监听、调试适配器。一旦远程机器内存吃紧（比如编译 C++ 项目 + 多窗口 + clangd 索引），它就可能被内核 OOM killer 干掉，或陷入无响应状态。

登录远程服务器后执行：

ps aux | grep -i 'vscode-server\|server-main'：确认进程是否存在且 CPU/内存占用合理
tail -n 50 ~/.vscode-server/data/logs/*/*/exthost.log：查扩展是否反复报错、崩溃
df -h 和 free -h：磁盘满或内存不足是常见诱因，尤其 ~/.vscode-server 下堆积大量 out 日志时

不要直接删整个 ~/.vscode-server；先 mv ~/.vscode-server ~/.vscode-server.bak，再在 VSCode 中运行 Remote-SSH: Kill VS Code Server on Host，最后重连触发干净重部署。

插件自动启用远程端口转发导致连接雪崩

某些插件（如 Docker、GitHub Pull Requests、Live Share）默认开启 remote.autoForwardPorts，会在远程监听大量端口并尝试反向绑定到本地。当远程机器防火墙严格、或本地端口被占满时，SSH 隧道会持续重试、积压连接，最终耗尽资源或触发 MaxSessions 限制。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在 VSCode 设置中显式关闭高风险行为：

"remote.autoForwardPorts": false
"remote.restoreForwardedPorts": false
"files.watcherExclude": {"**/node_modules/**": true, "**/.git/**": true}（减少文件监听压力）

也可以在远程 ~/.ssh/config 的对应 Host 块里加 ForwardAgent no 和 RequestTTY no，防止插件滥用代理和伪终端。

Remote-SSH 与系统 ssh-agent 冲突导致认证失败循环

VSCode Remote-SSH 默认使用自带的轻量级 ssh-agent，但它和系统级 ssh-agent（比如 macOS Keychain 或 Linux gnome-keyring）可能同时加载同一把密钥，造成签名冲突或锁竞争。现象是：终端 ssh 正常，但 VSCode 反复弹窗要输密码，或日志里出现 agent refused operation。

解决方式很直接：