Technical Anshu 홈 › 자습서 › WSL 2의 Docker
🐳 도커 설정 가이드

WSL 2에 Docker 설치 - 첫 번째 컨테이너 설정

WSL 2 백엔드를 사용하여 Windows 10 또는 11에 Docker Desktop을 설치합니다. 먼저 WSL, Docker, 확인된 hello-world 컨테이너를 차례로 설치합니다. 가상화, 라이센스 및 docker-users 그룹에 대한 정직한 검사가 포함됩니다.

✍️ Technical Anshu🪟 Windows 10 / 11🎧 Multi-Language Audio
WSL 2에 Docker 설치 - 첫 번째 컨테이너 설정
🎧 다국어 오디오: 동영상 플레이어에서 [설정] (⚙️) ➔ [오디오 트랙]을 클릭하여 언어를 선택하세요.

📑챕터

  1. 순서가 중요한 이유 - WSL 2가 먼저, Docker Desktop이 두 번째
  2. 먼저 PC 확인 — 작업 관리자에서 winver 및 가상화가 포함된 Windows 버전
  3. 하나의 명령으로 WSL 2 설치, 다시 시작 및 Ubuntu 첫 실행 완료
  4. WSL 확인 — 상태, 배포판 목록 및 기본 버전 2 확인
  5. WSL 2 백엔드로 Docker Desktop 설치
  6. 첫 번째 컨테이너 실행 — docker --version 및 hello-world
  7. 정직한 확인 — Docker Desktop 라이선스 및 docker-users 그룹

📋 개요 및 단계별 가이드

1

먼저 PC를 확인하세요

WSL 2 백엔드가 있는 Docker Desktop에는 세 가지가 필요하며 이 2분 확인을 건너뛰는 것은 사람들이 저녁 시간을 낭비하는 방법입니다. 먼저 Windows 버전: Windows 10 버전 2004 이상 또는 Windows 11이 필요합니다. Win + R을 누르고 winver를 입력한 다음 Enter를 눌러 정확한 버전을 확인하세요.

Run Dialog
winver

둘째, BIOS 또는 UEFI에서 가상화를 켜야 합니다. 작업 관리자를 열고 성능, CPU로 이동하여 가상화: 활성화를 찾으세요. 비활성화라고 표시되면 소프트웨어 설정이 저장되지 않습니다. 먼저 BIOS에서 Intel VT-x 또는 AMD SVM을 활성화하십시오. 셋째, 약 4GB의 여유 RAM과 몇 GB의 여유 디스크를 유지하세요. WSL 2와 Docker는 머신을 공유하지만 교체하지는 않습니다.

😀 Windows Home 버전에서 이 WSL 2 경로는 해결 방법이 아니며 의도된 경로입니다. Hyper-V는 필요하지 않습니다.
2

다른 것보다 먼저 WSL 2 설치

Windows에서 Docker 설치에 실패한 대부분은 한 가지 지루한 이유로 실패합니다. 바로 순서가 잘못되었습니다. Docker Desktop은 그 아래에서 작동하는 WSL 2를 기대하므로 먼저 기반을 구축하세요. PowerShell을 관리자로 열고 다음 명령 하나를 실행합니다.

PowerShell (Admin)
wsl --install

완료한 다음 PC를 다시 시작합니다. 다시 시작은 선택 사항이 아니며 가상화 구성 요소를 로드합니다. 다시 시작한 후 Ubuntu(기본 배포판)는 자체 설정을 완료하고 Linux 사용자 이름과 비밀번호를 생성하라는 메시지를 표시합니다.

⚠️ 해당 Linux 비밀번호는 sudo 전용입니다. 입력하는 동안 화면에 아무 것도 표시되지 않으므로 기억할 만한 비밀번호를 선택하세요. 그리고 배포판을 절반만 만든 상태로 두지 마십시오. 첫 번째 실행이 완료되지 않은 배포판은 처음 시작할 때 Docker Desktop이 중단되는 가장 일반적인 숨겨진 원인입니다.
3

WSL 2가 실제로 준비되었는지 확인

Docker가 머신 근처로 이동하기 전에 다음 두 명령을 사용하여 기반을 확인하세요.

PowerShell
wsl --status
wsl -l -v

배포판에는 목록에 VERSION 2가 표시되어야 합니다. 1이 표시되면 기본 버전을 설정하고 명령 출력에 표시된 대로 배포판을 변환합니다.

