SSH连接频繁断开主因是默认空闲5分钟被网络设备丢包，需在本地~/.ssh/config中配置ServerAliveInterval 60和ServerAliveCountMax 3；认证卡顿需检查密钥权限、sshd配置及日志；文件浏览慢应关闭自动端口转发与文件监听。
SSH连接频繁断开导致Remote-SSH插件报错 Failed to connect to server
VSCode Remote-SSH 本质是靠本地 SSH 客户端建立长连接，断连往往不是插件问题，而是底层 SSH 配置没撑住。默认配置下空闲 5 分钟就可能被中间网络设备（如路由器、防火墙）静默丢包。
实操建议：
- 在本地
~/.ssh/config中为远程主机添加保活配置：Host my-remote<br> HostName 192.168.1.100<br> User ubuntu<br> ServerAliveInterval 60<br> ServerAliveCountMax 3
-
ServerAliveInterval 60表示每 60 秒发一次探测包，ServerAliveCountMax 3表示连续 3 次失败才断开，能有效绕过多数 NAT 超时限制 - 避免在 VSCode 设置里仅依赖
remote.SSH.keepAlive—— 它只影响 VSCode 自身的重连逻辑，不干预底层 SSH 连接生命周期
Remote-SSH 启动时卡在 Setting up SSH Host 或反复重试
这通常是认证环节阻塞：密钥权限不对、代理转发冲突、或远程 sshd 配置拒绝某些请求。VSCode 不会明确告诉你卡在哪一步，但日志里有线索。
实操建议：
- 打开 VSCode 命令面板（
Ctrl+Shift+P），运行Remote-SSH: Show Log (Verbose)，重点看是否出现Permission denied (publickey)或Connection closed by remote host - 检查远程服务器的
/etc/ssh/sshd_config，确认PubkeyAuthentication yes和AllowAgentForwarding yes已启用（后者对部分跳转场景必要） - 本地私钥文件权限必须是
600（chmod 600 ~/.ssh/id_rsa），否则 OpenSSH 会直接忽略它
远程窗口打开后文件浏览慢、终端响应延迟高
这不是网络带宽问题，而是 VSCode Remote-SSH 默认启用的「文件系统代理」在低性能远程机器上容易成为瓶颈，尤其当远程家目录下有大量小文件或挂载了 NFS/CIFS。
实操建议：
- 在远程服务器上运行
ps aux | grep vscode-server，确认vscode-server进程是否在持续扫描文件（CPU 占用高 + 磁盘 I/O 突增） - 在 VSCode 设置中关闭自动文件监听：
"remote.autoForwardPorts": false和"files.watcherExclude": {"**/.git/objects/**": true, "**/node_modules/**": true} - 如果远程机器内存紧张（curl -L https://update.code.visualstudio.com/commit:COMMIT_ID/server-linux-x64/stable -o vscode-server.tar.gz，解压后指定
remote.extensionKind为["ui"]避免加载冗余扩展
使用跳板机（Bastion Host）时连接失败，错误提示含 ProxyCommand 或 Connection refused
VSCode Remote-SSH 支持嵌套 SSH，但对 ProxyCommand 的 shell 解析很脆弱 —— 它不执行 shell 初始化脚本，所以 ~ 路径、环境变量、别名全不可用。
实操建议：
- 把
ProxyCommand写成绝对路径 + 显式参数，例如：ProxyCommand /usr/bin/ssh -i /home/user/.ssh/bastion-key -W %h:%p bastion-user@bastion.example.com
- 避免在
ProxyCommand中使用~、$HOME或未加引号的空格；所有路径和参数必须完整、可直接由/bin/sh执行 - 测试该命令是否能在终端中独立运行成功：
/usr/bin/ssh -i /home/user/.ssh/bastion-key -W 10.0.1.5:22 bastion-user@bastion.example.com，只有它通了，VSCode 才可能通
远程开发真正的难点从来不在“连上”，而在于连上之后的资源调度是否透明。比如 vscode-server 默认用 node 启动，但如果你远程机器上的 node 是通过 nvm 安装的，它大概率找不到——这种路径隔离问题，日志里不会明说，只能靠 ps 和 strace 往下挖。
