vscode ssh连接超时主因是ssh握手慢、vscode-server部署失败或保活中断；需先验证ssh连通性，再调优serveralive/clientalive参数并手动部署server，最后检查glibc版本与inode余量。
VSCode 的 SSH 连接超时，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
卡在 “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 重连
连接成功但几分钟后断开
这是典型的保活机制失效，客户端和服务端的 KeepAlive 配置不匹配或未启用。
-
ServerAliveInterval 60和ServerAliveCountMax 3必须成对出现，只设前者不设后者时 OpenSSH 会用默认值 0（立即断） - 服务端
/etc/ssh/sshd_config也必须配：ClientAliveInterval 60、ClientAliveCountMax 3、TCPKeepAlive yes，改完执行sudo systemctl restart sshd - VSCode settings.json 中补上：
"remote.autoReconnect": true、"remote.SSH.useLocalServer": false（强制走系统 ssh 客户端） - 别配
remote.SSH.timeout—— 它只控制“建立连接”的超时，对空闲断连无效
容易被忽略的细节
权限错误、配置语法错、路径不对这些看似低级的问题，恰恰是最常卡住的地方。
-
~/.ssh/config中IdentityFile必须是绝对路径，比如/home/you/.ssh/id_rsa，不能写~/.ssh/id_rsa - Host 块内所有字段后只能用英文空格分隔，不能有 Tab 或中文标点
- 云平台安全组规则要允许你的本地公网 IP（不是 0.0.0.0/0）访问 SSH 端口，否则即使命令行能连，VSCode 也可能因多通道行为被拦截
- 某些企业网络会拦截 SSH 的端口转发流量，此时需联系管理员确认策略，而非反复调参数
