使用VSCode Remote-SSH扩展时远程SSH服务器扩展安装失败如何解决

核心原因 #

默认配置下Remote-SSH会要求远程Linux服务器直接请求VSCode扩展市场、vscode-server的公网下载地址，企业防火墙通常会拦截这类公网请求，可通过以下三种方案修复：

方案1：配置本地代理转发（最推荐，无需操作远程服务器） #

• 先确认本地Windows设备已配置可正常访问公网的代理，记录代理地址与端口，例如127.0.0.1:10809
• 打开VSCode设置页，搜索Remote.SSH: Proxy Server，填入你的本地代理地址
• 勾选Remote.SSH: Enable Dynamic Proxy选项，开启后VSCode会自动将远程侧的公网请求通过本地SSH隧道转发，无需远程服务器单独调整网络配置
• 重启VSCode后重新连接远程SSH即可正常下载vscode-server与扩展

方案2：离线手动安装 #

无可用代理时可使用该方案：

扩展离线安装 #

• 本地Windows端打开VSCode扩展市场，找到需要安装的扩展，进入扩展详情页后点击下载扩展，获取后缀为.vsix的安装包
• 通过scp、sftp等内网文件传输工具，将.vsix包上传到远程Linux服务器的任意目录，例如/tmp/xxx.vsix
• 连接远程SSH后，打开VSCode扩展面板，点击面板顶部的更多按钮（三个点），选择从VSIX安装，选中上传的安装包确认即可完成安装

vscode-server离线安装 #

如果是首次连接时vscode-server下载失败：

• 查看本地VSCode的版本commit号：点击VSCode菜单栏帮助-关于，复制commit id字符串
• 本地下载对应commit号的vscode-server-linux安装包，通过scp传到远程服务器~/.vscode-server/bin/[commit_id]/目录下，执行tar -zxf vscode-server-linux-x64.tar.gz --strip-components 1解压即可

方案3：远程服务器配置全局代理 #

如果有权限调整远程Linux服务器的网络配置，可直接为服务器配置代理：

• 编辑远程服务器当前用户的环境变量配置文件，例如~/.bashrc或~/.zshrc，添加以下内容，替换为可用的代理地址：

export http_proxy=http://你的代理地址:端口
export https_proxy=http://你的代理地址:端口
export no_proxy=localhost,127.0.0.1,企业内网域名段

• 执行source ~/.bashrc使配置生效后，重新连接VSCode Remote-SSH即可

内容的提问来源于stack exchange，提问作者neves