가상화 및 서브 PC 활용

Docker Desktop 윈도우 설치 가이드: WSL2 연동 및 초보자 필수 설정

content59998 2026. 10. 24. 15:19

윈도우(Windows) 운영체제 환경에서 컨테이너 기반 개발을 진행할 때 가장 널리 사용되는 도구가 바로 도커 데스크톱(Docker Desktop)입니다. 과거에는 윈도우 환경에서 도커를 실행할 때 가상화 오버헤드로 인해 속도가 느리거나 자원 소모가 심한 문제가 있었습니다.

하지만 최신 윈도우 환경에서는 리눅스용 윈도우 하위 시스템인 WSL2(Windows Subsystem for Linux 2)를 연동함으로써 리눅스 네이티브 환경에 가까운 빠른 성능과 높은 자원 효율성을 확보할 수 있게 되었습니다.

본 글에서는 Docker Desktop의 설치 전 준비사항부터 WSL2 연동 절차, 그리고 초보자가 반드시 진행해야 하는 초기 필수 설정 및 최적화 방법까지 단계별로 상세히 알아보겠습니다.

1. 사전 준비사항: 윈도우 가상화 기능 및 WSL2 활성화

Docker Desktop을 윈도우에 성공적으로 설치하고 WSL2와 연동하기 위해서는 먼저 윈도우 가상화 기능이 활성화되어 있어야 합니다.

[이미지: 윈도우 기능 켜기/끄기 창에서 가상 머신 플랫폼 및 Linux용 Windows 하위 시스템 항목을 체크하는 화면]

설치 전 진행해야 하는 필수 가상화 설정 단계는 다음과 같습니다.

  • CPU 하드웨어 가상화 확인: 작업 관리자의 '성능' 탭에서 '가상화' 항목이 '사용'으로 설정되어 있는지 확인합니다. (비활성화 상태라면 컴퓨터 재부팅 후 BIOS 설정에서 Intel VT-x 또는 AMD-V 옵션을 켜야 합니다.)
  • 윈도우 기능 활성화:
    1. 윈도우 검색창에 'Windows 기능 켜기/끄기'를 입력하여 실행합니다.
    2. 'Linux용 Windows 하위 시스템' 항목에 체크합니다.
    3. '가상 머신 플랫폼' 항목에 체크합니다.
    4. 확인 버튼을 누르고 컴퓨터를 재부팅합니다.
  • WSL2 기본 버전 설정 및 업데이트: 파워쉘(PowerShell)을 관리자 권한으로 실행한 후 다음 명령어를 입력하여 WSL을 최신 버전으로 업데이트하고 기본 버전을 2로 지정합니다.
    • wsl --update
    • wsl --set-default-version 2

2. Docker Desktop 설치 및 WSL2 연동 방법

사전 설정이 완료되면 공식 웹사이트를 통해 Docker Desktop 설치 프로그램을 다운로드하여 설치를 진행합니다.

Docker Desktop 다운로드 및 설치

  1. 도커 공식 홈페이지(Docker Hub)에 접속하여 'Download for Windows' 버튼을 클릭하여 설치 파일(.exe)을 다운로드합니다.
  2. 다운로드한 설치 파일(Docker Desktop Installer.exe)을 실행합니다.
  3. 설치 옵션 화면에서 'Use WSL 2 instead of Hyper-V (recommended)' 항목이 반드시 체크되어 있는지 확인한 후 설치를 진행합니다.
  4. 설치가 완료되면 'Close and restart' 버튼을 눌러 시스템을 재부팅하거나 재로그인합니다.

WSL2 배포판 연동 확인

Docker Desktop 실행 후 우측 상단의 설정(톱니바퀴 아이콘) 메뉴로 이동합니다.

