단계별 가이드: Windows 및 macOS에 Docker Desktop 설치하기

Docker Desktop은 Windows 또는 macOS 노트북에서 컨테이너를 실행하려는 경우 일반적인 시작점입니다. 설치는 간단하지만, 일부 시스템 설정으로 인해 설치 프로그램이 완료된 후 Docker가 시작되지 않을 수 있습니다.

이 가이드는 Windows 및 macOS에 Docker Desktop을 설치한 다음 Docker CLI, Docker Engine 및 테스트 컨테이너가 올바르게 작동하는지 확인하는 과정을 안내합니다.

Docker Desktop이 설치하는 것

Docker Desktop은 Docker CLI, Docker Engine, Docker Compose, 데스크톱 대시보드 및 선택적 Kubernetes 지원을 포함한 로컬 Docker 환경을 제공합니다. Windows에서 Docker Desktop은 일반적으로 WSL 2를 통해 Linux 컨테이너를 실행합니다. macOS에서는 경량 Linux 가상 머신 내에서 컨테이너를 실행합니다.

일상적인 개발을 위해 다음과 같은 명령을 실행할 수 있습니다:

docker run hello-world
docker compose up
docker build -t my-app .

별도의 Docker Engine 패키지를 먼저 설치할 필요가 없습니다.

먼저 요구 사항 확인

Docker는 시간이 지남에 따라 플랫폼 요구 사항을 변경하므로, 오래된 머신에 설치하기 전에 Docker의 현재 문서를 확인하세요. 대부분의 최신 설정에서는 다음 기본 사항을 확인해야 합니다.

Windows 요구 사항

지원되는 64비트 Windows 버전을 사용하고 Windows를 업데이트된 상태로 유지하세요. Docker Desktop은 WSL 2 백엔드에서 가장 잘 작동하므로, 설정 중이나 설정 전에 WSL을 설치하세요:

wsl --install

관리자 권한 PowerShell 또는 명령 프롬프트에서 해당 명령을 실행한 다음, Windows에서 요청하면 다시 시작하세요.

또한 하드웨어 가상화를 확인하세요. 작업 관리자를 열고 성능으로 이동한 다음 CPU를 선택하고 가상화: 사용을 확인하세요. 비활성화된 경우 BIOS 또는 UEFI 설정에서 활성화하세요.

Docker Desktop은 Windows Server가 아닌 데스크톱 Windows 환경용입니다.

macOS 요구 사항

Apple Silicon 또는 Intel Mac에서 지원되는 macOS 릴리스를 사용하세요. 칩 유형에 맞는 올바른 설치 프로그램을 다운로드하세요. 어떤 Mac을 사용 중인지 확실하지 않은 경우 Apple 메뉴 > 이 Mac에 관하여를 열고 칩 또는 프로세서 라인을 확인하세요.

Docker Desktop은 Linux VM을 실행하고 이미지를 저장하기에 충분한 메모리와 디스크 공간이 필요합니다. 로컬에서 데이터베이스 또는 다중 서비스 스택을 실행할 계획이라면 설치 후 설정에서 Docker에 더 많은 메모리를 할당하세요.

Windows에 Docker Desktop 설치

Docker 공식 웹사이트에서 Docker Desktop을 다운로드하세요. 개발자 도구의 경우 타사 다운로드 미러를 피하세요.

.exe 설치 프로그램을 실행하고 나타나면 WSL 2 옵션을 활성화된 상태로 유지하세요. 설치 프로그램이 필요한 Windows 구성 요소를 추가하도록 요청하면 허용하세요. 설치 후 메시지가 표시되면 컴퓨터를 다시 시작하세요.

시작 메뉴에서 Docker Desktop을 엽니다. 처음 실행 시 라이선스 약관에 동의하고 Docker가 설정을 완료하도록 하세요. Docker에서 WSL 문제를 보고하면 WSL을 업데이트하고 다시 시도하세요:

wsl --update

회사 노트북을 사용하는 경우 엔드포인트 보안 소프트웨어가 가상화 또는 로컬 네트워킹을 방해할 수 있습니다. 이 경우 방화벽 또는 바이러스 백신 설정을 변경하기 전에 회사의 Docker Desktop 정책을 확인하세요.

