설치 문서

참고 강의
Docker hub 회원가입
- 도커 이미지 저장소(클라우드)
- 도커 이미지를 올리고 받을 수 있는 중앙 서버
- 깃허브가 코드 저장소라면 도커허브는 이미지 저장소
🎯 Docker Hub는 어떤 일을 할까?
기능 | 설명 |
🔍 이미지 검색 | mysql , nginx , php , node 등 인기 이미지 검색 가능 |
⬇️ 이미지 다운로드(pull) | 내 서버에 이미지 가져오기 → docker pull mysql |
⬆️ 이미지 업로드(push) | 내가 만든 이미지 업로드 가능 (로그인 필요) |
🧑💻 공유/협업 | 다른 사람과 이미지 공유 (Public/Private 설정 가능) |
📦 용어 정리 먼저
용어 | 의미 |
Docker | 앱, 환경, 의존성을 하나로 감싼 컨테이너 플랫폼 |
Image | 컨테이너의 설계도 (앱+환경 포함) |
Container | 이미지를 실행한 실제 인스턴스 |
Docker Hub | 이미지들을 올리고 공유하는 중앙 저장소 (레지스트리) |

Docker
Windows 10이면 HyperV + 가상 머신 플랫폼 설치 필요
Windows 11부터는 WSL 권장

→ Windows 다운로드 시 AMD64인지 ARM64인지 확인하고 다운로드 진행
→ 램 최소 16GB 필요 / Mac 이면 가장 좋음 (신경쓸 게 없다 - Mac 이 Linux 기반이라서) / Windows는 Linux 기반이기 때문에 Linux인척 해야하는데 HyperV와 리눅스 하위시스템 둘 중 하나를 설치해야한다 (가상화기술)
→ 리눅스 하위 시스템 (WSL2)
- 역할: WSL 2(Windows Subsystem for Linux 2)는 Windows 10 버전 2004 이상 또는 Windows 11에서 사용할 수 있는, 리눅스 커널을 포함하는 가상화 기술입니다. Docker Desktop은 이 WSL 2를 사용하여 리눅스 VM을 실행하고 도커 엔진을 구동하는 것을 권장합니다. Hyper-V보다 더 빠르고 효율적인 리눅스 커널 통합을 제공하기 때문입니다.
- 조건:
Windows 10 버전 2004 이상
(빌드 19041 이상)Windows 11 홈
버전 이상- 중요: Windows 10 Home 버전에서는 Hyper-V를 사용할 수 없기 때문에, Docker Desktop을 설치하려면 반드시 WSL 2를 사용해야 합니다. Windows 10 Pro 이상에서는 Hyper-V와 WSL 2 중 선택하여 사용할 수 있지만, 성능상 WSL 2가 권장됩니다.
→ HyperV 설치
- 역할: Hyper-V는 Microsoft의 가상화 기술입니다. Docker Desktop은 이 Hyper-V 위에 경량의 리눅스 가상 머신(VM)을 생성하여 도커 엔진을 구동합니다. 이 VM이 Windows에서 리눅스 컨테이너를 실행할 수 있도록 '리눅스인 척'하는 기반 환경을 제공합니다.
- 조건:
Windows 10 Pro, Enterprise, Education
버전 이상에서만 기본적으로 지원됩니다. (Home 버전은 Hyper-V가 없습니다.)

→ Windows 11 이상이면 HyperV 체크하고 재부팅 진행 (둘 다 상관없음)

실행 확인

요약:
- Windows 10 Pro 이상: Hyper-V 또는 WSL 2 (WSL 2 권장)
- Windows 10 Home: 반드시 WSL 2
- Windows 11 (Home 포함 모든 버전): WSL 2 (권장)

- Hyper-V: Windows에서 리눅스 컨테이너를 실행하기 위해, Docker Desktop은 Hyper-V를 사용하여 Windows 위에 작은 리눅스 가상 머신을 만들고, 그 가상 머신 안에서 도커 엔진을 실행합니다. 이 리눅스 VM이 '리눅스인 척'하며 컨테이너를 구동하는 기반을 제공합니다.
- WSL 2: WSL 2는 Hyper-V 위에 구축된 더 효율적인 리눅스 환경입니다. Docker Desktop은 WSL 2를 백엔드로 사용함으로써, 더 빠르고 가벼우며 Windows와 더 잘 통합된 환경에서 도커 컨테이너를 실행할 수 있게 됩니다. 특히 Windows Home 버전에서는 Hyper-V가 없으므로, Docker Desktop을 사용하려면 WSL 2가 필수적입니다.
Tip 도커 실행이 안되면
WSL 최신버전인지 확인하기

명령어 실행
- 도커 이미지(ubuntu)를 다운로드(pull)하는 명령어
docker pull ubuntu

- 도커 클라이언트가 Docker Hub에 요청함
- 기본 레지스트리: https://hub.docker.com/_/ubuntu
- 최신 우분투 이미지(
ubuntu:latest
)를 로컬로 다운로드 - 내부적으로는
ubuntu:latest
==ubuntu:<최신 버전>
(ex: 22.04)
- 이미지 다운로드 완료 후,
docker images
명령어로 확인 가능
docker images

- Ubuntu 컨테이너를 실행하고, 그 안에 bash 쉘로 들어가는 명령어
- 빠져나올 땐
exit
docker run -it ubuntu bash

- 현재 실행 중(RUNNING)인 컨테이너 목록을 확인하는 명령어
docker ps

컬럼 | 설명 |
CONTAINER ID | 컨테이너의 고유 ID |
IMAGE | 실행 중인 컨테이너가 사용한 이미지 이름 |
COMMAND | 컨테이너가 실행 중인 명령어 (예: bash ) |
CREATED | 컨테이너가 생성된 시간 |
STATUS | 현재 상태 (Up = 실행 중, Exited = 종료) |
PORTS | 연결된 포트 (포트포워딩 설정 시 표시) |
NAMES | 컨테이너 이름 (자동 생성되거나 수동 지정) |
자주 쓰는 옵션
docker ps -a
→ 모든 컨테이너 목록을 보여줌 (실행 중 + 종료된 컨테이너 모두)
docker ps -q
→ 컨테이너 ID만 출력
- Docker hub에서 tomcat 다운로드


- Docker에서 Tomcat 9.0 이미지를 실행하는 명령어
docker run -dit --rm tomcat:9.0

docker ps

Share article