VSCode远程连接超时主因是SSH握手慢、vscode-server部署失败或保活中断；需先验证SSH连通性，再调优ServerAlive/ClientAlive参数并手动部署server，最后检查glibc版本与inode余量。
VSCode远程连接超时，90%的情况不是“连不上”，而是卡在 SSH 握手、vscode-server 下载或保活中断这三个环节中的某一个。盲目调高 connectTimeout 只会让失败来得更晚，而不是更少。
SSH 命令行直连失败，说明问题在底层网络或服务端
VSCode 的 Remote-SSH 本质是调用系统 ssh 命令，如果它本身就连不上，VSCode 必然失败。
- 终端执行
ssh -o ConnectTimeout=5 -T user@host，看是否秒级返回或卡在debug1: kex_exchange_identification - 若卡住：大概率是服务器
sshd响应慢（如UseDNS yes+ DNS 故障）或中间防火墙丢包 - 若报
Connection closed by remote host：查服务器/var/log/auth.log，常见于max startups被拒绝 - 临时绕过 DNS 解析：在
~/.ssh/config对应 Host 块里加AddressFamily inet
VSCode 卡在 “Establishing SSH connection” 或日志显示 Downloading VS Code Server
这阶段超时通常和 vscode-server 部署有关，和网络连通性无关——比如服务器没外网、glibc 版本太低、或磁盘 inode 耗尽。
- 日志里出现
Downloading VS Code Server持续超 10 分钟，基本可排除带宽问题 - 手动触发部署：在服务器上运行
curl -fsSL https://update.code.visualstudio.com/commit:$(code --version | head -1)/server-linux-x64/stable看是否能下载 - 检查
df -i是否 inode 用满；ldd --version是否低于 VS Code 要求（如 glibc 2.28+） - 删掉旧缓存重试：
rm -rf ~/.vscode-server，再让 VSCode 重连
连接成功但几分钟后断开，或提示 “Connection lost”
这是典型的保活机制失效，客户端和服务端的 KeepAlive 配置不匹配或未启用。
- 本地
~/.ssh/config加入：Host your-host HostName xxx.xxx.xxx.xxx User your-user ServerAliveInterval 60 ServerAliveCountMax 3 TCPKeepAlive yes - 服务端确认
/etc/ssh/sshd_config含有：ClientAliveInterval 60 ClientAliveCountMax 3
- VSCode 自带的保活参数（
ServerAliveInterval=30,ServerAliveCountMax=6）可能过于激进，建议统一设为 60/3 - Windows 用户注意：cmd 属性里若勾选了“使用旧控制台(U)”，会干扰 SSH 流程，务必取消
真正难排查的点，往往藏在 SSH 配置和服务端 sshd 日志的交叉验证里——比如客户端发了保活包，服务端却因 MaxStartups 拒绝新通道，这种组合错误不会直接报错，只会表现为随机断连。
