【完美解决】VSCode连接HPC节点,已配置密钥却还是提示需要输入密码

发布于:2025-04-11 ⋅ 阅读:(41) ⋅ 点赞:(0)


问题描述

  本人在使用 ​​VSCode Remote-SSH 插件​​连接超算集群节点时,遇到以下问题:已正确配置 SSH 密钥,且 VSCode 能识别密钥文件(如图1),但在建立连接时仍反复要求输入密码(如图2)。

可以正确识别到密钥

图1 密钥配置验证通过

仍然要输入密码

图2 仍然弹出密码验证提示

  尝试了密钥文件权限重置、VSCode 缓存清理、重装 Remote-SSH 插件等方法,然而并无卵用。今天本人终于把这个问题给解决了,特地写下这篇文章向大家分享我的解决方案。


软件版本

  以下是我做测试时所用到的软件版本:

  VSCode:2023-1.85

  Linux:CentOS 7.6

  Remote-SSH:v0.107.1

  HPC:SCNet 超算互联网


原因分析

  VSCode Remote-SSH 插件默认用户家目录位于 ​​/home/username​​,但在某些环境下,如高性能计算集群(HPC),用户家目录可能被挂载到非标准路径,如 /public/home/username。插件未正确识别实际路径时,会尝试在默认路径下创建 .vscode-server 目录,导致权限错误,从而触发认证回退。

错误逻辑链

  1. VSCode 尝试连接远程服务器
  2. 自动检测家目录路径 /home/username
  3. 在错误路径下创建 .vscode-server
  4. 权限不足导致安装失败
  5. 认证回退提示输入密码或者抛出 Permission denied 错误

解决方案

  1. 安装 Remote-SSH 插件;

  2. 生成并上传密钥;
    (1)打开终端,输入【ssh-keygen】,连按【三次回车】即可;
    在这里插入图片描述
    (2)打开密钥存放位置,将【.pub】后缀结尾的【公钥】上传至服务器的【~/.ssh】目录下;
    (3)将【公钥】内容写入【authorized_keys】文件中,如果没有该文件,直接新建并写入;

    # 新建 authorized_keys 文件
    touch ~/.ssh/authorized_keys
    # 公钥内容写入 authorized_keys 文件中
    cat id_ed25519.pub >> ./authorized_keys
    
  3. 更改文件权限;

    # 新建 authorized_keys 文件
    chmod 700 ~/.ssh
    # 公钥内容写入 authorized_keys 文件中
    chmod 600 ~/.ssh/authorized_keys
    
  4. 强制指定 VSCode 服务器安装路径(关键)
    (1)按快捷键【Ctrl + , 】打开 VSCode 配置;
    (2)搜索【settings】,点击【在settings.json 中编辑】;
    在这里插入图片描述
    (3)修改【remote.SSH.serverInstallPath】(如果没有该配置直接添加),替换【your_remote_hostname】 和【your_node_name】为你的主机名和实际路径;

    {
      "remote.SSH.serverInstallPath": {
        "your_remote_hostname": "/public/home/your_node_name/.vscode-server"
      }
    }
    

(4)保存并关闭。

  1. 添加本地 SSH 配置(主机名、用户名、端口号、密钥文件路径)
    在这里插入图片描述
    在这里插入图片描述
  2. 点击连接。

  到此连接问题就已经完美解决辣!

总结

  本文主要解决了 VSCode 远程连接超算集群时出现的认证异常问题。引发该问题的主要原因是 VSCode 默认在标准家目录(/home/username)下创建.vscode-server,但超算集群实际家目录位于 ​​/public/home/username​​,导致插件在错误路径初始化时触发认证回退,解决该问题的方法也很简单,只需要手动指定 VSCode 服务器的安装路径即可解决!


网站公告

今日签到

点亮在社区的每一天
去签到