WSL container 소개

2026년 9월부터 WSL이 지원하는 WSL 컨테이너를 테스트 해 보았고 간략히 소개한다.

참고 페이지

WSL container 소개

  • Windows에서 컨테이너 런타임을 기본 탑재한 것으로, Windows에서 Docker Desktop을 별도로 설치하지 않고, 컨테이너를 직접 실행시킬 수 있다.
  • 2026년 9월에 정식 릴리즈 되었고, WSL v2.9.3 이상을 설치하면 된다. (wslc.exe 실행 파일이 기본 제공 바이너리로 포함됨)
  • WSL 리눅스 배포판을 설치하는 것이 아니고, Docker처럼 Linux 컨테이너를 설치 및 실행할 수 있다.
  • 기본적인 사용법은 Docker와 거의 동일하다.
  • 현재 compose는 지원하지 않고 있는데, 개발 중으로 추후 “wsl compose up” 명령으로 지원할 계획이다.
  • WSL 배포판에는 WSLg가 포함되어 있지만 WSL Container는 그렇지 않으므로, GUI app을 실행하려면 VNC나 X 서버 등을 이용해야 한다.

WSL container 실행

Windows console을 연 후에 아래와 같이 실행시킬 수 있다.

C:\>wsl

아래와 같이 실행시키면 도움말이 출력된다.

C:\>wsl --help

설정 파일

  • 설정 파일에서는 CPU 개수, 메모리 제한, 스토리지 제한, 스토리지 경로 설정 등을 설정할 수 있다.
  • wslc 설정 파일 경로: %LOCALAPPDATA%\wslc\settings.yaml
    또는 아래와 같이 실행하면 연결된 편집기에서 설정 파일이 열린다.
    C:\>wslc settings
    
  • 디폴트 컨테이너 저장 경로: %LOCALAPPDATA%\wslc\sessions\<session>\storage.vhdx
    디폴트 컨테이너 저장 경로를 바꾸려면 wslc 설정 파일에서 아래 예와 같이 변경하면 된다.
    session:
      storagePath: 'D:\WSLc'
    

WSL container 테스트

Dockerfile 작성

일반 유저로 로그인하기 위하여 아래와 같이 Dockerfile 파일을 작성하였다. (단, ubuntu:24.04 이미지에 UID/GID가 1000인 ubuntu 사용자가 이미 있으므로, 여기서 yrpark99 유저 ID로 1001을 사용했고, sudo 권한을 추가했음)
(사실상 내가 기존에 Linux 서버에서 사용한 Dockerfile을 그대로 복사해 왔음)

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=Asia/Seoul
ENV LANG=ko_KR.UTF-8
ENV LANGUAGE=ko_KR:ko
ENV LC_ALL=ko_KR.UTF-8

