VSCode Remote-SSH 频繁断开的根本原因是 SSH 客户端 ServerAliveInterval 与服务端 ClientAliveInterval 未配对启用，且必须值一致、成对配置 ServerAliveCountMax/ClientAliveCountMax，否则连接会在 3–5 分钟内被静默回收；remote.SSH.keepAlive 等 VSCode 设置不发网络包，仅作用于 UI 控制通道，无法维持真实 TCP 连接。
VSCode Remote-SSH 频繁断开不是“网络不好”，而是 SSH 心跳没配对——客户端 ServerAliveInterval 和服务端 ClientAliveInterval 必须同时设、值一致、且成对启用 ServerAliveCountMax/ClientAliveCountMax，否则连接会在 3–5 分钟内被静默回收。
为什么只改 VSCode 设置（如 remote.SSH.keepAlive）完全无效
remote.SSH.keepAlive 只控制 VSCode 自身 UI 层的控制通道保活，不发任何网络包，对终端、端口转发、文件监听等核心子通道零作用。你看到“重连成功”，其实是底层 SSH 连接根本没断——只是 VSCode UI 暂时失联又恢复了。真正决定连接是否存活的，是 OpenSSH 协议层的心跳机制。
-
remote.SSH.keepAlive默认为 60，无论改成 30 还是 300，都不会让 TCP 连接多活一秒 -
remote.autoReconnect是“断了再试”，不是“不断”；它依赖底层 SSH 已断开并触发重连逻辑，但多数断连根本没走到这一步——连接被中间设备直接掐断，VSCode 甚至收不到断开通知 - VSCode 的
remote.SSH.useLocalServer必须设为false，否则插件会绕过你本地~/.ssh/config，用自带精简版 ssh 客户端，导致所有保活配置失效
~/.ssh/config 中必须写的三行客户端保活参数
编辑 ~/.ssh/config，在对应 Host 块内显式写入，不能只靠全局设置或注释掉的模板：
-
ServerAliveInterval 60：每 60 秒向服务器发一次空包（非数据，仅探测）。设为 30 会增加探测频率，但对绝大多数 NAT 设备无必要，反而可能触发某些防火墙限流 -
ServerAliveCountMax 3：连续 3 次未收到响应才断开，即最多容忍 3 分钟无响应。**只设ServerAliveInterval不设此项，OpenSSH 会用默认值 0（立即断），比不设还糟** -
TCPKeepAlive yes：必须显式开启。部分老旧 OpenSSH 版本（如 Windows 自带 7.7p1）若不设此值，会跳过保活逻辑；它作为底层兜底，防止 TCP 连接被中间设备静默回收
远程服务器 /etc/ssh/sshd_config 必须同步生效的三项
登录服务器检查 /etc/ssh/sshd_config，确认以下三项未被注释、值合理，并**执行 sudo systemctl restart sshd**（Docker 环境需额外加 -o ClientAliveInterval=60 启动参数）：
-
ClientAliveInterval 60：服务端每 60 秒主动 ping 客户端一次。若只配客户端心跳，服务端可能因长期收不到业务数据，单方面判定客户端失联并关闭连接 -
ClientAliveCountMax 3：和客户端保持一致。若服务端设为 1，而客户端设为 3，则服务端会在 60 秒后就断连，客户端根本来不及响应 -
TCPKeepAlive yes：注意这不是可选开关——它只检测底层 TCP 是否通，穿不过 NAT，所以必须和ClientAliveInterval配合使用
容易被忽略的隐性冲突点
即使所有保活参数都正确，仍可能卡在 “Opening remote…” 或终端无响应，常见于：
- 远程
/tmp不可写或磁盘满：VS Code Server安装失败但错误被静默吞掉，表现为无限等待；运行df -h和ls -ld /tmp立刻验证 - 远程 shell 启动脚本（如
~/.bashrc）含阻塞操作：比如git status卡住、等待用户输入、执行耗时命令；VSCode 启动时会加载完整 shell 环境，建议加[ -z "$PS1" ] && return守卫非交互场景 - WSL2 下使用 Remote-SSH：WSL2 虚拟网卡易触发 NAT 超时，需在 WSL2 中运行
echo "net.ipv4.tcp_keepalive_time = 60" | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
最常被跳过的动作是：改完 /etc/ssh/sshd_config 后忘记 sudo systemctl restart sshd，或者以为 VSCode 设置能覆盖 SSH 底层行为。保活不是“开了就行”，是客户端和服务端两个独立进程之间的一次握手协议——漏掉任一端，连接就在你写完第 10 行代码时悄然消失。
