远程服务器离线安装vscode及扩展组件
1. 场景
本地(Windows 10)安装了vscode
,因为环境、资源等都是在服务器上(Ubuntu),因此想要通过vscode远程连接服务器,实现在本地操作服务器的目标。vscode在2019年对上述目标的支持已经很完(sha)善(gua)了,只需要安装几个和Remote
相关的扩展插件(Extensions)就可以了,可以通过图形界面一键安装,这里不再赘述了,我在前期使用的时候也很顺畅。
后来远程服务器网络出现了一些问题,可以正常本地建立连接,但在使用一些常见的更新管道(pip,wget,apt-get等)时总是会超时致使更新失败。可以简单地认为,“远程服务器只能只能建立内网链接,无法访问外网了”。
本来不耽误使用,内网就内网反正环境啥的都配好了也不碍事,就没管它,直到有一天发现本地vscode无法连接到远程服务器了
,核心报错如下:
Waiting for /home/user/.vscode-server/bin/a0479759d6e9ea56afa657e454193f72aef85bd0/vscode-scp-done.flag and vscode-server.tar.gz to exist
...... ......
...... ......
.vscode-server/bin/a0479759d6e9ea56afa657e454193f72aef85bd0: No such > file or directory
2. 问题分析
核心问题是 vscode-server下的某个文件夹不存在
,看这一大长字符串,猜测是版本号相关的描述。首先查看了一下本地vscode的版本号,Help-->About,发现是1.48.2版本,也就是官网上的最新版本,那么问题就已经定位出来了:windows本地的服务器自动更新版本,而远程服务器并没有进行相应的更新(大概率是因为网络问题),导致服务器和本地vscode —— vscode_server版本不匹配,因而无法成功建立连接。vscode在不同系统中的更新机制如下图所示,如果本地和服务器的外网网络都十分通畅,可以不用管,否则建议把本地的 update.mode
参数设置为 none,防止本地自动更新导致版本不匹配的问题。
官网对vscode更新的相关描述
3. 问题解决
手动下载a0479759d6e9ea56afa657e454193f72aef85bd0
文件夹,并放在报错信息中指定的位置。下载可直接通过链接下载:
https://update.code.visualstudio.com/commit:26076a4de974ead31f97692a0d32f90d735645c0/server-linux-x64/stable
注意::根据报错信息,修改上述链接你所需要的commit id,然后再下载,这一步骤更详细的教程可以参照:手动下载与放置文件夹
注意:按教程将文件夹放置好后,可能需要给整个文件夹赋读写权限,我这边不赋权限是会报错:
chmod -x -R a0479759d6e9ea56afa657e454193f72aef85bd0
# 我直接赋 root 的全部权限了,如果账号没有root权限可以把-R去掉
4. 手动下载扩展插件(Extensions)
在vscode上主要进行python开发,必不可少的一个库是Python extension for Visual Studio Code
,有了这个库,我们可以自由地切换和使用远程服务器(或本地)的python环境,并使用语法检查、函数与类的跳转等方便的功能,最新版本的python extension还可以支持在vscode中使用jupyter notebook,简直不要太方便,然而这个库也被我整甭了,原因大致可以描述为我有使用最新版本的强迫症,vscode extension也需要本地和远程服务器的版本对齐,我只能更新本地的python插件,而无法一键更新远程服务器上的python插件。vscode python插件官网
解决方法和之前的类似,也是本地手动下载-->传到服务器上-->手动安装
这一套流程。庆幸地是vscode为我们提供了VSIX的离线安装方式
,不需要再从源码编译。[官网的描述如下:]
我的具体操作是:
- 在本地下载python扩展插件的vsix文件
ms-python-release.vsix
,并上传到远程服务器 - 为服务器上的vsix文件赋权限:
chmod -x -R ms-python-release.vsix
- 在vscode中,ctrl+shift+p打开命令行,输入
Extensions: install from VSIX
,选中上一步上传好的 vsix 文件,开始安装 - 重启 vscode,正常使用 python 插件
python extension 的 vsix 文件可以在github上下载:https://github.com/Microsoft/vscode-python/releases
5. 总结
网上的问答帖(stackoverflow、github)、博客(SCDN等)可以帮助我们快速定位问题并找到解决办法,但最准确的问题定位方式离不开耐心分析报错信息
,完整的解决问题则离不开官方API和教程
。
遇到问题,分析问题,解决问题,记录过程。