VS Code Remote Server连接失败：下载VS Code Server返回404错误

排查与修复步骤 #

• 严格匹配VS Code Server与本地客户端版本
  手动安装时必须保证服务器端版本和本地VS Code完全一致，包括正式版/预览版的差异。本地版本可通过「帮助 -> 关于」查看，格式类似1.89.1，同时要记录版本对应的哈希值（如dc96b837cf6bb4af9cd736aa3af08cf8279f7685）。
  手动安装操作：

  1. 下载对应架构（x64/arm64等）的VS Code Server压缩包
  2. 在服务器上创建目录~/.vscode-server/bin/<版本哈希值>
  3. 上传压缩包到该目录并解压，确保server.sh等核心文件存在
  4. 重启本地VS Code后重新发起连接

• 检查服务器端网络访问限制
  SSH能连接不代表wget可访问外部资源，HPC可能有内网规则限制。直接在服务器上执行wget <VS Code Server官方下载链接>，验证是否能正常获取文件：

  • 若失败，检查服务器的http_proxy/https_proxy环境变量配置是否正确
  • 咨询HPC管理员是否有内部镜像源可替代官方下载地址

• 修改Remote SSH的下载源模板
  在本地VS Code设置中搜索remote.SSH.serverDownloadUrlTemplate，将默认官方链接替换为国内镜像源，示例格式：https://vscode.cdn.azure.cn/stable/{commit}/vscode-server-linux-x64.tar.gz，其中{commit}替换为本地VS Code的版本哈希值

• 清理缓存重置连接状态

  • 本地：删除~/.vscode/extensions/ms-vscode-remote.remote-ssh-<版本号>下的临时文件
  • 服务器：删除~/.vscode-server/整个目录，重新触发自动安装流程

额外提示 #

若以上步骤无效，可尝试降级本地VS Code到稳定旧版本（部分预览版可能存在兼容问题）；或联系HPC管理员确认是否有防火墙规则拦截了VS Code Server的下载请求。

内容的提问来源于stack exchange，提问作者Jia Zheng Robert