当前位置： 首页 > web >正文

通过VSCode远程连接到CentOS7/Ubuntu18等老系统

web 2025/7/1 11:52:25

通过VSCode远程连接到CentOS7/Ubuntu18等老系统

背景

VSCode的远程连接插件Remote SSH一直以来是简单好用的远程工具。然而，2025年2月之后的版本在远程安装vscode-server时，预编译的server依赖glibc 2.28，这就要求Linux远程机的glibc版本应不低于2.28，进而导致CentOS 7（glibc版本2.17），Ubuntu 18（glibc版本为2.27）都无法再使用VSCode的Remote SSH插件远程。

本文介绍两种解决方案：一是使用老版本VSCode；二是打补丁方案。

1. 最简单方案：换老版本VSCode(<=1.85)

请参考知乎文章

2. 补丁方案

该方案的操作流程如下：编译Crosstool-ng工具，并设置环境变量；下载.config文件，编译glibc2.28；配置sysroot环境变量；下载/编译安装patchelf供VSCode调用；

编译Crosstool-ng工具

根据VSCode官方推荐，使用Crosstool-ng编译新版本的glibc、gcc等工具链。

在Ubuntu系统运行以下命令以安装依赖项：

sudo apt-get update
sudo apt-get install -y gcc g++ gperf bison flex texinfo help2man make libncurses5-dev \
python3-dev autoconf automake libtool libtool-bin gawk wget bzip2 xz-utils unzip \
patch rsync meson ninja-build

而在CentOS系统需要使用yum install命令，不再赘述（注意CentOS与Ubuntu依赖库的名称也有所差异）。

然后下载Crosstool-ng源码，解压、配置、编译、安装：

wget http://crosstool-ng.org/download/crosstool-ng/crosstool-ng-1.26.0.tar.bz2
tar -xjf crosstool-ng-1.26.0.tar.bz2
cd crosstool-ng-1.26.0 && ./configure --prefix=/crosstool-ng-1.26.0/out
make
sudo make install

后续使用ct-ng命令之前，需要配置环境变量：

PATH=$PATH:/crosstool-ng-1.26.0/out/bin

方便起见，可以将这一句命令添加到~/.bashrc中。

编译glibc2.28

完成Crosstool-ng的编译安装和环境变量设置后，便可以在bash中调用ct-ng命令了。

为了编译glibc2.28工具链，还需要下载.config配置文件。不同架构cpu应使用不同的配置文件，例如intel的现代cpu使用x86_64-gcc-8.5.0-glibc-2.28：

mkdir toolchain-dir
cd toolchain-dir
wget https://github.com/microsoft/vscode-linux-build-agent/blob/main/x86_64-gcc-8.5.0-glibc-2.28.config
ct-ng build

利用wget获取该文件可能会失败，建议手动去github下载这一文件，拷贝到toolchain-dir目录中。
ct-ng build命令会自动寻找.config文件，根据其内容编译glibc和gcc。

清空环境变量LD_LIBRARY_PATH

在CentOS上使用scl的gcc工具集时或者用户自己为了开发时链接方便 设置了LD_LIBRARY_PATH环境变量，此时使用ct-ng编译时会报错：

[ERROR] Don’t set LD_LIBRARY_PATH. It screws up the build.

因此，需要运行如下指令临时删除LD_LIBRARY_PATH环境变量

unset LD_LIBRARY_PATH
CentOS平台的“小”问题

1.在CentOS 7系统中，可能出现如下错误：

/usr/bin/ld: cannot find -lc
/usr/bin/ld: cannot find -lstdc++
Checking that gcc can statically link libstdc++

这是gcc找不到c/c++的标准静态库，无法完成静态链接测试导致的。
c/c++标准库真的不存在吗？运行命令locate libc.a尝试查找，若命令行没有任何输出，说明c标准静态库确实不存在。因此，运行如下命令安装静态库可解决问题：

yum install glibc-static libstdc++-static

2.报错

error: C++ compiler not available

则需要安装g++编译器：

sudo yum install gcc-c++

3.报错critical programs are missing or too old: make

即make版本太老，需要编译更新make。查看INSTALL文件发现，使用crosstoolchain编译glibc要求make的最低版本为4.0：

在这里插入图片描述

而CentOS7自带的make版本是3.8.2。因此，在运行ct-ng build命令之前，需要更新CentOS7的make。

