VSCode SSH 远程连接卡在下载 Server 问题的解决方案

问题描述

在使用 VSCode 进行 SSH 远程连接服务器时，如果一直卡在下载 "vscode server" 阶段，通常是由于网络限制导致无法访问官方资源。若使用 MobaXterm 等终端工具可正常连接，则基本确认为网络问题。

方法 1：配置代理

在下载 vscode server 时，若国内网络受限，需要配置代理网络，之后即可正常连接。

方法 2：手动下载部署

如果无法配置代理，可以手动下载 vscode server 包并上传至服务器安装。

步骤 1：获取 Commit ID

在 VSCode 终端输出信息页面，按 Ctrl+F 搜索 "commitId"，记录 commitId 后面的一串字符（如下图所示）。

步骤 2：构建下载链接

将记录的 commitId 替换以下 URL 中的变量，并在浏览器中下载 vscode server 包：

https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable

步骤 3：上传与解压

使用 MobaXterm 或类似远程终端连接服务器，切换到 ~/.vscode-server/bin 目录（若 .vscode-server 在其他位置请切换至对应目录），然后进入 bin 目录。

将本地下载的 vscode-server-linux-x64.tar.gz 传入该目录下，执行以下命令：

tar xzvf vscode-server-linux-x64.tar.gz

步骤 4：重命名目录

执行以下命令替换目录名称，注意将 ${commitid} 替换为第一步记录的 ID：

mv vscode-server-linux-x64 ${commitid}

完成后关闭 VSCode 重新打开连接即可。

方法 3：排查网络环境

如果上述方法仍无法连接，可能是本地或服务器网络环境问题。建议尝试切换 WiFi、使用移动数据或其他网络环境进行测试。有时等待网络恢复后也可自动解决。