【Linux】VSCode Remote-SSH 无法连接并反复要求输入密码问题详解
文章目录
- 一、问题现象描述
- 1. 典型表现
- 2. 常见的误区尝试
- 二、原因分析
- 三、解决方案详解
- 1. 首选方式：清除服务器上的 vscode-server
- 2. 备选方式：使用 Remote-SSH 提供的清理命令
- 3. 验证连接是否恢复正常
- 四、其他可能性排查
- 1. 检查 SSH 密钥方式是否启用
- 2. 确保服务器未被防火墙或权限阻止
- 3. 更新 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
