Linux离线安装VSCode Server及解决Remote-SSH下载失败问题
解决VSCode Remote-SSH离线安装失败及Linux离线部署VSCode Server的问题
你遇到的问题本质是远程主机无法联网,加上自动下载时的证书域名不匹配,导致VSCode Server自动安装流程失败。咱们直接通过离线手动部署VSCode Server就能搞定,具体步骤如下:
一、先提取关键版本信息
从你的错误日志里,已经能拿到两个核心信息:
- VSCode的commit ID:
daf71423252a707b8e396e8afa8102b717f8213b - 版本类型:
insider(内测版,稳定版会显示stable)
二、离线下载对应版本的VSCode Server包
在能联网的机器上,根据远程Linux主机的架构(比如x64、arm64等),下载匹配的Server安装包:
- 若你用的是Insider版本,下载链接格式为:
https://update.code.visualstudio.com/commit:<commit-id>/server-linux-<架构>/insider
比如x64架构就替换成server-linux-x64,把<commit-id>换成上面拿到的ID。 - 若是稳定版,把链接里的
insider换成stable,后续目录也要对应改成.vscode-server而非.vscode-server-insiders。
三、将安装包传到远程主机
用scp命令(或SFTP、文件传输工具)把下载好的tar.gz包传到远程主机,示例命令:
scp vscode-server-linux-x64.tar.gz your-username@kf:/home/your-username/
四、在远程主机上手动部署
创建VSCode Server的专属目录:
mkdir -p ~/.vscode-server-insiders/bin/daf71423252a707b8e396e8afa8102b717f8213b/(稳定版请把
.vscode-server-insiders替换为.vscode-server)解压安装包到刚创建的目录,注意添加
--strip-components 1去掉包内的顶层目录:tar -xzf vscode-server-linux-x64.tar.gz -C ~/.vscode-server-insiders/bin/daf71423252a707b8e396e8afa8102b717f8213b/ --strip-components 1创建标记文件,告诉VSCode该版本Server已安装完成,避免重复触发自动下载:
touch ~/.vscode-server-insiders/bin/daf71423252a707b8e396e8afa8102b717f8213b/0
五、重启Remote-SSH连接
关闭VSCode里的远程连接窗口,重新通过Remote-SSH连接到kf主机,这时候就能正常建立远程会话了。
额外注意事项
- 必须保证本地VSCode的版本和远程Server的commit ID完全一致,否则会出现兼容性问题。你可以在本地VSCode的
帮助->关于里查看自己的commit ID,确保和远程部署的版本匹配。 - 如果远程主机是ARM架构(比如树莓派),要下载对应
server-linux-arm64的包,别选错架构。
内容的提问来源于stack exchange,提问作者ehds




