Remote-SSH连接卡在下载vscode-server？3步搞定离线安装（附国内镜像地址）

Remote-SSH连接卡顿的终极解决方案：离线安装vscode-server全指南

每次打开VS Code准备远程开发时，看着进度条卡在"正在下载vscode-server"的界面，是不是感觉时间仿佛凝固了？特别是在国内网络环境下，这个等待过程可能长达数十分钟甚至直接失败。作为开发者，我们最宝贵的就是时间，而这个问题恰恰在无情地消耗着我们的开发效率。

1. 为什么Remote-SSH需要vscode-server

当使用VS Code的Remote-SSH功能连接远程服务器时，实际上是在服务器端安装了一个轻量级的服务端组件——vscode-server。这个组件负责处理本地编辑器与远程服务器之间的通信，使得我们能够在本地获得近乎原生的开发体验。

vscode-server的安装过程通常包括以下步骤：

1. VS Code客户端检测服务器端是否已安装匹配版本
2. 如未安装，则从微软官方服务器下载对应版本
3. 自动解压并配置到~/.vscode-server/bin/目录
4. 启动服务端进程，建立连接

问题就出在第二步——由于微软的更新服务器位于海外，国内开发者经常会遇到：

• 下载速度极慢（几十KB/s）
• 连接超时失败
• 完全无法访问

更令人沮丧的是，即使你之前成功安装过，当VS Code客户端更新后，又需要重新下载匹配版本的vscode-server，这个过程会反复折磨你。

2. 获取关键信息：commit_id的三种方法

要手动安装vscode-server，首先需要获取当前VS Code版本对应的commit_id。这个ID是版本控制的唯一标识，相当于特定版本vscode-server的身份证号。

2.1 通过VS Code输出面板获取

这是最直接的方法：

1. 在VS Code中尝试连接远程服务器
2. 当卡在下载界面时，点击底部状态栏的"输出"面板
3. 在输出面板的下拉菜单中选择"Remote-SSH"
4. 查找类似这样的日志信息：

Installing to /home/user/.vscode-server/bin/f1b07bd25dfad64b0167beb15359ae573aecd2cc...

其中f1b07bd25dfad64b0167beb15359ae573aecd2cc就是我们要找的commit_id。

2.2 通过VS Code帮助菜单查询

如果尚未尝试连接，也可以通过以下方式获取：

1. 打开VS Code
2. 点击顶部菜单"帮助"→"关于"
3. 在弹出窗口中查找"提交"一行，后面的哈希值就是commit_id

2.3 通过命令行查询

对于喜欢终端操作的用户：

code --version | grep -E '^[0-9a-f]{40}$'

这个命令会输出当前VS Code版本的完整commit_id。

3. 国内镜像下载与手动安装

获取commit_id后，我们就可以绕过官方服务器，从国内镜像快速下载所需文件。

3.1 国内镜像地址

目前可用的国内镜像包括：

将URL中的{commit_id}替换为你实际获取的值即可。

3.2 下载与传输

根据你的网络环境，可以选择以下任一方式：

本地下载后上传到服务器

1. 在浏览器或下载工具中打开镜像URL
2. 下载vscode-server-linux-x64.tar.gz文件
3. 使用SCP命令上传：

scp vscode-server-linux-x64.tar.gz user@remote-server:/tmp/

直接在服务器下载

如果服务器可以访问国内镜像：

wget https://vscode.cdn.azure.cn/stable/f1b07bd25dfad64b0167beb15359ae573aecd2cc/vscode-server-linux-x64.tar.gz -O /tmp/vscode-server-linux-x64.tar.gz

3.3 服务器端安装步骤

无论采用哪种传输方式，最终都需要在服务器上执行以下操作：

1. 创建目标目录（如果不存在）：

mkdir -p ~/.vscode-server/bin

2. 清理可能存在的旧版本（重要！）：

rm -rf ~/.vscode-server/bin/${commit_id}

3. 解压下载的压缩包：

tar -xzf /tmp/vscode-server-linux-x64.tar.gz -C ~/.vscode-server/bin/

4. 重命名解压后的目录：

mv ~/.vscode-server/bin/vscode-server-linux-x64 ~/.vscode-server/bin/${commit_id}

5. （可选）清理临时文件：

rm /tmp/vscode-server-linux-x64.tar.gz

4. 验证与故障排除

完成手动安装后，重新启动VS Code并尝试连接远程服务器。如果一切正常，应该能够立即建立连接，不再有漫长的等待。

如果仍然遇到问题，可以检查以下几点：

1. 权限问题：确保~/.vscode-server目录及其内容对当前用户可读写
2. 版本不匹配：确认本地VS Code版本与服务器端安装的commit_id完全一致
3. 目录结构：检查~/.vscode-server/bin/${commit_id}目录下是否包含完整的vscode-server文件
4. 残留文件：有时候旧的日志文件可能导致问题，可以尝试删除：

rm -f ~/.vscode-server/.${commit_id}.log

对于团队开发环境，可以考虑将vscode-server的安装包预先部署在内部文件服务器上，或者创建自动化脚本简化安装过程。这样不仅能够节省每位开发者的时间，还能确保团队使用统一版本的开发环境。