Ubuntu 18.04 등 구버전에서 Visual Studio Code 연동 불가 현상 해결하기 (컨테이너편: WSL, 도커, LXC 등)

컨테이너 (WSL, Docker, LXC 등)가 아닌 VM이나 실제 OS의 경우 이 포스트의 방법으로 적용해야 합니다.

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

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 버전부터는 WSL 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 연동 대상 머신은 WSL 2로 구동되는 Ubuntu 18.04 LTS입니다.

컨테이너가 아닌 VM 및 실제 OS의 경우, 커널 버전이 4.18 이전인 경우 적용이 어렵습니다. 대신 이 포스트를 확인해주세요.

Bash 스크립트

사전 체크리스트

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

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

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

 

스크립트 준비

먼저, 연동 대상 머신에 SSH로 접속합니다. 그리고 /var/tmp로 이동하여 아래 스크립트 3개를 작성합니다. 이제부터 각 스크립트를 apply-part-1.sh, apply-part-2.sh, apply-part-3.sh로 부르겠습니다.

이때, part 1 및 part 3은 root로, 그리고 part 2는 일반 유저로 실행해야 합니다. 만약 root 이외의 계정이 없으신 경우, adduser 일반계정명를 통해 일반 유저를 하나 만들어주세요.

스크립트를 3개로 나누어놓은 이유가 궁금합니다. 그리고 왜 part 2는 일반 유저로 실행해야 하나요?

작업 전체적으로 root 권한이 필요하나, 다만 part 2의 `ct-ng build` 부분만큼은 일반 유저로 실행하도록 원본 `.config` 파일이 구성되어 있기 때문입니다.

#!/bin/bash

# ───────────────────────────────────────────────────────────────────────
# root 권한 체크
if [ "$EUID" -ne 0 ]; then
  echo "오류: 이 스크립트는 root 유저로만 실행할 수 있습니다." >&2
  echo "Error: This script could ONLY be run by the root user." >&2
  exit 1
fi
# ───────────────────────────────────────────────────────────────────────

# 업데이트 및 패키지 준비
apt-get update
apt-get install -y tree 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

# 초기 디렉터리 생성
mkdir -p /vscode-sysroot
mkdir -p /toolchain-dir
cd /toolchain-dir

# Patchelf 다운로드 및 적용
wget https://github.com/NixOS/patchelf/releases/download/0.18.0/patchelf-0.18.0-x86_64.tar.gz \
 && mkdir -p patchelf-0.18.0-x86_64 \
 && tar -xzvf patchelf-0.18.0-x86_64.tar.gz -C patchelf-0.18.0-x86_64 \
 && mv patchelf-0.18.0-x86_64/bin/patchelf /usr/local/bin/
cd /toolchain-dir

# 크로스-빌드 툴체인
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 && make install
chmod -R a+rX /crosstool-ng-1.26.0/out

# (1) ~/.profile 끝에 export 구문이 없으면 추가
grep -qxF 'export PATH=$PATH:/crosstool-ng-1.26.0/out/bin' ~/.profile \
  || echo 'export PATH=$PATH:/crosstool-ng-1.26.0/out/bin' >> ~/.profile
source ~/.profile

# (2) /etc/profile 끝에 export 구문이 없으면 추가
grep -qxF 'export PATH=$PATH:/crosstool-ng-1.26.0/out/bin' /etc/profile \
  || echo 'export PATH=$PATH:/crosstool-ng-1.26.0/out/bin' >> /etc/profile

# (3) /etc/environment 끝에 추가
echo 'PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/crosstool-ng-1.26.0/out/bin"' >> /etc/environment
cd /toolchain-dir

# 권한 관련 정리 (root외의 유저들을 위함)
# 특수한 필요가 있을 경우 권한은 직접 설정하세요.
chmod -R a+rX /vscode-sysroot
chmod a+x /usr/local/bin/patchelf

# 여기서 잠시 root를 나와야 합니다.
# 스크립트 part 2(ct-ng build)의 실행 완료 후, 다시 root로 들어와서 계속.
echo "스크립트 part 1 실행 완료." >&2
echo "여기서 잠시 root를 나와야 합니다. 일반 유저로 스크립트 part 2를 실행해주세요." >&2
echo "Part 1 of the script completed." >&2
echo "You need to exit root for now. Run part 2 as an unprivileged user." >&2

#!/bin/bash

# ───────────────────────────────────────────────────────────────────────
# 일반 유저 권한 체크
if [ "$EUID" -eq 0 ]; then
  echo "오류: 이 스크립트는 일반 유저로만 실행할 수 있습니다. root는 안됩니다." >&2
  echo "Error: This script could NOT be run by the root user." >&2
  exit 1
fi
# ───────────────────────────────────────────────────────────────────────
# ct-ng 사용 가능 여부 체크
if ! which ct-ng > /dev/null; then
  echo "오류: ct-ng가 설치되어 있지 않습니다. 설치 후 다시 시도해 주세요." >&2
  echo "Error: ct-ng is not installed. Please install it and try again." >&2
  exit 1
fi
# ───────────────────────────────────────────────────────────────────────
# 실행 시간 관련 경고 및 confirmation
echo "경고: 이 작업은 프로세서 성능에 따라 20분-50분 정도 소요됩니다. 계속할까요? (y/n)" >&2
echo "Warning: This task may take between 10 to 50 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
# ───────────────────────────────────────────────────────────────────────