更新命令：

wget https://ftp.gnu.org/gnu/make/make-4.0.tar.gz
tar -xzf make-4.0.tar.gz 
cd make-4.0/
./config
./configure 
make
sudo make install

完成后，关闭当前终端，开启新的终端，运行make --version检查是否更新到最新版本。

  1. 报错找不到ncurse库：
sudo yum install ncurses-devel
  1. CentOS内核版本过旧

CentOS内核版本默认是3.10（2012年发布），而2025年以来，VSCode拒绝连接如此老旧的系统。因此有必要将其内核更新到5.x版本或更新。由于CentOS 7早已被结束支持，这里给出一种方案。

目前mirrors.coreix.net网站还提供CentOS 7的5.4版本内核下载，因此我们先从该网站下载内核的rpm包，然后依次安装它们：

cd Downloads/
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-5.4.278-1.el7.elrepo.x86_64.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-devel-5.4.278-1.el7.elrepo.x86_64.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-doc-5.4.278-1.el7.elrepo.noarch.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-headers-5.4.278-1.el7.elrepo.x86_64.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-tools-5.4.278-1.el7.elrepo.x86_64.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-tools-libs-5.4.278-1.el7.elrepo.x86_64.rpm
wget https://mirrors.coreix.net/elrepo-archive-archive/kernel/el7/x86_64/RPMS/kernel-lt-tools-libs-devel-5.4.278-1.el7.elrepo.x86_64.rpm
sudo rpm -ivh kernel-lt-5.4.278-1.el7.elrepo.x86_64.rpm 
sudo rpm -ivh kernel-lt-devel-5.4.278-1.el7.elrepo.x86_64.rpm 
sudo rpm -ivh kernel-lt-headers-5.4.278-1.el7.elrepo.x86_64.rpm
sudo rpm -ivh kernel-lt-tools-libs-5.4.278-1.el7.elrepo.x86_64.rpm 
sudo rpm -ivh kernel-lt-tools-5.4.278-1.el7.elrepo.x86_64.rpm 
sudo rpm -ivh kernel-lt-tools-libs-devel-5.4.278-1.el7.elrepo.x86_64.rpm
sudo rpm -ivh kernel-lt-doc-5.4.278-1.el7.elrepo.noarch.rpm

更新内核后，运行命令rpm -qa | grep kernel查看已安装内核版本：

在这里插入图片描述
运行命令sudo cat /etc/grub2.cfg | grep menuentry|awk -F "'" '$1=="menuentry " {print i++ " : " $2}'查看内核序号，输出为：

0 : CentOS Linux (5.4.278-1.el7.elrepo.x86_64) 7 (Core)
1 : CentOS Linux (3.10.0-1160.119.1.el7.x86_64) 7 (Core)
2 : CentOS Linux (0-rescue-a82932c2dec3474eb46898bf0ef5e40d) 7 (Core)

然后根据序号将新内核设为默认启动内核：

grub2-set-default 0

最后重启电脑即可。运行uname -rs可查看系统版本号。若输出为

Linux 5.4.278-1.el7.elrepo.x86_64

则表示更新成功。

编译安装patchelf

patchelf是一个替换系统关键elf组件的工具，用于将上面ct-ng编译好的gcc工具链和新的glibc设置为远程连接进程的默认配置。
远程连接时，VSCode检测到远程系统的GLIBC版本过低，会启用patchelf，并查找数个环境变量（下节介绍），以尝试将系统默认的GLIBC替换成更新版本，以使远程连接正常运行。

在Ubuntu 18中，可以直接使用命令行安装patchelf：

sudo apt-get install patchelf

安装完成后，运行命令检查patchelf版本：

patchelf --version

官方推荐使用0.18.0以及更新版本，0.17.x版本存在错误。

而CentOS 7中不存在patchelf的软件源，需要用户下载源码、手动编译：

cd ~
wget https://github.com/NixOS/patchelf/releases/download/0.18.0/patchelf-0.18.0.tar.gz
tar -zf patchelf-0.18.0.tar.gz
cd patchelf-0.18.0
./bootstrap.sh
./configure
make
sudo make install

patchelf的更多用法可以参考博客。
更多信息也可以访问patchelf的GitHub页面。

设置VSCode Server所需的sysroot环境变量

