如何修复Visual Studio Code远程扩展主机服务器连接失败错误（错误码1006）？

以下是针对该错误的排查和修复方案，按优先级尝试：

1. 验证远程服务器网络连通性 #

• 测试远程服务器SSH端口（默认22）是否开放：本地执行telnet <服务器IP> 22或nc -zv <服务器IP> 22命令，确认能正常连通
• 检查本地与服务器之间的防火墙、安全组规则，确保未阻断SSH及Websocket相关流量（远程扩展依赖SSH隧道传输Websocket数据）

2. 重置VSCode远程相关配置文件 #

• 删除本地存储的远程服务端缓存：
  • Windows：删除%USERPROFILE%\.vscode-server和%USERPROFILE%\.vscode\extensions
  • macOS/Linux：删除~/.vscode-server和~/.vscode/extensions
• 重启VSCode后重新发起远程连接

3. 调整VSCode远程连接设置 #

• 打开VSCode设置，搜索remote.SSH.useLocalServer，将其设置为false，禁用本地SSH代理服务器
• 尝试开启remote.SSH.enableDynamicForwarding，允许动态端口转发

4. 检查SSH客户端兼容性 #

• 确保本地OpenSSH版本不低于8.0，低版本可能存在协议兼容性问题
• 简化本地~/.ssh/config（Windows为%USERPROFILE%\.ssh\config）中的远程服务器配置，暂时移除ProxyCommand、ForwardAgent等自定义设置后重试

5. 切换远程认证方式 #

如果当前用SSH密钥登录，尝试改用密码登录；反之则切换为密钥认证，排除认证机制导致的连接异常

内容的提问来源于stack exchange，提问作者user25749366