原文： vscode 1.99 后无法连接到 ubuntu 18.04 | Akkuman 的技术博客

背景

vscode 远程开发出现报错 The remote host doesn’t meet the prerequisites for running VS Code Server（远程主机不满足运行VS Code服务器的先决条件）

根本原因

早在2023年还是2024年初，vscode 就出过一次这种问题，官方的主要目的是放弃对低版本系统的支持。不过当时没有任何通知，比较突然，后续官方发了一个修复版本，让大家可以继续使用低版本系统到 2025 年第一季度，给了大家一定的时间去升级系统。

然后官方在 1.97 的 changelog 中决定在 1.99 后将不允许连接到低版本系统进行远程开发。

不过官方也给出了解决方案

参见 https://aka.ms/vscode-remote/faq/old-linux

250622 之后的解决方案

现在似乎又出问题了，最稳定的还是使用 linuxbrew。这里给出基于 linuxbrew 的解决方案，此处使用 bash 举例，如果你是 zsh 等环境，可以参见 homebrew | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

echo >> ~/.bashrc
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/brew.git"' >> ~/.bashrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/homebrew-core.git"' >> ~/.bashrc
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.aliyun.com/homebrew-bottles/api"' >> ~/.bashrc
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles"' >> ~/.bashrc
source ~/.bashrc
export HOMEBREW_INSTALL_FROM_API=1
# 从阿里云下载安装脚本并安装 Homebrew 
git clone https://mirrors.aliyun.com/homebrew/install.git brew-install
/bin/bash brew-install/install.sh
rm -rf brew-install
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
source ~/.bashrc

如果是海外环境，直接使用 /bin/bash -c "$(curl -fsSL https://github.com/Homebrew/install/raw/master/install.sh)"​ 即可

然后使用命令 brew install patchelf​ 安装 patchelf

然后执行如下命令

1
2
3
4
5

echo 'VSCODE_SERVER_CUSTOM_GLIBC_PATH=/home/linuxbrew/.linuxbrew/opt/glibc/lib' >> ~/.ssh/environment
echo 'VSCODE_SERVER_PATCHELF_PATH=/home/linuxbrew/.linuxbrew/bin/patchelf' >> ~/.ssh/environment
echo 'VSCODE_SERVER_CUSTOM_GLIBC_LINKER=/home/linuxbrew/.linuxbrew/opt/glibc/lib/ld-linux-x86-64.so.2' >> ~/.ssh/environment
sudo sed -i 's|#PermitUserEnvironment no|PermitUserEnvironment yes|g' /etc/ssh/sshd_config
sudo systemctl restart sshd

旧版解决方案

官方给出的解决方案是先使用 crosstool 弄出一个高版本 glibc 的环境，然后使用 patchelf 来自动 patch

不过这个方案需要拿 crosstool 自己编译，也挺麻烦

有人给出了可以使用 brew 安装 glibc 和 patchelf，参见 Connect to Unsupported Older Linux servers with VS Code Remote-SSH using Custom glibc & libstdc++ - DEV Community

但是 brew 是一个 ruby 工具，安装也挺麻烦。

下面给出一种更简单的方案

下载 glibc

1
2
3
4

# 下载 glibc bottle
curl --disable --cookie /dev/null --globoff --show-error --fail --progress-bar --retry 3 --header 'Authorization: Bearer QQ==' --location --remote-time --output glibc.bottle.tar.gz "https://ghcr.io/v2/homebrew/core/glibc/blobs/sha256:91e866deda35d20e5e5e7a288ae0902b7692ec4398d4267c74c84a6ebcc7cdd9"
# 将 glibc/2.35_1 放到 /opt 下
sudo tar -xzf glibc.bottle.tar.gz -C /opt

下载 patchelf

打开 Releases · NixOS/patchelf 下载合适的 patchelf

然后解压出来，将 bin/patchelf 放置到主机上的 /usr/local/bin/patchelf

配置环境变量

然后将以下内容写入到 ~/.ssh/environment 中

1
2
3

VSCODE_SERVER_CUSTOM_GLIBC_LINKER=/opt/glibc/2.35_1/lib/ld-linux-x86-64.so.2
VSCODE_SERVER_CUSTOM_GLIBC_PATH=/opt/glibc/2.35_1/lib:/usr/lib/x86_64-linux-gnu:/lib/x86_64-linux-gnu
VSCODE_SERVER_PATCHELF_PATH=/usr/local/bin/patchelf

然后执行如下命令开启 ssh 环境变量

1
2

sudo sed -i 's|#PermitUserEnvironment no|PermitUserEnvironment yes|g' /etc/ssh/sshd_config
sudo systemctl restart sshd

构造搜索路径

注意该步骤是必要的，否则会出现终端无法打开的问题

1
2

sudo mkdir -p /home/linuxbrew/.linuxbrew/Cellar
sudo ln -s /opt/glibc /home/linuxbrew/.linuxbrew/Cellar/glibc

重要的题外话

考虑到后面也可能出现同样的问题（linuxbrew 预编译的 glibc 有预置的库搜索路径）导致一些功能缺失，建议直接安装 linuxbrew + glibc 来使用。国内可参见 homebrew | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror 来安装，然后按照 Connect to Unsupported Older Linux servers with VS Code Remote-SSH using Custom glibc & libstdc++ - DEV Community 中的来进行配置即可

重新测试

然后重新连接即可

如果不成功，请 ssh 登录到远程机器，执行 env | grep VSCODE​ 确认一下环境变量，如果不是这个，请检查你远程主机上的下列文件

  • ​~/.bashrc​
  • ​/etc/environment​
  • ​~/.profile​
  • ​~/.zprofile​
  • ​~/.bash_profile​

查看是否有包含上述环境变量，如果存在就删除

参考链接

‍