所谓的sysroot指的就是编译好的glibc库。按照上面数节的配置，编译的glibc2.28位于~/toolchain-dir，而patchelf位于/usr/local/bin/，因此这三个环境变量的配置为：

export VSCODE_SERVER_CUSTOM_GLIBC_LINKER=~/toolchain-dir/x86_64-linux-gnu/x86_64-linux-gnu/sysroot/lib/ld-linux-x86-64.so.2
export VSCODE_SERVER_CUSTOM_GLIBC_PATH=~/toolchain-dir/x86_64-linux-gnu/x86_64-linux-gnu/sysroot/lib
export VSCODE_SERVER_PATCHELF_PATH=/usr/local/bin/patchelf

将这三条命令加到~/.bashrc文件中。

如果编译时toolchain-dir不在$HOME下，则需要用户自行查找ld-*.so.2的路径。默认情况在编译完成的toolchain-dir目录下，深入数层后有sysroot子目录，如图所示：
在这里插入图片描述

VSCode所需的三个环境变量名和作用如表所示：

环境变量作用
VSCODE_SERVER_CUSTOM_GLIBC_LINKER利用ct-ng编译好的动态链接器ld-linux-x86-64.so.2路径(将被传递给patchelf的–set-interpreter选项)
VSCODE_SERVER_CUSTOM_GLIBC_PATH利用ct-ng编译好的glibc文件夹路径(将被传递给patchelf的–set-rpath选项)
VSCODE_SERVER_PATCHELF_PATH编译好的patchelf可执行程序路径

在Remote SSH扩展中添加远程连接

在VSCode中使用Ctrl+Shift+P组合键，输入“Remote-SSH”，选择下图所示的选项：
在这里插入图片描述

根据实际情况配置SSH命令行，输入密码，建立连接；稍候VSCode在远程配置完毕，将弹出如下提示框：
在这里插入图片描述

点击“允许”，即可连接到远程系统。大功告成！

3.结语

连接后在VSCode顶部依然会出现提示信息“你已连接到不受Visual Studio Code支持的OS版本”，如下图所示：

在这里插入图片描述
也就是说，未来可能不再支持使用本文的方法来实现老系统远程连接，用户应当考虑将系统升级到较新的LTS版本。

4.参考

/usr/bin/ld: cannot find -lc while compiling

Can I run VS Code Server on older Linux distributions?

http://www.xdnf.cn/news/1913.html

相关文章：

  • 燃气经营从业人员有哪些类别
  • Doris vs ClickHouse：深入对比MPP数据库聚合操作的核心区别
  • Excel表格批量翻译对照翻译（使用AI助手）
  • ESG跨境电商如何为国内的跨境电商企业打开国外的市场
  • JDK 24：Java 24 中的新功能
  • SOC估算：开路电压修正的安时积分法
  • Doris表设计与分区策略：让海量数据管理更高效
  • 软测面经（私）
  • 分布式队列对消息语义的处理
  • MySQL元数据库完全指南：探秘数据背后的数据
  • 金仓数据库KingbaseES技术实践类深度剖析与实战指南
  • 单片机-89C51部分：2、环境搭建
  • 信奥赛之c++基础（初识循环嵌套与ASCII密码本）
  • browser-use：AI驱动的浏览器自动化工具使用指南
  • van-field组件设置为textarea属性被软键盘遮挡问题
  • Linux下编译MNN
  • Java—ThreadLocal底层实现原理
  • uniapp-商城-36-shop 购物车 选好了 进行订单确认2 支付方式颜色变化和颜色滤镜filter
  • 将AAB转APK的两种好用方法AAB to APK Converter
  • 深入理解Java基本类型
  • 软考-软件设计师中级备考 1、计算机内数据的表示
  • 软件编程命名规范
  • Linux 官方蓝牙协议栈 BlueZ 第一篇：入门与架构概览
  • Fanotify学习
  • 基于深度学习的视频目标跟踪算法研究
  • Android 9.0上开发的，如果设置没启动wifi的话，安卓app如何启动wifi
  • cmake 执行命令
  • 《Java编程思想》读书笔记：第十章 内部类
  • vue3 使用 vite 管理多个项目，实现各子项目独立运行，独立打包
  • 生物医药行业中的APS计划排产系统：关键功能与应用