# .config 다운로드 및 ct-ng build
# 주의: 시간이 상당히 걸리는 작업입니다 (약 20분-50분).
mkdir -p /var/tmp/glibcbuild
cd /var/tmp/glibcbuild
wget https://raw.githubusercontent.com/microsoft/vscode-linux-build-agent/refs/heads/main/x86_64-gcc-8.5.0-glibc-2.28.config
cp x86_64-gcc-8.5.0-glibc-2.28.config .config
ct-ng build

# 스크립트 part 2(ct-ng build)의 실행 완료 후, 다시 root로 들어와서 계속.
echo "스크립트 part 2 실행 완료." >&2
echo "다시 root로 들어와 스크립트 part 3을 실행해주세요." >&2
echo "Part 2 of the script completed." >&2
echo "Return to root and run part 3 to continue." >&2

#!/bin/bash

# 스크립트 part 2(ct-ng build)의 실행 완료 후, 다시 root로 들어와서 계속합니다.

# ───────────────────────────────────────────────────────────────────────
# root 권한 체크
if [ "$EUID" -ne 0 ]; then
  echo "오류: 이 스크립트는 root 유저로만 실행할 수 있습니다." >&2
  echo "Error: This script could ONLY be run by the root user." >&2
  exit 1
fi
# ───────────────────────────────────────────────────────────────────────
# ───────────────────────────────────────────────────────────────────────
# /var/tmp/glibcbuild 디렉터리 유무 확인
if [ ! -d /var/tmp/glibcbuild/x86_64-linux-gnu/x86_64-linux-gnu/sysroot ] || [ -z "$(ls -A /var/tmp/glibcbuild/x86_64-linux-gnu/x86_64-linux-gnu/sysroot)" ]; then
  echo "오류: /var/tmp/glibcbuild내 커스텀 sysroot가 없어 진행이 불가능합니다." >&2
  echo "Error: No custom sysroot in the directory '/var/tmp/glibcbuild'." >&2
  exit 1
fi
# ───────────────────────────────────────────────────────────────────────

# ct-ng build후 빌드 결과물 이동
cp -r /var/tmp/glibcbuild/x86_64-linux-gnu/x86_64-linux-gnu/sysroot/* /vscode-sysroot
cd /toolchain-dir

# 환경변수 적용 /etc/profile.d/vscode-glibc.sh
echo 'export VSCODE_SERVER_CUSTOM_GLIBC_LINKER=/vscode-sysroot/lib/ld-linux-x86-64.so.2' > /etc/profile.d/vscode-glibc.sh
echo 'export VSCODE_SERVER_CUSTOM_GLIBC_PATH=/vscode-sysroot/lib:/vscode-sysroot/usr/lib' >> /etc/profile.d/vscode-glibc.sh
echo 'export VSCODE_SERVER_PATCHELF_PATH=/usr/local/bin/patchelf' >> /etc/profile.d/vscode-glibc.sh

# 환경변수 적용 /etc/environment
echo 'VSCODE_SERVER_CUSTOM_GLIBC_LINKER=/vscode-sysroot/lib/ld-linux-x86-64.so.2' >> /etc/environment
echo 'VSCODE_SERVER_CUSTOM_GLIBC_PATH=/vscode-sysroot/lib:/vscode-sysroot/usr/lib' >> /etc/environment
echo 'VSCODE_SERVER_PATCHELF_PATH=/usr/local/bin/patchelf' >> /etc/environment

# 권한 관련 정리 (root외의 유저들을 위함)
# 특수한 필요가 있을 경우 권한은 직접 설정하세요.
chmod -R a+rX /vscode-sysroot
chmod a+x /usr/local/bin/patchelf

# 스크립트 part 3 실행 완료
echo "스크립트 part 3 실행 완료." >&2
echo "이제 Visual Studio Code에서 Remote-SSH를 통하여 접속을 시도해주세요. 만약 안될 경우, 이 머신을 재부팅하여 다시 시도해주세요." >&2
echo "Part 3 of the script completed." >&2
echo "Now you can try connecting from Visual Studio Code with Remote - SSH. Try again by rebooting this machine if it does not take any effect." >&2

작성 후 /var/tmp 경로에서 ls -al을 날리면 아래와 같이 3개의 스크립트를 보실 수 있습니다.

여기서 아래 명령어를 실행하여 권한을 부여합니다. `일반유저명`은 가지고 계신 일반 유저 계정을 넣어주세요.

chmod ug+x apply-part-*;chown 일반유저명:일반유저명 apply-part-2.sh

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

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

스크립트 실행

스크립트 part 1

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

스크립트 part 1의 실행을 마친 뒤 모습은 위와 같습니다.

스크립트 part 2

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

위 메시지를 확인 후 진행해주세요. 스크립트 part 2는 시간이 다소 걸립니다. 아주 고성능 칩셋이면 10분, 최대 50분 정도의 소요 시간을 예상할 수 있습니다.

제 경우는 17분이었네요.

스크립트 part 3

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

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

패치 확인

스크립트 3까지 실행을 마쳤다면, 아래와 같이 cat /etc/environment을 통해 정상적으로 환경 변수 세팅이 되었는지 확인해주세요. 또한, /vscode-sysroot/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