[이미지: Docker Desktop 설정의 Resources 메뉴에서 WSL Integration 옵션을 활성화하는 화면]

  • General 메뉴: 'Use the WSL 2 based engine' 옵션이 활성화되어 있는지 확인합니다.
  • Resources > WSL Integration 메뉴:
    • 'Enable integration with my default WSL distro' 항목을 켭니다.
    • 사용 중인 리눅스 배포판(예: Ubuntu) 스위치를 활성화(On)로 전환하고 'Apply & restart' 버튼을 클릭합니다. 이 설정을 완료하면 우분투 터미널 내부에서 별도의 설치 없이 docker 명령어를 바로 사용할 수 있습니다.

3. 초보자를 위한 초기 필수 설정 및 자원 최적화

Docker Desktop은 기본 설정 그대로 사용할 경우 C드라이브 용량을 크게 차지하거나 메모리를 과도하게 점유할 수 있으므로 초기 최적화 설정이 필요합니다.

  1. 윈도우 시작 시 자동 실행 설정 조절
    • Docker Desktop 설정의 'General' 탭에서 'Start Docker Desktop when you log in' 옵션을 필요에 따라 설정합니다. PC 부팅 속도를 높이고 싶다면 해당 옵션을 해제하고 필요할 때만 직접 실행하는 것을 추천합니다.
  2. WSL2 메모리 및 CPU 자원 제한 설정 (.wslconfig)
    • WSL2는 기본적으로 호스트 시스템 메모리의 과반수를 할당받아 사용하므로 PC가 느려질 수 있습니다.
    • C:\Users\사용자계정 폴더 위치에 .wslconfig 파일을 생성하고 아래와 같이 최대 사용 자원을 제한하는 것을 권장합니다.
    •  
    • Plaintext
       
      [wsl2]
memory=4GB
processors=2
  3. 설치 및 정상 작동 테스트
    • 명령 프롬프트(CMD) 또는 파워쉘을 열고 다음 명령어를 입력하여 도커 엔진이 정상 작동하는지 확인합니다.
      • docker --version (버전 정보 확인)
      • docker run hello-world (테스트용 이미지 실행 및 검증)

자주 묻는 질문 (FAQ)

Q1. Docker Desktop 실행 시 'WSL 2 installation is incomplete' 오류가 발생합니다.

A1. 리눅스 커널 업데이트 패키지가 설치되지 않았을 때 발생하는 오류입니다. 마이크로소프트 공식 웹사이트에서 'WSL2 Linux 커널 업데이트 패키지'를 다운로드하여 설치하거나 파워쉘에서 wsl --update 명령어를 실행하면 해결됩니다.

Q2. C드라이브 용량이 부족한데 도커 이미지 저장 위치를 다른 드라이브로 변경할 수 있나요?

A2. 네, 가능합니다. Docker Desktop은 WSL2의 가상 디스크 파일(ext4.vhdx) 형태로 데이터를 저장합니다. wsl --export 및 wsl --import 명령어를 사용하여 해당 가상 디스크 데이터를 D드라이브 등 다른 파티션으로 이전할 수 있습니다.

Q3. Docker Desktop을 상업적 용도로 무료로 사용할 수 있나요?

A3. 개인 사용자, 교육 기관, 비영리 단체, 그리고 정직원 250명 미만이면서 연 매출 1,000만 달러 미만의 소규모 기업(Small Business)은 무료로 사용할 수 있습니다. 해당 기준을 초과하는 대기업 환경에서는 유료 구독 라이선스가 필요합니다.

결론

Docker Desktop과 WSL2의 연동은 윈도우 환경에서 개발을 진행하는 사용자가 선택할 수 있는 가장 효율적이고 강력한 가상화 조합입니다.

사전 필수 가상화 기능 활성화부터 시작하여 WSL2 연동, 그리고 .wslconfig 파일을 활용한 자원 제한 설정까지 차근차근 완료해 두면 쾌적하고 안정적인 컨테이너 개발 환경을 구축할 수 있습니다.

본 가이드의 절차를 따라 설정을 완료하시고 본격적인 컨테이너 기반 프로젝트 및 서비스 구축을 시작해 보시기 바랍니다.