VS Code Remote-SSH 离线安装详解(含 VSIX 插件包下载与安装步骤)
目录
一、适用场境
二、准备工作
三、windows端安装步骤
四、安装 Linux 端的 VS Code Server
摘要:本文介绍了在离线环境下安装和使用VSCode+Remote-SSH的方法。主要步骤包括:在联网电脑下载Remote-SSH插件并导出VSIX安装包;在离线电脑离线安装插件;获取VSCode的CommitID;下载VSCodeServer并手动部署到Linux服务器。通过这套方案,可以在无法联网的环境中实现本地VSCode远程编辑服务器代码的功能,提升开发效率。文中还提供了详细的安装步骤和网盘资源下载链接。
在日常开发中,经常需要登录服务器写代码。最常见的办法是直接用 ssh 登录,再配合 vim 或 nano 编辑器。但这种方式对习惯图形化 IDE 的同学来说并不方便:编辑体验有限,代码补全不完善,调试也不直观。
VS Code 提供的 Remote-SSH 插件 正好解决了这个问题。通过它,可以在本地 VS Code 里直接打开远程服务器上的代码,就像操作本地项目一样,编辑、调试都能顺利完成。
不过问题也随之而来:在一些离线环境,Remote-SSH 无法联网下载和安装依赖,导致功能用不上。这篇文章就来介绍一下,如何在离线环境下安装和使用 VS Code + Remote-SSH。
一、适用场境
本文主要适用于这样一种场景:
-
开发电脑是 Windows 系统,平时通过
ssh登录到一台 Linux 服务器,在上面写代码、调试程序。 -
希望借助 VS Code + Remote-SSH 替代vim等编辑工具,来提升效率。
-
Windows 电脑和 Linux 服务器都处在无法联网的环境,没办法直接通过插件市场下载安装需要的扩展。
二、准备工作
1. 一台联网的Windows 电脑
这台机器的主要作用是去外网下载所需的软件和扩展包,然后再通过 U 盘或者其他方式拷贝到离线环境里。
2. VS Code 安装包
本文的版本是1.103.2,不同版本的步骤基本相同(不过太老的版本不适用本方案)。
VS Code 官网安装包下载链接:
https://code.visualstudio.com/Download
三、windows端安装步骤
为了区分,用 A 表示可以联网的 Windows 电脑,用 B 表示无法联网的 Windows 电脑。
1. 在两台电脑上都安装好步骤二中准备的VS Code,确保两个环境安装的是同一版本的vscode。
2. 在A设备上安装 Remote-SSH 插件,并导出 VSIX 文件
打开A设备上的 VS Code,点击左侧这个图标,进入扩展。

搜索并安装 Remote-SSH 插件,自动联网安装。

最后实际安装了三个插件。Remote-SSH、Remote-SSH:Edit Confiuration Files、Remote Explorer。

安装完成后,点击插件右下角的小齿轮,选择 “Download VSIX”。三个插件都按此方法下载。

补充说明:Remote-SSH插件的网址是:
https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh
但我没有找到直接下载的方法,所以采用上面的方式来为离线设备准备插件的安装文件。
3. 在B设备上离线安装 Remote-SSH 插件
把A设备上导出的三个vsix 文件拷贝到无法联网的B设备。
在B设备上打开 VS Code,点击左侧扩展按钮 → 右上角“…” → 选择 “Install from VSIX...”,依次安装三个插件。

四、安装 Linux 端的 VS Code Server
当我们在本地 VS Code 中使用 Remote-SSH 连接远程服务器时,VS Code 并不能直接“远程打开”文件,需要在服务器上运行一个小型的后台服务程序,这就是 VS Code Server。
VS Code Server 的作用,可以简单理解为:
-
它在远程服务器上运行,负责和本地 VS Code 通信;
-
把本地的编辑器界面、插件功能、调试工具“映射”到远程环境;
通常情况下,VS Code 第一次连接远程服务器时,远程服务器自动联网下载并安装 VS Code Server。但在离线环境中,这一步就会失败,所以需要手动把 VS Code Server 打包好,拷贝到服务器上。
具体操作步骤:
1. 获取 VS Code 的 Commit ID
在离线安装 VS Code Server 时,需要确保下载的版本和本地 VS Code 匹配。这个版本信息用 Commit ID 来标识。
获取方法:在Windows 设备(因为设备A和B安装的vscode的版本相同,所以Commit ID也相同,为了复制方便,建议使用可联网设备A查看)上打开 VS Code,然后点击菜单 Help → About。
弹出的对话框中大概是长这样的:

其中的 Commit 后面的一串字符就是我们需要的 Commit ID。记下这个ID,后面下载 Linux 端 VS Code Server 时就要用到它。
2.下载vscode server软件
需要下载两个软件:
vscode_cli_alpine_x64_cli.tar.gz 的下载链接(commit ID要换成你的版本的):
https://update.code.visualstudio.com/commit:6f17636121051a53c88d3e605c491d22af2ba755/cli-alpine-x64/stable
vscode-server-linux-x64.tar.gz 的下载链接(commit ID要换成你的版本的):
https://update.code.visualstudio.com/commit:6f17636121051a53c88d3e605c491d22af2ba755/server-linux-x64/stable
3.Linux服务器端安装vscode-server
把下载好的两个文件拷贝到Linux服务器。先做准备工作,创建目录:
mkdir ~/.vscode-server/
解压
tar -xzf vscode_cli_alpine_x64_cli.tar.gz
解压后,只有一个可执行文件:code,将文件code拷贝到~/.vscode-server/目录。并重命名(后面添加的是Commit ID,要改成你的版本):
mv code code-6f17636121051a53c88d3e605c491d22af2ba755
在 Linux 服务器上,手动创建 VS Code Server 的安装目录。
同样,要把如下目录中的Commit ID改成你自己的版本:
可以逐层创建,确保每一级目录都存在。完整路径如下:
~/.vscode-server/├── cli/└── Servers/└── Stable-6f17636121051a53c88d3e605c491d22af2ba755/└── server/
也可以在命令行中使用 mkdir -p 一次性创建所有目录:
mkdir -p ~/.vscode-server/cli/Servers/Stable-6f17636121051a53c88d3e605c491d22af2ba755/server
将vscode-server文件拷贝到上一步中创建的目录,并解压到当前目录。
tar -xzf vscode-server-linux-x64.tar.gz --strip-components 1
到此,就安装完成啦,接下来就可以使用Remote-SSH了。撒花~~~
文章里用到的vscode和remote-ssh相关安装文件已上传百度网盘。
通过网盘分享的文件:vscode+Remote-SSH
https://pan.baidu.com/s/1gRpYxOPzmjsaRY63VAHrgw?pwd=bcsj
下一篇,打算写下怎么使用Remote-SSH远程,以及怎么用它更方便的编辑运行python代码,会涉及相关工具的安装和使用。
写在最后
大家好,这里是[编程实践录],一个热衷于分享实用开发技巧的技术博客。
写一篇高质量文章不易,如果这篇文章确实帮助到了你,希望可以点赞、收藏、关注一下,这也是我持续创作的最大动力!
当然,我更推荐你来我的公众号【编程实践录】找我。
为什么?因为在那里,除了所有文章的首发,还可以得到:
深度交流:你可以随时在公众号后台向我提问,我都会逐一回复。
硬核干货:更多关于编程实践的独家技巧和思考。
在微信搜索框里,直接搜索“编程实践录”,就可以找到我。我们换个地方,聊点更深的!











