当前位置:首页 > 系统教程 > 正文

VSCode Remote-SSH连接失败解决指南(彻底解决反复输入密码困扰)

VSCode Remote-SSH连接失败解决指南(彻底解决反复输入密码困扰)

在日常开发中,使用 VSCode Remote-SSH 插件连接远程 Linux 服务器是许多开发者的首选方案。然而,很多新手小白在使用过程中会遇到“VSCode连接远程服务器失败”或者“连接成功但反复要求输入密码”的情况,这不仅降低了开发效率,还让人感到非常沮丧。本文将详细讲解如何通过 Linux SSH免密登录 配置,彻底解决 SSH反复输入密码 的问题。

一、 为什么会反复提示输入密码?

通常情况下,出现该问题的原因主要有三点:

  • 未配置 SSH 公钥登录,导致 VSCode 每次握手都需要手动验证。
  • 远程服务器上的 .ssh 文件夹或 authorized_keys 文件权限设置不当。
  • VSCode 的配置文件 config 指向的私钥路径有误。
VSCode Remote-SSH连接失败解决指南(彻底解决反复输入密码困扰) Remote-SSH  Linux SSH免密登录 SSH反复输入密码 VSCode连接远程服务器失败 第1张

二、 解决方案:配置 SSH 免密登录

要解决 VSCode Remote-SSH 的密码问题,最核心的步骤就是在本地机器和服务器之间建立信任关系。

步骤 1:在本地生成 SSH 密钥对

打开本地终端(Cmd、PowerShell 或 Git Bash),输入以下命令:

ssh-keygen -t rsa -b 4096

一路回车即可。生成的密钥通常存放在 C:\Users\你的用户名\.ssh 目录下。

步骤 2:将公钥上传至 Linux 服务器

找到生成的 id_rsa.pub 文件,将其内容复制。然后在远程服务器的家目录下执行:

mkdir -p ~/.sshecho "你的公钥内容" >> ~/.ssh/authorized_keys

步骤 3:严格设置权限(非常关键)

Linux 系统对 SSH 权限要求非常严格,权限不对会导致免密失效:

chmod 700 ~/.sshchmod 600 ~/.ssh/authorized_keys

三、 配置 VSCode 的 SSH 配置文件

点击 VSCode 左侧的远程资源管理器,打开 config 文件,确保包含以下内容:

Host MyServer    HostName 192.168.1.100    User root    IdentityFile "C:\Users\Administrator\.ssh\id_rsa"

这里的 IdentityFile 必须指向你本地的私钥路径。

四、 总结

通过以上步骤,你应该已经成功解决了 VSCode Remote-SSH 无法连接或反复要求输入密码的问题。本文提到的核心关键词包括:VSCode Remote-SSHLinux SSH免密登录SSH反复输入密码 以及 VSCode连接远程服务器失败。只要确保密钥匹配且文件权限正确,远程开发体验将会变得非常顺滑。