RUN apt-get update && apt-get install -y --no-install-recommends apt-utils sudo net-tools locales
RUN apt-get install -y wget curl git build-essential bc vim openssh-client openssh-server ca-certificates file htop unzip
RUN sed -i 's/^# *ko_KR.UTF-8 UTF-8/ko_KR.UTF-8 UTF-8/' /etc/locale.gen && locale-gen $LANG && update-locale LANG=$LANG
RUN apt-get clean && rm -rf /var/lib/apt/lists/*
RUN apt-get update

ARG USERNAME=yrpark99
ARG USER_UID=1001
ARG USER_GID=$USER_UID
RUN groupadd --gid $USER_GID $USERNAME \
    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
    && echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
    && chmod 0440 /etc/sudoers.d/$USERNAME

USER $USERNAME
WORKDIR /home/$USERNAME
CMD ["/bin/bash"]

WSL 이미지 생성

아래와 같이 실행시키면 Dockerfile 파일로 이미지가 생성된다.

C:\>wslc build -t {이미지 이름} .

예를 들어 아래와 같이 ubuntu-2404 이름으로 이미지를 생성할 수 있다.

C:\>wslc build -t ubuntu-2404 .

WSL 컨테이너 생성 및 실행

아래와 같이 컨테이너를 생성 및 실행시킬 수 있다.

C:\>wslc run -it --name {컨테이너 이름} {이미지 이름}

예를 들어 아래 예와 같이 실행시키면 ubuntu-24.04 이름으로 컨테이너가 생성되고 실행된다. (아래에서는 컨테이너의 hostname을 “HOME-DESKTOP”으로 설정하고, 호스트의 포트를 컨테이너의 포트에 매핑시킴)

C:\>wslc run -d -it --name ubuntu-24.04 --hostname HOME-DESKTOP --volume D:\WSLc_Mount:/work -p 2222:22 -p 8080:80 -p 4000:4000 ubuntu-2404

이후 아래와 같이 컨테이너의 shell을 얻을 수 있다.

C:\>wslc exec -it ubuntu-24.04 bash

Windows Terminal에서는 프로필에 아래 예와 같이 설정하면 된다.

"commandline": "cmd.exe /c \"wslc start ubuntu-24.04 >nul 2>&1 & wslc exec -it ubuntu-24.04 bash\"",

NGINX 서비스 테스트

WSL 컨테이너에서 아래와 같이 NGINX 패키지를 설치한다.

$ sudo apt install nginx

이후 아래와 같이 서비스를 시작시킨다.

$ sudo service nginx start

이제 Windows에서 http://localhost:8080/ 주소에 접속하면 nginx welcome 화면을 볼 수 있다.

Windows VSCode에서 container 접속하기

  • 방법 1: WSL 컨테이너에서 SSH 서버를 설치하고, Windows VSCode에서 “Remote - SSH” 익스텐션을 설치하여 해당 SSH로 연결하면 된다.
    $ sudo apt install openssh-server
    $ sudo service ssh --full-restart
    

    Windows에서 아래와 같이 SSH key를 생성하고, 생성된 public key를 .ssh/authorized_keys 파일에 추가한다.

    C:\>ssh-keygen
    

    이제 아래 예와 같이 WSL 컨테이너에 SSH 접속이 되는지 확인해 본다.

    C:\>ssh -p 2222 yrpark99@127.0.0.1
    

    위 명령으로 암호 입력없이 로그인이 성공했으면 %UserProfile%\.ssh\config 파일에 아래 예와 같이 추가한다.

    Host wslc-ubuntu-24.04
        HostName 127.0.0.1
        Port 2222
        User yrpark99
    

    이후 Windows VSCode에서 “Remote - SSH” 익스텐션을 설치한 후에, “Remote-SSH: Connect to Host” 명령을 실행해서 wslc-ubuntu-24.04를 선택하면 연결된다.

  • 방법 2: Dev Containers 익스텐션을 설치한 후에, 설정 파일에서 아래와 같이 변경한다.
    "dev.containers.dockerPath": "wslc",
    

    이후 커맨드 팔레트에서 “Dev Containers: Attach to Running Container”를 실행하여 타겟 WSL 컨테이너를 선택하면 된다.

WSL container에서 SSH 서버 실행하기

WSL 컨테이너에서 SSH 서버를 실행하려면 Dockerfile 파일을 아래 예와 같이 수정할 수 있다.

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=Asia/Seoul
ENV LANG=ko_KR.UTF-8
ENV LANGUAGE=ko_KR:ko
ENV LC_ALL=ko_KR.UTF-8

RUN apt-get update && apt-get install -y --no-install-recommends apt-utils sudo net-tools locales
RUN apt-get install -y wget curl git build-essential bc vim openssh-client openssh-server ca-certificates file htop unzip
RUN sed -i 's/^# *ko_KR.UTF-8 UTF-8/ko_KR.UTF-8 UTF-8/' /etc/locale.gen && locale-gen $LANG && update-locale LANG=$LANG
RUN apt-get clean && rm -rf /var/lib/apt/lists/*
RUN apt-get update

ARG USERNAME=yrpark99
ARG USER_UID=1001
ARG USER_GID=$USER_UID
RUN groupadd --gid $USER_GID $USERNAME \
    && useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
    && echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
    && chmod 0440 /etc/sudoers.d/$USERNAME

COPY start.sh /usr/local/bin/start.sh
RUN chmod +x /usr/local/bin/start.sh
CMD ["/usr/local/bin/start.sh"]

위에서 사용된 start.sh 파일은 아래 예와 같이 작성한다. (즉, SSH 서비스를 시작시키고 무한 대기함, 주의: 만약에 sleep infinity 명령이 없으면 CMD로 지정한 프로세스가 종료되고 따라서 컨테이너도 바로 종료되어 버림)

#!/bin/bash
mkdir -p /run/sshd
/usr/sbin/sshd
exec sleep infinity

이제 아래 예와 같이 실행시키면 ubuntu-24.04 이름으로 컨테이너가 생성되고 실행된다. (아래에서는 컨테이너의 hostname을 “HOME-DESKTOP”으로 설정하고, 호스트의 포트를 컨테이너의 포트에 매핑시킴)

C:\>wslc run -d -it --name ubuntu-24.04 --hostname HOME-DESKTOP --volume D:\WSLc_Mount:/work -p 2222:22 -p 8080:80 -p 4000:4000 ubuntu-2404

이후 아래 예와 같이 실행하면 컨테이너의 yrpark99 사용자로 로그인할 수 있다.

C:\>wslc exec -it -u yrpark99 -w /home/yrpark99/ ubuntu-24.04 bash

Windows Terminal에서는 프로필에 아래 예와 같이 설정하면 된다.

"commandline": "cmd.exe /c \"wslc start ubuntu-24.04 >nul 2>&1 & wslc exec -it -u yrpark99 -w /home/yrpark99/ ubuntu-24.04 bash\"",

이제 컨테이너는 SSH 서버를 실행 중이므로, Windows VSCode에서는 “Remote - SSH” 익스텐션을 사용하여 이 컨테이너에 연결할 수 있다.

WSLc 기타 명령

  • 이미지 목록 보기
    C:\>wslc images
    
  • 실행 중인 컨테이너 목록 보기
    C:\>wslc ps
    C:\>wslc container list
    

    전체 컨테이너 목록 보기

    C:\>wslc ps -a
    
  • 파일 복사 Windows에서 컨테이너로 복사하기
    C:\>wslc container cp {Windows 파일/디렉토리} {컨테이너 이름|ID}:{컨테이너에서의 타겟 경로}
    

    컨테이너에서 Windows로 복사하기

    C:\>wslc container cp {컨테이너 이름|ID}:{컨테이너에서의 경로} {Windows 타겟 경로}
    
  • 컨테이너 로그 보기
    C:\>wslc container logs {컨테이너 이름|ID}
    
  • 실행 중인 컨테이너의 리소스 사용량 스냅샷 표시
    C:\>wsl stats
    
  • 컨테이너 중지
    C:\>wslc stop {컨테이너 이름|ID}
    C:\>wslc container stop {컨테이너 이름|ID}
    
  • 컨테이너 삭제
    C:\>wslc remove {컨테이너 이름|ID}
    C:\>wslc container remove {컨테이너 이름|ID}
    
  • 이미지 삭제
    C:\>wslc rmi {이미지 이름|ID}
    C:\>wslc image remove {이미지 이름|ID}
    
  • 세션 관리 세션 목록 보기
    C:\>wslc system session list
    

    세션 종료

    C:\>wslc system session terminate
    

    이제 세션 저장 경로의 storage.vhdx 파일을 수동으로 삭제할 수 있다.

    단 wslc 명령을 수행하면 이 파일이 자동으로 다시 생성된다.

맺음말

WSL container는 Windows와의 상호 운용성이 WSL 배포판을 설치하는 것보다 떨어진다. (WSL 배포판은 Microsoft가 로그인, WSLg, Windows 디스크 마운트, Windows 파일 실행 기능 등을 builtin 시켜 놓았으므로)
따라서 WSL 컨테이너에서 Windows와 상호 운용을 하는 경우에는 적합하지 않다.
대신 Linux에서 Dockerfile을 이용하여 컨테이너를 운용했던 것을 그대로 Windows로 가져와서 운용하고자 하는 경우에는, Docker Desktop을 설치하지 않아도 되는 편리한 대안이 될 수 있겠다.

카테고리:

업데이트: