VS Code远程连接Ubuntu失败：LocalDownloadFailed错误求助

问题复盘 #

• 环境：Windows VS Code 远程连接Ubuntu，离线安装场景
• 核心报错：[LocalDownloadFailed]: Error: LocalDownloadFailed (Failed to download VS Code Server (Failed to fetch))
• 附加现象：Ubuntu端wget下载Server文件权限拒绝；systemctl status ssh显示连接请求被立即取消；已按离线教程部署VS Code Server仍无效

针对性排查与解决步骤 #

1. 确认VS Code Server离线包的匹配性 #

• 必须保证离线包版本完全匹配本地VS Code版本：
  1. 打开本地VS Code，按Ctrl+Shift+P输入About: About查看版本号（例如1.89.1）
  2. 离线包命名格式应为vscode-server-linux-x64-{版本号}.tar.gz，版本不匹配会直接导致连接失败
• 将离线包放到Ubuntu端的~/.vscode-server/bin/{版本哈希值}目录下（哈希值可在VS Code连接失败的日志中找到，即commit: xxxxxxxx对应的字符串）：
  • 目录不存在则手动创建：mkdir -p ~/.vscode-server/bin/{版本哈希值}
  • 解压包到该目录：tar -xzf vscode-server-linux-x64-{版本号}.tar.gz -C ~/.vscode-server/bin/{版本哈希值} --strip-components 1

2. 修复Ubuntu端SSH权限与连接问题 #

连接请求被立即取消，大概率是SSH配置或权限异常：

• 检查并修正SSH核心配置：
  1. 编辑/etc/ssh/sshd_config，确保以下配置项正确：

     PermitRootLogin no # 用普通用户连接保持no；用root连接改为yes（不推荐）
     PasswordAuthentication yes # 密码连接需设为yes；密钥连接可保持no
     AllowUsers {你的用户名} # 添加允许连接的用户，例如`AllowUsers ubuntu`
     

  2. 重启SSH服务：sudo systemctl restart sshd
• 修正用户目录与Server目录权限：
  • 普通用户~目录权限设为700：chmod 700 ~
  • .vscode-server目录权限设为755：chmod -R 755 ~/.vscode-server
• 排查防火墙限制：
  • 确保Ubuntu防火墙允许22端口：sudo ufw allow 22（使用ufw时）；若用iptables，对应开放22端口规则

3. 强制跳过自动下载，使用离线Server #

VS Code默认会尝试自动下载Server，离线场景需强制禁用该行为：

• 在本地VS Code的settings.json中添加配置：

  "remote.SSH.serverDownloadUrl": "",
  "remote.SSH.showLoginTerminal": true
  

• 连接时弹出终端后，手动确认Ubuntu端~/.vscode-server/bin/{版本哈希值}目录下存在完整的Server文件，若终端提示下载，直接中断并检查文件完整性

4. 验证VS Code Server可用性 #

• 在Ubuntu端执行：~/.vscode-server/bin/{版本哈希值}/bin/code-server --version，能正常输出版本号则说明Server本身无问题
• 若执行时提示权限错误，给执行文件添加权限：chmod +x ~/.vscode-server/bin/{版本哈希值}/bin/code-server

内容的提问来源于stack exchange，提问作者123 456