[ Docker ] Docker 설치 가이드

시스템 실행 환경

OS	Ubuntu 24.04.2
실행 환경	Virtual Box
Docker	28.1.1

 

🌐 참고 사이트: https://docs.docker.com/engine/install/ubuntu/

Ubuntu

Dodkcer 공식 사이트에서 안내하는 대로 진행하였습니다.

자세한 내용은 위 참고 사이트에서 확인하실 수 있습니다😁

 

 

Docker Engine

Docker Engine은 컨테이너를 만들고 실행하는 데 사용하는 핵심 소프트웨어 플랫폼입니다.

애플리케이션과 실행에 필요한 모든 환경(라이브러리, 종속성 등)을 하나의 컨테이너 이미지로 패키징하고,
이를 일관된 방식으로 실행할 수 있게 해 줍니다.

 

🚨 방화벽 제한 사항

Docker를 사용할 때 방화벽과의 호환성 문제나 포트 노출 우회와 같은 이슈에 주의해야 합니다.

 

1. ufw, firewalld를 사용하는 경우

ufw(Ubuntu 기본 방화벽), firewalld(CentOS/RHEL 계열)를 사용하여 방화벽 설정을 관리하는 경우
Docker를 통해 컨테이너 포트를 외부에 노출하면 방화벽 규칙을 우회할 수 있습니다.

 

2. Docker는 iptables-nft가 아닌 iptables-legacy만 지원

Docker는 nft로 만들어진 방화벽 규칙을 지원하지 않습니다.

Docker가 설치된 시스템에서는 방화벽 규칙을 만들 때:

• iptables 또는 ip6tables를 사용해야 합니다.
• 방화벽 규칙은 DOCKER-USER 체인에 추가해야 Docker의 기본 체인보다 우선 적용됩니다.

nft = nftables
Linux에서 방화벽 기능을 제공하는 최신 프레임워크
기존의 iptables, ip6tables, arptables, ebtables를 통합한 후계 시스템

 

 

Docker 설치

이전 버전 삭제

Docker Engine을 설치하기 전에 일부 Linux 배포판에 포함된 비공식 Docker 패키지가 공식 패키지와 충돌할 수 있으므로
반드시 기존 패키지를 먼저 제거해야 합니다.

• docker.io
• docker-compose
• docker-compose-v2
• docker-doc
• podman-docker
• containerd
• runc

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

⚠️ 위 명령어를 실행해도 /var/lib/docker 디렉터리에 저장된 데이터는 남아있습니다.

• 이미지
• 컨테이너
• 볼륨
• 네트워크 설정

Docker를 완전히 초기화하고 싶을 경우 해당 경로도 수동으로 삭제해야 합니다.

 

 

설치 과정

apt 명령어를 사용해 Docker의 공식 저장소에서 최신 버전의 Docker Engine을 설치합니다.

 

1. Docker 공식 apt 저장소 등록

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl -y
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

 

Docker 저장소를 추가하기 위해 ca-certificates와 curl 등 필수 패키지를 설치합니다.

이후 GPG 키를 저장할 디렉터리를 생성하고, Docker의 공식 GPG 키를 다운로드한 뒤 읽기 권한을 설정합니다.

마지막으로, Docker의 저장소를 APT 소스 목록에 추가하고 apt-get update 명령어를 실행하여 패키지 정보를 갱신합니다.

 

2. Docker 설치 명령어 실행

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

패키지 명	설명
docker-ce	Docker Community Edition Docker Engine 그 자체
docker-ce-cli	Docker CLI
containerd.io	Docker 내부에서 사용하는 컨테이너 런타임
docker-buildx-plugin	BuildKit 기반의 고급 이미지 빌드를 위한 플러그인
docker-compose-plugin	Docker Compose V2 플러그인

 

3. Docker 설치 확인

docker --version