2025년 리눅스 도커 설치 완벽 가이드 우분투 데비안 CentOS 최신 버전 확인하기

컨테이너 기술의 핵심인 도커(Docker)는 개발 및 운영 환경을 일관성 있게 유지할 수 있게 해주는 필수 도구입니다. 리눅스 환경에서 도커를 설치하는 것은 개발 워크플로우를 최적화하는 첫걸음이며, 특히 2025년 최신 환경에서는 설치 과정에서 몇 가지 중요한 업데이트 사항을 확인해야 합니다. 이 가이드에서는 가장 많이 사용되는 리눅스 배포판인 우분투(Ubuntu), 데비안(Debian), CentOS(또는 Rocky Linux/AlmaLinux)를 중심으로 도커 엔진(Docker Engine)을 설치하는 가장 확실하고 공식적인 방법을 안내합니다.

특히 2024년까지의 설치 방식에서 변경된 부분을 반영하여, 현재 시점(2025년 12월)에 가장 안정적이고 권장되는 설치 절차를 상세히 설명하고, 설치 후 필수적으로 수행해야 하는 사용자 그룹 설정 및 시스템 관리 방법까지 다룹니다. 이 정보를 통해 여러분은 빠르고 안전하게 리눅스 환경에 도커를 구축할 수 있습니다.

리눅스 도커 설치 전 필수 요구 사항 확인하기

성공적인 도커 설치를 위해선 시스템이 도커의 최소 요구 사항을 충족하는지 확인하는 것이 중요합니다. 대부분의 최신 리눅스 배포판은 요구 사항을 충족하지만, 특히 커널 버전과 아키텍처를 확인해야 합니다.

• 운영체제 아키텍처: 64비트(x86_64) 아키텍처가 필수입니다.
• 리눅스 커널 버전: 최소 3.10 버전 이상이 필요하며, 최신 기능과 안정성을 위해서는 4.x 또는 5.x 이상 버전이 권장됩니다. (예: 우분투 20.04/22.04는 기본적으로 충족)
• 저장소: 도커 이미지를 저장할 충분한 공간이 필요합니다.

또한, 도커를 설치하기 전에 기존에 설치되어 있을 수 있는 비공식 도커 버전(docker.io 등)이나 구버전 패키지를 제거하여 충돌을 방지해야 합니다. 다음 명령어를 사용하여 정리할 수 있습니다. (배포판에 따라 명령어는 달라질 수 있습니다.)

sudo apt-get remove docker docker-engine docker.io containerd runc

가장 중요한 것은 공식 저장소(Repository)를 통해 설치하는 것입니다. 2025년 현재, 비공식 저장소나 단일 설치 스크립트보다는 도커 공식 저장소를 시스템에 등록하여 설치하는 것이 가장 권장되며 안정적인 방법입니다. 이 방식은 지속적인 보안 패치와 버전 업데이트를 가장 쉽게 관리할 수 있게 해줍니다.

데비안 및 우분투 리눅스 도커 엔진 설치 상세 더보기

데비안(Debian)과 우분투(Ubuntu)는 APT 패키지 관리자를 사용하여 도커를 설치합니다. 절차는 공식 GPG 키 추가, 저장소 설정, 패키지 설치의 세 단계로 나뉩니다.

Step 1: 필요한 패키지 설치 및 GPG 키 추가 보기

먼저 HTTPS를 통해 저장소를 설정하는 데 필요한 유틸리티를 설치하고, 도커 공식 GPG 키를 다운로드하여 추가합니다. 이 키는 다운로드하는 패키지의 신뢰성을 검증하는 데 사용됩니다.

# 패키지 업데이트 및 기본 유틸리티 설치 sudo apt-get update sudo apt-get install ca-certificates curl gnupg
도커 공식 GPG 키 다운로드 및 추가
sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg

Step 2: 도커 APT 저장소 설정 보기

이제 GPG 키를 등록했으므로, 도커 APT 저장소를 시스템에 등록합니다. 아키텍처와 OS 버전에 맞게 설정해야 합니다. (아래 예시는 x86_64 아키텍처 기준입니다.)

