【Linux】VSCode Remote-SSH 无法连接并反复要求输入密码问题详解

Visual Studio Code（简称 VS Code）作为一款广受欢迎的轻量级编辑器，其 Remote-SSH 插件为开发者带来了便捷的远程开发体验。然而，在使用 Remote-SSH 插件连接远程服务器的过程中，很多用户会遇到输入密码后仍无法连接的问题，甚至被持续提示输入密码。本文将围绕这一常见问题展开详细分析，并结合真实解决过程，帮助开发者顺利排查与解决相关故障。

一、问题现象描述

1. 典型表现

当使用 VS Code 的 Remote-SSH 功能连接远程服务器时：

• 成功输入密码后，VS Code 并未正常连接服务器；
• 系统反复弹出“请输入 SSH 密码”的提示窗口；
• 即使密码无误，连接始终无法建立；
• Terminal 中可能看到 "Retrying after error: Connection refused" 或 "Permission denied" 之类的提示；
• 有时会自动执行安装 VS Code Server 的命令，但无反应或失败。

2. 常见的误区尝试

• 反复重启 VS Code；
• 更换网络环境；
• 再三确认 SSH 密码是否输入正确；
• 在 ~/.ssh/config 中重新配置主机信息；
• 尝试通过命令行使用 ssh user@host 连接远程主机，结果显示一切正常。

但令人困惑的是，即便通过终端可以正常使用 SSH 登录，Remote-SSH 插件却依然连接失败。

二、原因分析

该问题的根本原因通常并不在于 SSH 配置错误或网络异常，而是出现在 VS Code 在服务器上部署的 vscode-server 出现异常或损坏。

Remote-SSH 插件在首次连接服务器时，会自动将一个小型的 vscode-server 程序上传至远程主机的 ~/.vscode-server 目录中，并通过该程序建立编辑器与远程主机之间的通信。

当这个 vscode-server 出现以下情况时就可能导致问题：

• 安装过程中被中断；
• 升级 VS Code 后版本不一致；
• .vscode-server 目录权限错误或文件损坏；
• 残留的临时文件引起冲突；
• 磁盘空间不足或远程主机资源紧张。

三、解决方案详解

1. 首选方式：清除服务器上的 vscode-server

可以通过清除服务器上的 .vscode-server 目录来强制 VS Code 在下次连接时重新部署该服务。操作步骤如下：

第一步：登录远程服务器（如果你有办法…）

第二步：删除 .vscode-server 目录

rm -rf ~/.vscode-server

注意：如果使用的是 VS Code Insiders，则目录名可能为 ~/.vscode-server-insiders；也有使用的是 ~/.vscode-remote，需根据具体情况处理。

第三步：重新连接 VS Code Remote-SSH

重新在 VS Code 中打开命令面板（Ctrl + Shift + P），执行：

Remote-SSH: Connect to Host...

选择目标主机，系统将重新部署 VS Code Server，并建立新的连接。

2. 备选方式：使用 Remote-SSH 提供的清理命令

如果你希望使用 GUI 操作，也可以执行：

Remote-SSH: Kill VS Code Server on Host...

然后选择对应的主机。该命令会尝试远程执行清理任务，终止正在运行的 server 实例并删除缓存目录。

然而在某些场景中，该命令无法完全清理干净，此时建议回到方案一手动删除。

3. 验证连接是否恢复正常

删除后再次连接时，VS Code 应该会提示：

Installing VS Code Server on remote...

几秒钟后如果一切顺利，你将进入远程环境，文件树、终端等功能正常显示，问题解决。

四、其他可能性排查

1. 检查 SSH 密钥方式是否启用

如果使用的是密钥认证方式（推荐），请确认以下几个方面：

• 公钥是否已添加至远程主机的 ~/.ssh/authorized_keys
• 私钥权限为 600，即 chmod 600 ~/.ssh/id_rsa
• ssh-agent 正确启动并加载私钥
• .ssh/config 文件配置是否正确，如下：

Host my-server
  HostName 192.168.1.100
  User myuser
  IdentityFile ~/.ssh/id_rsa

2. 确保服务器未被防火墙或权限阻止

有些服务器可能对特定 IP 或端口有限制。你可以在服务器端查看 /var/log/auth.log 或使用以下命令查看是否有登录记录：

sudo journalctl -u ssh

3. 更新 Remote-SSH 插件

确保你使用的是最新版 Remote-SSH 插件，有些旧版本存在稳定性问题。打开插件管理器，搜索 Remote - SSH 并点击更新。

推荐：

• JavaScript
• react
• vue

---