macOS에 Docker Desktop 설치

Docker 공식 웹사이트에서 Mac용 Docker Desktop을 다운로드하세요. M 시리즈 Mac의 경우 Apple Silicon 설치 프로그램을, Intel Mac의 경우 Intel 설치 프로그램을 선택하세요.

.dmg 파일을 열고 Docker를 Applications 폴더로 드래그하세요. Applications에서 Docker를 실행하세요. macOS에서 네트워킹 및 가상화에 사용되는 도우미 구성 요소를 설치하기 위해 비밀번호 또는 권한을 요청할 수 있습니다.

Docker Desktop이 시작되면 메뉴 막대 아이콘이 Docker가 실행 중임을 표시할 때까지 기다리세요. 첫 번째 시작은 Docker가 로컬 VM 및 스토리지를 생성하기 때문에 더 오래 걸릴 수 있습니다.

설치 확인

터미널을 열고 Docker 클라이언트와 서버를 확인하세요:

docker version

클라이언트 섹션과 서버 섹션이 모두 표시되어야 합니다. 클라이언트 정보만 표시되거나 데몬에 연결하는 중 오류가 발생하면 Docker Desktop이 아직 실행 중이 아니거나 시작에 실패한 것입니다.

표준 테스트 컨테이너를 실행하세요:

docker run hello-world

Docker가 작은 이미지를 다운로드하여 실행합니다. 성공적으로 실행되면 Docker가 작동 중임을 설명하는 메시지가 출력됩니다.

Docker Compose도 확인할 수 있습니다:

docker compose version

Docker Desktop에 포함된 Compose v2의 경우 공백으로 구분된 docker compose 명령을 사용하세요.

첫 번째 설정 조정

첫 번째 성공적인 테스트 후 Docker Desktop 설정을 엽니다.

Windows에서 리소스 > WSL 통합을 확인하고 개발 명령을 실행하는 Linux 배포판에 대한 통합을 활성화하세요. WSL에서 Ubuntu를 사용하는 경우 Ubuntu 셸에서 docker를 실행할 수 있습니다.

Windows와 macOS 모두에서 리소스를 검토하세요. 소규모 프로젝트는 기본값으로 잘 실행될 수 있지만, 로컬 Kubernetes, 데이터베이스 및 대규모 빌드는 종종 더 많은 메모리나 디스크 공간이 필요합니다.

로컬 단일 노드 클러스터가 필요한 경우에만 Kubernetes를 활성화하세요. 비활성화된 상태로 두면 Docker Desktop이 더 가볍게 유지됩니다.

일반적인 설치 문제

Windows에서 Docker가 시작되지 않으면 먼저 가상화가 활성화되어 있고 WSL이 설치되어 있는지 확인하세요:

wsl --status

WSL이 오래된 경우 다음을 실행하세요:

wsl --update

docker version이 Docker 데몬에 연결할 수 없는 경우 Docker Desktop이 실행 중이고 시작이 완료되었는지 확인하세요. macOS에서는 메뉴 막대 아이콘을 확인하세요. Windows에서는 시스템 트레이를 확인하세요.

테스트 컨테이너가 네트워크에 연결할 수 없는 경우 다른 네트워크 또는 VPN 상태에서 테스트하세요. VPN 클라이언트 및 회사 프록시는 종종 Docker 네트워킹에 영향을 미칩니다. Docker Desktop에는 환경에서 필요한 경우 구성할 수 있는 프록시 설정이 있습니다.

docker run hello-world가 작동하면 로컬 컨테이너 환경이 준비된 것입니다. 좋은 다음 단계는 이미 알고 있는 서비스(예: Nginx)를 실행하는 것입니다:

docker run --rm -p 8080:80 nginx

그런 다음 http://localhost:8080을 엽니다. Nginx 시작 페이지가 표시되면 Docker가 이미지를 가져오고, 컨테이너를 시작하고, 머신에서 포트를 게시할 수 있습니다.