VSCode 连不上远程服务器问题及解决办法集合

楼主由于突然 VSCode 连不上服务器，因此从网上搜到了很多解决办法。楼主觉得可以将这些方法集中起来，为遇到这种连接问题的人们作为参考。该资料将持续更新，也欢迎各位大神留言提供更多解决办法！

话不多说，先放上官方提供的解决办法集锦，整理的内容很全面。不过，下面收录的链接问题相对更具体、方法也更直观，且对英文不好的朋友比较友好。

另外，如 Windows 系统文件修复、重新卸载安装 VSCode 或手动切换 Remote-SSH 版本 、重启计算机等，这些基础的解决方法在这里就不过多罗列了。

---

1. Error Establishing Tunnel

这个 ERROR 造成的原因种类比较多，后边其他的问题也可以通过这部分的方法进行解决。

• 主机存储的服务信息过旧（删除 known_hosts 内相关信息）
• 配置文件格式问题（注意是两个空格或两个 tab ）
• 公钥过期问题（重新生成密钥对更新服务器文件和 VSCode 相关配置）
• 使用 socks5 代理服务器的配置（注意需要 ncat ，类似 HTTP 代理只用替换参数即可）
• ssh 程序版本或多个冲突（重新安装并添加路径）

---

2. Unauthorized Client Refused

• 服务器缺少函数库或其版本低（通过服务器终 .vscode-server 内日志查看问题）

---

3. Time Limit Reached

• 服务器的 ssh 配置不允许访问（修改服务器 sshd_config 中的配置）
• 主机 ssh 版本问题 / 服务器在第一次连接时没有网 / 同局域网内主机配置问题

---

4. WebSocket Close with Status Code 1006

• 代理服务器 Nginx 配置问题（在代理中进行设置）

---

5. Handler Already Set

• 能够 ssh 成功但无法打开文件（删除缓存配置文件并重新安装程序）

---

6. Spawn UNKNOWN

• ssh.exe 路径问题（手动设置 OpenSSH 或 Git 的 ssh 程序路径）

---

7. ‘_workbench.downloadResource’ Failed

• 服务器 VSCode 版本和本地不一致（从官网上下载传入服务器安装）

---

8. Failed to Parse Remote Port from Server Output

• 主机中 known_hosts 描述服务器的信息发生变更（删除或清空相关旧内容即可）
• remote.SSH.useLocalServer 设置问题（非局域网内设置为 false ）

---

9. Connection Refused

• 服务器端口 22 连接拒绝（查看服务器 ssh 是否安装且已启用）

---

10. Remote Host Identification has Changed

• 更新 known_hosts 文件

---

11. Bad Owner or Permissions

• ssh 权限问题（更改可以控制全部）
• ssh 版本和环境变量问题（根据可以用的进行设置）

---

12. Setting up SSH Tunnel

• 动态转发设置问题（取消 Enable Dynamic Forwarding ）
• 服务器下载错误或没有网（按照服务器提示选择下载 stable 或 insider）

---

13. Bad Configuration Options

• 配置文件存在异常（核对并调整配置文档）

---

14. Could Not Establish Connection to “XXX”

• ssh 没有权限建立（需通过管理员权限运行）

---

15. Spawn UNKNOWN

• 插件没有配置 ssh.exe 的路径

---

16. XHR failed at y.onerror

• 服务器网络不佳导致反复下载安装包

---

17. 其他连接出错现象及相应解决办法

万能解决办法：Remote-SSH: Kill VS Code Server on Host

• 服务器未更新版本（下载对应版本的 vscode server 插件）
• 一直提示输入密码
• c/c++ 插件无法用（注意要从 VSIX 安装）
• 主机 ssh 文件夹出现多个配置文件（将不同配置文件分开存放）
• 找不到 ssh 文件（安装最新 ssh 版本或手动设置路径）
• 远程连接时不断重复循环（删除服务器端的 .vscodeserver 目录）
• 远程服务器磁盘空间不足
• 数据包无法互通（AllowTcpForwarding 设置为 yes）
• 其他各种问题（1）
• 其他各种问题（2）