# 저장소 추가 (우분투 예시) echo
"deb [arch="(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] [https://download.docker.com/linux/ubuntu](https://download.docker.com/linux/ubuntu) \ "(. /etc/os-release && echo "$VERSION_CODENAME")" stable" |
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Step 3: 도커 엔진 및 도구 설치 확인하기

저장소 설정이 완료되면, APT 패키지 목록을 업데이트하고 최신 버전의 도커 엔진, CLI, 및 Compose 플러그인을 설치합니다.

sudo apt-get update
도커 엔진, CLI, containerd 및 Compose 설치
sudo apt-get install docker-engine docker-cli containerd.io docker-compose-plugin

CentOS 및 RHEL 계열 리눅스 도커 엔진 설치 상세 더보기

CentOS, Fedora, Rocky Linux, AlmaLinux와 같은 RHEL(Red Hat Enterprise Linux) 계열 배포판은 YUM 또는 DNF 패키지 관리자를 사용합니다. 2024년 이후 CentOS 7의 지원 종료와 함께, CentOS Stream, Rocky Linux, AlmaLinux 사용자가 늘어나고 있으며, 이들은 DNF를 주로 사용합니다.

Step 1: DNF 유틸리티 설치 및 저장소 설정 보기

RHEL 계열에서는 dnf-utils를 사용하여 저장소를 관리하고, 도커 공식 저장소를 설정합니다. 이 저장소에는 도커 엔진 및 관련 도구가 포함되어 있습니다.

# 필요한 유틸리티 설치 sudo dnf install -y dnf-utils
도커 안정화(Stable) 저장소 추가
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Step 2: 도커 엔진 설치 확인하기

저장소 설정 후, docker-ce (Community Edition), docker-ce-cli, containerd.io를 설치합니다.

# 도커 엔진 설치 sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

도커 설치 후 필수 설정 및 테스트 보기

설치를 완료했다고 해서 바로 사용 가능한 것은 아닙니다. 보안 및 사용 편의성을 위해 몇 가지 추가 설정이 필요합니다.

도커 서비스 시작 및 부팅 시 자동 실행 설정 확인하기

도커 서비스는 설치 후 자동으로 시작되지 않을 수 있습니다. systemctl을 사용하여 서비스를 시작하고, 시스템 부팅 시 자동으로 실행되도록 설정해야 합니다.

# 도커 서비스 시작 sudo systemctl start docker
부팅 시 자동 실행 설정
sudo systemctl enable docker

sudo 없이 도커 사용을 위한 사용자 그룹 추가 신청하기

기본적으로 도커 명령을 실행하려면 sudo를 사용해야 합니다. 이는 보안상 권장되지만, 개발 편의성을 위해 현재 사용자를 docker 그룹에 추가하여 sudo 없이 도커를 사용할 수 있게 설정할 수 있습니다. 이 설정은 보안에 민감한 환경에서는 신중하게 고려해야 합니다.

# 현재 사용자를 docker 그룹에 추가 sudo usermod -aG docker $USER
그룹 적용을 위해 시스템 재부팅 또는 재로그인 필요
새로운 쉘에서 다음 명령어로 확인
docker run hello-world

그룹 추가 후에는 반드시 로그아웃했다가 다시 로그인하거나 시스템을 재부팅해야 변경 사항이 적용됩니다. 재로그인 후 sudo 없이 docker run hello-world를 실행하여 설치가 성공했는지 최종적으로 확인합니다.

도커 버전 확인 및 문제 해결 팁 상세 더보기

성공적인 설치의 마지막 단계는 설치된 도커의 버전과 상태를 확인하는 것입니다. 문제가 발생했을 경우 기본적인 문제 해결 팁을 참고하여 신속하게 조치할 수 있습니다.

도커 버전 확인 및 상태 점검 보기

설치된 도커 엔진 및 클라이언트의 버전을 확인하고, 도커 서비스의 현재 상태를 점검합니다.

# 도커 버전 확인 docker --version docker version
도커 서비스 상태 확인
sudo systemctl status docker

상태(Status)가 active (running)으로 표시되면 정상적으로 작동 중인 것입니다.

일반적인 설치 문제 해결 팁 확인하기

• “permission denied” 오류: 대부분 sudo 없이 도커 명령을 실행하려 했으나, 사용자가 docker 그룹에 추가되지 않았거나 재로그인을 하지 않았을 때 발생합니다. 위의 ‘사용자 그룹 추가’ 단계를 다시 확인하세요.
• 패키지 찾을 수 없음: GPG 키나 도커 저장소 URL을 잘못 입력했거나, OS 코드네임(예: focal, jammy)이 잘못 입력되었을 때 발생합니다. APT/DNF 저장소 설정 단계를 다시 확인하고 시스템의 코드네임을 정확히 입력했는지 확인해야 합니다.
• “Cannot connect to the Docker daemon” 오류: 도커 서비스가 실행 중이 아닐 때 발생합니다. sudo systemctl start docker 명령으로 서비스를 시작하고 sudo systemctl status docker로 상태를 확인하세요.

자주 묻는 질문 (FAQ)