VS Code无法通过SSH连接远程主机，请求技术解决方案

1. 配置远程扩展安装到非Home目录 #

由于学校IT明确禁止在空间有限的Home目录安装扩展，直接指定远程服务器的VS Code Server安装路径到有充足空间的目录：

• 打开VS Code设置（快捷键Ctrl+,），搜索remote.SSH.serverInstallPath
• 点击「编辑 in settings.json」，添加如下配置（替换占位符）：

  "remote.SSH.serverInstallPath": {
    "user@your-remote-host": "/path/to/available-storage/.vscode-server"
  }
  

• 登录远程主机，提前创建并配置目录权限：

  mkdir -p /path/to/available-storage/.vscode-server
  chmod 700 /path/to/available-storage/.vscode-server
  

2. 手动部署VS Code Server到远程主机 #

自动安装失败时，手动下载对应版本的Server包部署：

• 本地VS Code按Ctrl+Shift+P，执行Remote-SSH: Show Local SSH Log，找到日志中的Remote server version: xxxxxxxx（xxxxxxxx为版本哈希值）
• SSH登录远程主机，执行以下命令（替换版本哈希和系统架构，如linux-x64）：

  cd /path/to/available-storage
  wget https://update.code.visualstudio.com/commit:xxxxxxxx/server-linux-x64/stable
  mkdir -p .vscode-server/bin/xxxxxxxx
  unzip stable -d .vscode-server/bin/xxxxxxxx
  chmod -R 700 .vscode-server
  rm stable
  

3. 清除本地VS Code远程缓存 #

本地残留的缓存可能干扰连接：

• 完全关闭VS Code
• 删除本地远程缓存目录：
  • Windows：%USERPROFILE%\.vscode\extensions\ms-vscode-remote.remote-ssh-*\out\server
  • macOS/Linux：~/.vscode/extensions/ms-vscode-remote.remote-ssh-*/out/server
• 重新打开VS Code，尝试连接远程主机

4. 检查远程主机的安全限制 #

Linux主机的SELinux或AppArmor可能阻止目录创建：

• 临时关闭SELinux测试：sudo setenforce 0，之后尝试连接
• 若连接成功，联系学校IT配置SELinux规则，允许VS Code Server的目录操作

5. 强制重置远程连接状态 #

• VS Code中按Ctrl+Shift+P，执行Remote-SSH: Kill Connection to Host，选择目标主机
• 再执行Remote-SSH: Connect to Host，触发全新的连接初始化流程

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