Ubuntu 18.04 등 구버전에서 Visual Studio Code 연동 불가 현상 해결하기 (VM, 실제 OS편)

컨테이너 (WSL, Docker, LXC 등)의 경우 가급적 이 포스트의 방법으로 적용하세요.

AMD64 (x86-64) 이외의 아키텍처의 경우 공식 문서를 확인하세요.

VS Code Server가 예기치 못한 동작을 할 수 있습니다. 프로덕션 환경에서는 주의가 필요합니다.

Could not establish connection to "(Server Name)":
The remote host does not meet the prerequisites for running VS Code Server.

원격 호스트가 VS Code Server를 실행하기 위한 필수 구성 요소를 충족하지 않습니다.

인트로

비주얼 스튜디오 코드는 Remote - SSH, WSL, Docker 컨테이너 등으로의 편리한 연동 기능을 제공하고 있습니다. 그러나 2025년 3월 릴리즈된 1.99 버전부터는 Ubuntu 18.04 등 구버전 머신으로의 연동이 불가능해졌습니다. 이는 연동을 위한 VS Code Server의 요구사항 중 glibc 최소 버전이 기존 2.27에서 2.28로 올라가서, 기존 방식대로는 VS Code Server 설치가 안되기 때문입니다. Ubuntu 18.04 LTS의 내장 glibc의 버전은 2.27입니다.

다행스럽게도 VS Code 공식 문서에 workaround가 제시되어 있습니다. 방법은 즉 VS Code 버전 자체를 낮추거나, Crosstool-ng을 이용한 커스텀 sysroot의 빌드, 그리고 이 커스텀 sysroot를 환경 변수로 지정하여 VS Code Server가 이를 이용하게끔 만드는 것인데요, 문제는 해당 문서에 일부 누락된 내용과 함께, 특이한 버그(로 추정되는 무언가)로 인해 그대로 따르면 적용이 제대로 안된다는 점입니다.

하여, 이번 포스트에서는 VS Code의 Remote - SSH로 Ubuntu 18.04 LTS 머신에 연동하는 방법을 다루어 드리겠습니다. 참고로 제 VS Code 설치 환경은 Windows 11 Pro이며, VS Code Server 연동 대상 머신은 Ubuntu 18.04 LTS가 구동되는 VM입니다.

아래 소개해드릴 방법은 순정 커널로 구동되는 VM 및 실제 OS를 대상으로 합니다. 컨테이너 (WSL, LXC, Docker 등)의 경우 이 포스트의 방법대로 적용하시기를 권합니다.

Bash 스크립트

사전 체크리스트

패치 적용에 앞서, VS Code와 연동하기 위한 기본적인 체크리스트를 확인해주세요. 

• 대상 머신은 AMD64 (x86-64) 아키텍처로 구동되나요?
• 대상 머신으로의 SSH 접속이 가능하도록 구성된 상태인가요? (SSH 서비스, 구성 파일, AppArmor, 방화벽, 포트 포워딩 등)
• 대상 머신은 apt 패키지 관리자의 사용이 가능한 상태인가요?
• 대상 머신의 root 권한 또는 sudo의 사용이 가능한 상태인가요?
• VS Code에서 Remote - SSH 확장 기능을 설치한 상태인가요?

모두 만족하는 경우 진행할 수 있습니다.

 

스크립트 작성 및 실행

먼저, 연동 대상 머신에 SSH로 접속합니다. 그리고 아래 스크립트를 작성합니다. 이제부터 이 스크립트를 apply_vsc_server_vm.sh로 부르겠습니다. 이 스크립트는 root로 실행해야 하므로 참고하여 진행해주세요.

#!/bin/bash

set -e

# 1) root 권한 체크
if [ "$(id -u)" -ne 0 ]; then
  echo "이 스크립트는 root로 실행해야 합니다. sudo 또는 su를 사용하세요."
  echo "Error: This script could ONLY be run by the root user. Try sudo or su."
  exit 1
fi
# 1a) 실행 시간 관련 안내 및 confirmation
echo "안내: 이 작업은 프로세서 성능에 따라 5-10분 정도 소요됩니다. 계속할까요? (y/n)" >&2
echo "Info: This task may take between 5 to 10 minutes, depending on your processor performance. Proceed? (y/n)" >&2
read -r user_input
if [[ "$user_input" != "y" && "$user_input" != "Y" ]]; then
  echo "중단합니다. Aborting." >&2
  exit 1
fi

# 2) 필수 패키지 설치 (bison 등 추가)
apt update
apt install -y build-essential wget patchelf bison gawk m4 texinfo \
gcc g++ gdb gperf bison flex texinfo help2man make libncurses5-dev \
python3-dev autoconf automake libtool libtool-bin bzip2 xz-utils unzip \
tree gawk wget patch rsync meson ninja-build