PowerShell
wsl --set-default-version 2

각 레이어는 다음 레이어가 진행되기 전에 테스트되므로 나중에 문제가 발생하면 문제가 발생한 레이어를 정확히 알 수 있습니다.

4

상단에 Docker Desktop 설치

docker.com에서만 Docker Desktop을 다운로드하세요. 타사 다운로드 사이트는 인기 있는 설치 프로그램과 함께 정크를 번들로 제공합니다. 설치 프로그램을 실행하고 Hyper-V 대신 WSL 2 사용 옵션을 선택한 상태로 유지하세요. 대부분의 PC에서는 기본적으로 선택되어 있습니다.

설치 프로그램이 요청하면 닫고 로그아웃하거나 메시지가 나타나면 다시 시작하십시오. Docker는 Windows 계정을 로컬 docker-users 그룹에 추가하고 그룹 멤버십은 새로 로그인할 때만 적용됩니다. 이는 대부분의 가이드가 건너뛰는 정직한 확인이며, 로그아웃했다가 다시 로그인할 때까지 Docker가 때때로 시작을 거부하는 이유입니다.

Docker Desktop을 시작하고 시스템 트레이의 고래 아이콘이 안정되고 대시보드에 엔진 실행 중이 보고될 때까지 기다립니다. 첫 번째 시작은 느립니다. 몇 분만 기다려주세요. Docker 구독 서비스 계약 화면을 정직하게 수락하세요. 이는 실제 라이선스입니다.

✅ 팁: Ubuntu와 PowerShell 내에서 docker 명령을 사용하려면 Docker 데스크톱 설정을 열고 리소스, WSL 통합으로 이동하여 배포판을 켜세요.
5

첫 번째 컨테이너 실행 — Hello World

새로운 PowerShell 또는 터미널 창을 열고 전체 체인이 작동함을 증명하는 두 명령을 실행합니다.

PowerShell
docker --version
docker run hello-world

docker --version은 클라이언트가 PATH에 설치되어 있음을 증명합니다. docker run hello-world는 그 밖의 모든 것을 증명합니다. Docker는 로컬에서 이미지를 찾을 수 없으며 Docker Hub에서 이미지를 다운로드하고 여기에서 컨테이너를 생성하여 실행한 후 Hello from Docker! 메시지를 인쇄합니다. 해당 메시지가 나타나면 터미널, 클라이언트, WSL 2 내부 엔진, 네트워크 및 레지스트리 등 체인이 엔드 투 엔드로 작동하는 것입니다.

⚠️ 두 가지 정직한 경고. 첫째, 첫 번째 실행에서는 끌어오기를 위해 인터넷이 필요합니다. 실패할 경우 맹목적으로 다시 설치하지 마세요. 어떤 계층(WSL, 엔진, 네트워크)이 실제로 실패했는지 확인하세요. 둘째, Docker Desktop은 단순히 모든 사람에게 "무료"인 것이 아닙니다. 개인 용도, 교육용, 비상업적 오픈 소스 및 Docker가 게시하는 크기 제한이 적용되는 소규모 기업에서는 무료이며, 대기업에서는 사용자별 유료 구독이 가능합니다. 직장에 설치하는 경우 회사가 해당 라인의 어느 쪽에 있는지 확인하세요.

🏷️주제 검색 변수 및 키워드

🔍 Docker 🔍 Docker Desktop 🔍 WSL 2 🔍 Docker Install Windows 🔍 hello-world Container 🔍 docker-users Group 🔍 Virtualization 🔍 Ubuntu on Windows 🔍 Docker on Windows 10 🔍 Docker on Windows 11 🔍 First Container Setup 🔍 TechnicalAnshu
🎙️ 전체 대본 — 탭하여 펼치기

__TOK_28__

__TOK_29__

❓ 자주 묻는 질문

이 튜토리얼은 100% 무료로 따라할 수 있나요?

__TOK_30__

초보자도 이 가이드를 따라갈 수 있나요?

__TOK_31__

막힐 경우 어디에 질문을 할 수 있나요?

__TOK_32__

🚀 YouTube에서 전체 튜토리얼 보기

__TOK_33__

__TOK_34__

▶️ 전체 동영상 보기
이 튜토리얼은 Technical Anshu의 WSL 2에 Docker 설치 비디오를 기반으로 합니다. • 어떤 단계에서 막히나요? 영상 댓글로 문의하시면 도움을 받으실 수 있습니다 🙏