# 3) glibc 2.28 다운로드 및 빌드 준비
GLIBC_VERSION="2.28"
GLIBC_SRC="glibc-$GLIBC_VERSION"
INSTALL_PREFIX="/opt/$GLIBC_SRC"

cd /tmp
wget http://ftp.gnu.org/gnu/libc/$GLIBC_SRC.tar.gz
tar -xzf $GLIBC_SRC.tar.gz
mkdir -p $GLIBC_SRC/build
cd $GLIBC_SRC/build

# 4) configure & make
../configure --prefix=$INSTALL_PREFIX --disable-werror
make -j"$(nproc)"
make install

# 5) 환경변수 등록 - /etc/profile.d/vscode-glibc.sh
LINKER="$INSTALL_PREFIX/lib/ld-$GLIBC_VERSION.so"
LIBPATH="$INSTALL_PREFIX/lib"
PATCHELF="$(which patchelf)"

cat > /etc/profile.d/vscode-glibc.sh << EOF
# VSCode Server custom glibc 설정 - profile.d
export VSCODE_SERVER_CUSTOM_GLIBC_LINKER=$LINKER
export VSCODE_SERVER_CUSTOM_GLIBC_PATH=$LIBPATH:/usr/lib/x86_64-linux-gnu:/lib/x86_64-linux-gnu
export VSCODE_SERVER_PATCHELF_PATH=$PATCHELF
EOF

chmod +x /etc/profile.d/vscode-glibc.sh

# 동일 작업 - /etc/environment
echo "VSCODE_SERVER_CUSTOM_GLIBC_LINKER=$LINKER" >> /etc/environment
echo "VSCODE_SERVER_CUSTOM_GLIBC_PATH=$LIBPATH:/usr/lib/x86_64-linux-gnu:/lib/x86_64-linux-gnu" >> /etc/environment
echo "VSCODE_SERVER_PATCHELF_PATH=$PATCHELF" >> /etc/environment

# 6) 완료 메시지
echo "glibc $GLIBC_VERSION 설치 완료: $INSTALL_PREFIX"
echo "VS Code Server용 환경변수 설정 파일: /etc/profile.d/vscode-glibc.sh 및 /etc/environment"
echo "   - VSCODE_SERVER_CUSTOM_GLIBC_LINKER=$LINKER"
echo "   - VSCODE_SERVER_CUSTOM_GLIBC_PATH=$LIBPATH:/usr/lib/x86_64-linux-gnu:/lib/x86_64-linux-gnu"
echo "   - VSCODE_SERVER_PATCHELF_PATH=$PATCHELF"
echo "새로운 SSH 세션에서 이 설정이 자동으로 적용됩니다."

작성 후 아래 명령어를 실행하여 권한을 부여합니다. 

chmod ug+x apply_vsc_server_vm.sh

이후 아래와 같이 권한이 적절히 들어간 것을 확인합니다.

이로써 스크립트를 실행하기 위한 준비를 모두 마치셨습니다.

스크립트 실행

스크립트는 root로 실행해야 하므로, 아래와 같이 whoami를 통해 root임을 확인한 뒤 실행해주세요.

스크립트 실행을 마친 모습입니다.

패치 확인

스크립트 실행을 마쳤다면, 아래와 같이 cat /etc/environment을 통해 정상적으로 환경 변수 세팅이 되었는지 확인해주세요. 또한, /opt/glibc-2.28/lib/ld-linux-x86-64.so.2를 실행하여 링커가 정상적으로 작동하는지 확인해주세요.

VS Code의 Remote - SSH를 이용한 연동

공식 문서에 따르면, 패치를 마친 뒤 Remote - SSH를 이용하여 연동할 수 있다고 합니다. 그러므로 아래와 같이 Remotes (Tunnels/SSH)를 선택합니다. 이후 해당 머신의 IP 주소 및 포트를 이용하여 연동합니다.

마지막으로, "당신은 현재 비주얼 스튜디오 코드가 지원하지 않는 OS 버전에 연결하고 계십니다."라는 메시지가 뜨면 성공입니다. 허용 (Allow)을 누르면 연동이 끝납니다.

디버깅도 더 이상 커맨드라인이 아닌 VS Code와 연동하여 수행할 수 있습니다.

추가 팁

바이너리를 실행할 때, 누가 봐도 눈을 씻고 봐도 파일이 있고 실행권한(x)도 있는데 저런 소리를 하는 경우가 있습니다. 이럴 땐 아래와 같이 명령어를 실행하여 32비트 아키텍처 호환성을 구성해야 합니다.

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 gcc-multilib