Rocky Linux AlmaLinux Docker 설치 및 오류 해결
Rocky Linux와 AlmaLinux에 Docker Engine을 설치하는 올바른 방법을 안내합니다. Podman과의 명령어 충돌 문제와 SELinux 바인드 마운트 차단 오류를 해결하는 실무 설정을 포함하며, 공식 저장소를 이용한 안전한 패키지 관리법을 상세히 설명합니다.
Rocky Linux 및 AlmaLinux에 Docker 설치하기
Rocky Linux나 AlmaLinux에 Docker를 설치하려면 Docker의 공식 dnf 저장소를 추가하고, compose 플러그인과 함께 엔진을 설치한 뒤 서비스를 활성화해야 합니다. 이 과정은 4개의 명령어로 구성되며, 두 배포판 모두 Red Hat Enterprise Linux(RHEL)를 기반으로 재구축되어 패키지 구조를 공유하므로 동일하게 적용됩니다. CentOS Stream도 같은 방식으로 작동합니다. 아래의 모든 내용은 두 배포판에 공통으로 적용되므로, 아직 선택 중이라면 각 프로젝트가 제공하는 호환성 약속과 구형 CPU 지원 여부가 결정 요인이 됩니다.
설치 과정은 짧으므로, 이 가이드의 대부분은 Enterprise Linux(EL)가 Ubuntu와 다르게 동작하는 부분을 다룹니다. 이미지에 따라 Podman이 이미 docker 명령어를 점유하고 있을 수 있습니다. SELinux는 Docker의 SELinux 지원 기능을 켰을 때만 컨테이너를 제한하며, 그 이후부터는 적절한 레이블이 지정되지 않은 바인드 마운트 파일을 차단합니다. Firewalld는 Docker가 게시한 포트를 필터링하지 않으므로, firewall-cmd에서는 아무것도 열려 있지 않다고 보고하더라도 컨테이너 포트는 인터넷에 노출될 수 있습니다.
get.docker.com에서 제공하는 Docker의 편의 스크립트는 사용하지 마십시오. Docker 공식 문서에서도 프로덕션 환경에는 권장하지 않는다고 명시하고 있습니다. 이 스크립트는 사용자 동의 없이 저장소 설정을 재작성하며, 업그레이드를 위해 안전하게 재실행할 수 없습니다. 저장소를 직접 추가하면 dnf upgrade이 Docker를 시스템의 다른 모든 패키지와 동일하게 관리합니다. 또한 이렇게 하면 보안 업데이트를 타이머 기반으로 적용하는 dnf-automatic의 관리 범위에 엔진이 포함되므로, Docker를 자동으로 패치할지 아니면 유지보수 기간에 맞춰 수동으로 업데이트할지 일찍 결정해야 합니다. 어느 쪽이든 업그레이드가 진행되면 패키지된 바이너리는 교체되지만 기존 dockerd은 계속 실행 상태로 남으며, needs-restarting은 방금 교체한 코드를 여전히 실행 중인 서비스를 알려주는 명령어입니다.
Podman이 이미 docker 명령에 응답하고 있습니까?
Rocky Linux와 AlmaLinux는 기본 저장소에 podman을 포함하고 있으며, 많은 VPS 이미지가 이를 자동으로 설치합니다. 일부 이미지는 한 걸음 더 나아가 podman-docker를 설치하는데, 이는 /usr/bin/docker에 podman을 호출하는 셸 스크립트를 배치합니다. 따라서 입력하는 모든 docker 명령은 대신 podman을 실행하게 되며, Docker를 기준으로 작성된 가이드는 예상치 못한 결과를 출력하게 됩니다.
가장 먼저 확인할 수 있는 신호는 배너입니다. /usr/bin/docker 스크립트는 /etc/containers 및 사용자의 ~/.config/containers 디렉터리(설정한 경우 $XDG_CONFIG_HOME 하위)에서 nodocker이라는 파일을 찾습니다. 두 위치 모두에 파일이 존재하지 않으면, 스크립트는 명령을 실행하기 전에 다음 한 줄을 출력합니다.
Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.누군가 배너를 숨기기 위해 해당 파일을 생성했을 수도 있으므로, 이 신호에만 의존해서는 안 됩니다. 패키지 데이터베이스에 해당 바이너리를 소유한 패키지가 무엇인지 확인하십시오.
command -v docker
rpm -qf "$(command -v docker)"podman-docker으로 시작하는 결과가 나오면 podman이 응답하고 있는 것입니다. docker-ce-cli로 시작하는 결과가 나오면 실제 Docker입니다. rpm -qf가 해당 파일을 소유한 패키지가 없다고 보고한다면, 누군가 수동으로 설치한 것이므로 신뢰하기 전에 스크립트 내용을 확인해야 합니다.
Podman은 동일한 OCI 이미지를 실행하며 합리적인 선택지입니다. Podman을 사용하려 한다면 여기서 멈추십시오. 둘 다 리눅스 컨테이너 엔진이므로, 플랫폼 결정이 아직 내려지지 않았다면 FreeBSD jails는 레지스트리에서 가져온 계층형 이미지를 실행하는 대신 전체 사용자 공간을 격리한다는 점을 알아두는 것이 좋습니다. Docker Engine을 원한다면 먼저 충돌하는 패키지를 제거하십시오. 다음은 RHEL용으로 Docker가 문서화한 목록입니다.
sudo dnf remove docker docker-client docker-client-latest docker-common \
docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runc확인하기 전에 dnf가 함께 제거하려는 패키지 목록을 읽어보십시오. 새로 설치된 VPS 이미지에서는 목록이 짧습니다. 이미 사용 중인 서버라면 podman을 제거할 때 cockpit-podman나 이에 의존하는 다른 도구가 함께 삭제될 수 있습니다.
원칙적으로 podman과 Docker를 함께 유지하는 것은 가능합니다. docker 이름을 비우기 위해 podman-docker만 제거하고, containerd.io 패키지가 대체하는 runc을 제거하면 됩니다. Docker의 문서는 podman을 충돌 패키지로 간주하므로, 이 구성은 Docker가 지원하는 방식이 아닙니다. 설치 과정에서 여전히 충돌이 보고된다면 위의 전체 제거 목록을 사용하십시오.
dnf config-manager를 사용하여 Docker 저장소 추가하기
Docker는 Enterprise Linux용 RPM을 download.docker.com에 게시합니다. 저장소 파일은 CentOS 트리를 가리키며, Rocky Linux와 AlmaLinux는 이 트리를 참조하여 해결합니다. Red Hat이 2020년에 CentOS를 Stream으로 전환한 후 두 배포판이 모두 CentOS 계보에서 어떻게 발전했는지 알기 전까지는 Rocky 시스템을 CentOS 저장소에 연결하는 것이 실수처럼 보일 수 있습니다. 2026년 11월 10일 확인 결과, Docker는 CentOS Stream 9 및 CentOS Stream 10에 대해 이 저장소를 문서화하고 있습니다.
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repodnf 버전 5부터는 --add-repo 인수가 제거되었으므로, 최신 릴리스에서는 두 번째 명령이 실패합니다. 사용 중인 버전을 확인한 후 일치하는 형식을 선택하십시오.
dnf --version출력된 버전이 5.x라면 대신 하위 명령 형식을 사용하십시오.
sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/centos/docker-ce.repo두 명령 모두 /etc/yum.repos.d/docker-ce.repo에 동일한 파일을 작성합니다. 잘못된 형식을 사용하면 조용히 오류가 발생하는 대신 알 수 없는 인수 오류가 발생하므로, 이를 놓칠 일은 없습니다.
해당 저장소 파일은 baseurl을 $releasever을 포함하는 경로로 설정하며, dnf는 릴리스 패키지에서 이 변수를 확장합니다. Rocky Linux와 AlmaLinux는 이를 메이저 버전 번호로 설정하므로 EL 9에서는 9, EL 10에서는 10이 됩니다. 이것이 바로 CentOS 저장소가 Rocky 시스템에서 올바르게 해결되는 이유입니다. 설치하기 전에 확장을 확인하십시오.
sudo dnf repoinfo docker-ce-stableRepo-baseurl 줄을 읽으십시오. 이 줄은 /9/x86_64/stable 또는 /10/x86_64/stable으로 끝나야 합니다. 릴리스 설정에서 $releasever을 9.6과 같은 포인트 버전으로 설정한 경우, 해당 줄에는 /9.6/가 표시되며 dnf는 메타데이터를 가져올 때 해당 URL에 대해 Status code: 404을 보고합니다. /etc/yum.repos.d/docker-ce.repo을 편집하여 $releasever를 메이저 버전 번호로 대체하여 수정하십시오. 404 오류가 발생한다고 해서 반드시 이 문제가 원인인 것은 아닙니다. Red Hat은 일관되지 않은 저장소 메타데이터와 잘못된 기본 URL을 포함하여 동일한 오류에 대한 다른 원인들을 나열하고 있으므로, Repo-baseurl에 실제로 포인트 릴리스가 표시될 때만 편집을 수행하십시오. 이미 메이저 버전 번호로 끝난다면 변수를 대체해도 아무런 변화가 없습니다.
엔진 및 compose 플러그인 설치
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin다섯 개의 패키지가 각각의 역할을 수행합니다. docker-ce는 데몬인 dockerd입니다. docker-ce-cli은 사용자가 입력하는 docker 명령어입니다. containerd.io은 데몬이 구동하는 컨테이너 런타임입니다. docker-buildx-plugin는 이미지를 빌드합니다. docker-compose-plugin은 하위 명령어로 docker compose을 제공합니다.
이 패키지들은 하이픈이 포함된 docker-compose 바이너리를 설치하지 않습니다. 이는 Compose v1이었으며, Docker는 Compose v2가 정식 출시된 이후 해당 버전에 대한 지원을 종료했습니다. 하이픈이 포함된 docker-compose을 호출하는 모든 항목은 공백이 포함된 docker compose로 업데이트해야 합니다.
최초 설치 시 Docker의 서명 키를 가져오며 지문(fingerprint)을 표시합니다. 키는 방금 추가한 저장소 파일의 gpgkey=https://download.docker.com/linux/centos/gpg에서 제공되므로, 수락하기 전에 dnf가 출력하는 지문과 해당 URL의 내용을 비교하십시오.
자주 발생하는 오류가 하나 있습니다. dnf가 containerd.io에 container-selinux이 필요하지만 이를 제공하는 패키지가 없다고 보고한다면, AppStream 저장소가 비활성화된 상태입니다. dnf repolist을 실행하여 appstream가 목록에 있는지 확인하십시오. EL 9 및 EL 10에서는 container-selinux이 해당 저장소를 통해 제공되기 때문입니다.
Docker 시작 및 실행 확인
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-worldDocker의 RPM 패키지는 설치 후 데몬을 중지된 상태로 비활성화해 둡니다. 이것이 바로 이 단계가 Docker의 Ubuntu 페이지에는 없고 CentOS 페이지에만 있는 이유입니다. Ubuntu의 deb 패키지는 서비스를 자동으로 시작하기 때문입니다. enable 단계를 건너뛰면 Docker는 다음 재부팅 전까지만 실행되며, 재부팅 후에는 서비스가 내려가 모든 컨테이너도 함께 중단됩니다.
systemctl status 명령은 Active: active (running)을 출력해야 합니다. hello-world 컨테이너는 This message shows that your installation appears to be working correctly.를 출력하고 종료되어야 합니다. 만약 /var/run/docker.sock에서 권한 오류가 발생한다면 sudo을 누락한 것이며, 이는 아래의 docker 그룹 섹션에서 해결할 수 있습니다.
compose 플러그인은 별도의 패키지이므로 엔진이 정상 작동하더라도 누락될 수 있으니 따로 확인하십시오.
docker compose version새로 설치한 환경에서 정상적인 결과는 Docker Compose version v5.7.0이며, 이는 2026년 11월 10일 기준으로 Docker의 EL 9 저장소에서 제공하는 버전입니다. v2에서 v5로 건너뛴 것에 당황하지 마십시오. Docker는 2025년에 Compose v5를 출시하면서 기존 Compose 파일 형식인 v2 및 v3와 혼동을 피하기 위해 중간 번호를 건너뛰었으며, 기능적으로는 v2와 동일합니다. Docker는 Compose v2와 Compose v5를 모두 지원하므로 v2.x.x를 출력하는 구형 서버도 여전히 정상 작동하는 것이며, dnf upgrade을 실행하면 v5로 업그레이드됩니다. 재부팅 후 서비스를 복구하는 것은 데몬 활성화와는 별개의 문제이며, 재시작 정책이 부팅 시 Compose 서비스의 재시작 여부를 결정합니다.
바인드 마운트에서 권한 거부(Permission Denied)가 발생하는 이유는 무엇입니까?
Rocky Linux와 AlmaLinux는 기본적으로 SELinux(Security-Enhanced Linux)를 enforcing 모드로 실행합니다. getenforce 명령으로 이를 확인하십시오. 이 명령은 Enforcing를 출력합니다.
호스트의 강제 정책이 Docker 컨테이너를 직접 제한하지는 않습니다. Docker의 SELinux 지원은 데몬 설정인 selinux-enabled에 의해 결정되는데, 기본값은 꺼져 있으며 docker-ce 패키지를 설치해도 자동으로 켜지지 않습니다. 이 기능이 꺼져 있으면 컨테이너는 제한되지 않은 유형인 spc_t로 시작합니다. 따라서 바인드 마운트는 레이블 없이도 작동하며, SELinux는 컨테이너와 호스트를 분리하지 않습니다. SELinux가 컨테이너를 제한하도록 하려면 /etc/docker/daemon.json 파일에서 해당 설정을 활성화하고 데몬을 재시작하십시오. 파일에 이미 설정이 있다면 파일을 덮어쓰지 말고 기존 객체에 키를 추가하십시오.
echo '{ "selinux-enabled": true }' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker레이블링이 켜지면 Docker 컨테이너는 SELinux 유형인 container_t로 실행됩니다. 이 정책은 해당 유형에 container_file_t으로 레이블이 지정된 파일과 nfs_t 같은 일부 파일 시스템 유형에 대한 전체 접근 권한을 부여하며, container_ro_file_t와 같은 다른 유형에는 읽기 권한을 부여합니다. 일반적인 호스트 디렉터리가 가진 범용 레이블에는 접근 권한을 부여하지 않습니다. 호스트에서 생성한 디렉터리는 상위 경로의 레이블을 상속받으므로, 호스트 측에서 소유자, 그룹, 모드가 올바르게 보여도 컨테이너에서는 접근이 거부됩니다. 다음 세 가지 명령으로 이를 재현할 수 있습니다.
sudo mkdir -p /srv/site
echo hello | sudo tee /srv/site/index.html
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro nginx:alpine cat /usr/share/nginx/html/index.html컨테이너는 다음을 출력합니다.
cat: can't open '/usr/share/nginx/html/index.html': Permission denied두 가지 명령으로 원인을 파악할 수 있습니다. ls -ldZ /srv/site은 레이블을 출력하는데, /srv 아래의 경로는 container_file_t이 아닌 system_u:object_r:var_t:s0로 표시됩니다. 그 다음 sudo ausearch -m avc -ts recent은 커널의 감사 기록을 출력하며, 여기에는 avc: denied { read }, container_t을 가리키는 scontext= 필드, 그리고 방금 디렉터리에서 확인한 레이블을 가리키는 tcontext= 필드가 포함되어 있습니다. 이 두 필드 사이의 불일치가 문제의 핵심입니다.
해결 방법은 볼륨 인수에 접미사를 추가하는 것입니다. 그러면 Docker가 경로의 레이블을 다시 지정합니다.
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html소문자 :z는 내용을 공유 가능하도록 레이블을 다시 지정하므로, 여러 컨테이너가 동일한 디렉터리를 사용할 수 있습니다. 대문자 :Z은 이를 비공개 및 비공유 상태로 레이블을 다시 지정하여 하나의 컨테이너에 종속시키며, 동일한 경로를 읽으려는 두 번째 컨테이너는 접근이 거부됩니다. 사이드카나 백업 컨테이너가 접근해야 하는 경우에는 :z를 사용하십시오. 단일 컨테이너가 소유하는 데이터베이스 디렉터리에는 :Z를 사용하십시오.
Docker 문서에는 반복할 가치가 있는 경고가 있습니다. 레이블 재지정은 재귀적으로 수행되기 때문입니다. /home이나 /usr 같은 시스템 디렉터리를 :Z로 바인드 마운트하면 "호스트 머신이 작동 불능 상태가 될 수 있으며, 호스트 머신 파일을 수동으로 다시 레이블링해야 할 수도 있습니다." 이러한 접미사는 컨테이너를 위해 직접 생성한 디렉터리에만 사용하고, 시스템 경로에는 절대 사용하지 마십시오.
Compose에서는 동일한 문자열에 접미사를 추가합니다.
services:
web:
image: nginx:alpine
volumes:
- /srv/site:/usr/share/nginx/html:ro,z두 가지 제한 사항을 주의해야 합니다. --mount 플래그는 SELinux 레이블을 설정할 수 없으므로, 레이블이 필요한 경우 -v을 사용하십시오. 명명된 볼륨(Named volumes)은 Docker가 /var/lib/docker/volumes 아래에 직접 생성한 디렉터리에 레이블을 지정하므로 접미사가 필요 없습니다.
SELinux를 끄지 마십시오. sudo setenforce 0는 1분 정도의 테스트 용도로만 사용하십시오. 컨테이너가 작동한다면 SELinux가 차단하고 있는 것이 맞지만, 반드시 바인드 마운트 레이블 때문은 아닐 수 있습니다. 거부 로그에서 tcontext= 필드를 읽어보십시오. 디렉터리의 레이블이 문제라면 :z가 해결책입니다. 장치를 가리키고 있다면, 컨테이너에 마운트된 X 서버 장치에 대한 sudo setsebool -P container_use_xserver_devices 1와 같은 정책 불리언(boolean) 설정이 해결책인 경우가 많습니다. 테스트 후에는 즉시 sudo setenforce 1으로 enforcing 모드를 복구하십시오. Enterprise Linux에서 바인드 마운트의 permission denied은 컨테이너 내부에서 동일하게 보이지만 두 가지 다른 원인이 있습니다. 하나는 SELinux 레이블이고, 다른 하나는 일반적인 숫자 형태의 사용자 및 그룹 소유권입니다. 이는 PUID 및 PGID 변수가 존재하는 이유입니다. ls -lnZ을 사용하면 모드, 숫자 소유자, 레이블을 한 줄로 확인할 수 있으므로 어떤 문제를 해결해야 하는지 알 수 있습니다.
firewalld가 닫혀 있는데도 게시된 포트에 접근할 수 있는 이유는 무엇입니까?
firewalld는 Rocky Linux와 AlmaLinux의 기본 방화벽입니다. sudo systemctl is-active firewalld 명령으로 방화벽이 실행 중인지 확인하십시오. 이 서버에서 아직 설정을 완료하지 않았다면 firewalld로 SSH 및 웹 포트 열기를 먼저 수행해야 합니다. 아래에서 설명할 현상은 비교할 수 있는 정상적인 영역(zone) 규칙 세트가 있을 때만 이해할 수 있기 때문입니다. 이제 포트를 게시하고 firewalld가 무엇을 열려 있다고 판단하는지 확인해 보십시오.
sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-portsfirewall-cmd 명령은 빈 줄을 출력합니다. 다른 머신에서 curl -I http://YOUR_SERVER_IP:8080/ 명령을 실행하면 HTTP/1.1 200 OK가 반환됩니다. 포트는 인터넷에 열려 있지만 방화벽은 아무것도 보고하지 않습니다.
이 현상의 원인은 패킷이 이동하는 경로에 있습니다. firewalld의 영역 규칙은 호스트 자체를 대상으로 하는 트래픽만 필터링합니다. 게시된 포트는 호스트를 대상으로 하지 않습니다. Docker는 패킷이 호스트의 입력 경로에 도달하기 전에 대상 주소를 컨테이너 주소로 다시 쓰는 목적지 NAT(네트워크 주소 변환) 규칙을 설치합니다. 따라서 커널은 패킷을 로컬로 전달하는 대신 포워딩합니다. 그 후 Docker는 브리지 인터페이스를 docker이라는 firewalld 영역에 배치하는데, 이 영역의 대상(target)은 ACCEPT입니다. 또한 모든 영역에서 docker 영역으로의 포워딩을 허용하는 docker-forwarding라는 포워딩 정책을 추가합니다. 결과적으로 사용자의 영역 규칙은 패킷을 전혀 보지 못하게 됩니다.
가장 깔끔한 해결책은 방화벽 규칙을 사용하지 않는 것입니다. 게시할 호스트 측 포트를 루프백(loopback)에 바인딩하고 그 앞에 리버스 프록시를 배치하십시오.
sudo docker rm -f web
sudo docker run -d --name web -p 127.0.0.1:8080:80 nginx:alpine
curl -I http://127.0.0.1:8080/로컬에서 curl 명령을 실행하면 HTTP/1.1 200 OK이 반환되지만, 다른 머신에서 동일한 요청을 보내면 더 이상 연결되지 않습니다. Docker의 기본 설정에서 호스트 주소 없이 -p 인수를 사용하면 모든 인터페이스에 포트가 게시됩니다. 예외적으로 /etc/docker/daemon.json 파일의 "ip": "127.0.0.1" 설정 등을 통해 기본 바인딩 주소를 변경한 데몬의 경우는 다릅니다. 이 서버에서 그러한 설정이 변경되었다는 사실을 확실히 알지 못한다면, 단순히 -p 8080:80를 사용하는 것은 해당 서비스를 공개적으로 노출하겠다는 결정으로 간주해야 합니다.
특정 주소에서만 서비스에 접근할 수 있도록 제한해야 할 경우, Docker가 제공하는 전용 체인(chain)을 사용하십시오. DOCKER-USER은 Docker 자체의 허용 규칙보다 먼저 처리되므로, 여기에 규칙을 추가하면 Docker가 재시작되어 체인을 다시 작성하더라도 규칙이 유지됩니다.
sudo iptables -I DOCKER-USER -i enp1s0 ! -s 203.0.113.10 -j DROP
sudo iptables -S DOCKER-USER현재 EL 이미지들은 enp1s0이나 ens3과 같은 이름을 사용하므로, eth0라고 가정하지 말고 ip route show default 명령으로 인터페이스 이름을 확인하십시오. Rocky 및 AlmaLinux에서 iptables 명령은 nftables 위의 호환성 계층이며, Docker의 체인은 이를 통해 확인할 수 있습니다. 이렇게 추가된 규칙은 재부팅 후 사라지므로, 설정이 완료되면 systemd 유닛에 작성하여 저장하십시오.
2025년에 출시된 Docker Engine 28.0에서는 인접한 보안 취약점이 수정되었습니다. 게시되지 않은 컨테이너 포트에 대한 직접적인 라우팅 접근이 이제 DOCKER 체인에서 차단됩니다. 이 변경 사항은 게시된 포트에는 영향을 미치지 않으므로, 위에서 설명한 내용은 현재 버전에서도 동일하게 적용됩니다. 한 가지 운영 습관을 들이는 것이 좋습니다. sudo firewall-cmd --reload을 실행한 후에는 항상 게시된 포트를 다시 테스트하십시오. 응답이 멈췄다면 sudo systemctl restart docker 명령으로 Docker의 규칙을 다시 설치할 수 있습니다.
Ubuntu 관리자들도 다른 도구를 통해 동일한 문제에 직면하게 되며, 이는 게시된 Docker 포트가 ufw 규칙을 무시하는 이유에서 확인할 수 있습니다. 두 경우 모두 NAT 경로가 원인이며, 앞단에 있는 방화벽의 종류만 다를 뿐입니다.
docker 그룹에 root가 아닌 사용자 추가하기
모든 docker 명령 앞에 sudo을 입력하는 것은 번거로운 일이며, docker 그룹을 사용하면 이를 해결할 수 있습니다.
sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-worldusermod -aG는 /etc/group을 수정하지만, 현재 셸은 이미 그룹 목록을 가지고 있으므로 새로운 셸을 실행하기 전까지는 변경 사항이 적용되지 않습니다. newgrp docker를 실행하면 그룹 권한이 적용된 셸이 시작되므로 즉시 테스트할 수 있습니다. 새로운 SSH 세션은 자동으로 변경 사항을 반영합니다.
이 그룹이 부여하는 권한을 명확히 이해해야 합니다. 그룹 멤버십은 /var/run/docker.sock에 대한 쓰기 권한을 부여하며, 해당 소켓과 통신할 수 있는 모든 것은 데몬에 호스트 파일 시스템을 마운트하는 컨테이너를 시작하도록 요청할 수 있습니다. 다음 명령 하나로 그 의미를 확인할 수 있습니다.
docker run --rm -v /:/host alpine wc -l /host/etc/shadow이 명령은 sudo 권한이 없는 계정으로 root만 읽을 수 있는 파일을 읽어옵니다. Docker의 공식 설치 후 문서에서도 명시하듯, docker 그룹은 root와 동일한 권한을 부여합니다. 해당 계정에 sudo을 부여할 의사가 있는 경우에만 계정을 그룹에 추가하십시오. 새로운 서버에 계정을 설정하는 중이라면, 나중에 처리하기보다 VPS에서의 최소 권한 사용자 설정 과정에서 함께 결정하십시오.
Docker는 데몬을 권한이 없는 사용자로 실행하는 rootless 모드도 제공합니다. 이는 별도의 설치 경로를 따르며 스토리지 드라이버와 1024번 미만 포트의 동작 방식이 변경되므로, 나중에 추가하는 옵션이 아닌 별도의 프로젝트로 계획해야 합니다.
다음 단계
이제 엔진, compose 플러그인, 재부팅 후에도 유지되는 서비스, 그리고 위에서 설명한 3가지 EL 전용 동작을 모두 갖추었습니다. 다음 단계는 서비스별 compose.yaml이며, Compose 파일의 구조에서 파일 형식과 이를 구동하는 명령어를 다룹니다. 이번이 첫 번째 컨테이너 호스트라면, VPS에서 Docker 실행하기를 통해 이 가이드에서 다루지 않은 크기 산정, 스토리지, 이미지 관리 문제를 확인하십시오.
FAQ
Docker의 CentOS 저장소가 Rocky Linux와 AlmaLinux에서 작동합니까?
네, 작동합니다. https://download.docker.com/linux/centos/docker-ce.repo을 dnf config-manager로 추가하십시오. 해당 파일의 baseurl에는 $releasever가 포함되어 있으며, Rocky Linux와 AlmaLinux는 이를 메이저 버전 번호로 확장합니다. 따라서 EL 9 시스템은 CentOS 9 트리로, EL 10 시스템은 CentOS 10 트리로 연결됩니다. sudo dnf repoinfo docker-ce-stable로 확장을 확인하고 Repo-baseurl 라인을 읽어 보십시오. 만약 해당 라인에 9.6과 같은 포인트 릴리스가 표시되고 dnf가 메타데이터를 가져올 때 Status code: 404 오류를 보고한다면, /etc/yum.repos.d/docker-ce.repo를 편집하여 메이저 버전 번호만 사용하도록 수정하면 해결됩니다. 이미 해당 라인에 메이저 번호가 표시되어 있는데도 404 오류가 발생한다면, 저장소 메타데이터 불일치나 잘못된 base URL 등 다른 원인이 있는 것이므로 변수를 수정해도 해결되지 않습니다.
Docker와 podman을 같은 서버에 설치할 수 있습니까?
Docker 문서에서는 podman과 runc을 충돌하는 패키지로 분류하며, Docker Engine을 설치하기 전에 두 패키지 모두 제거할 것을 권장합니다. 실질적인 충돌은 podman-docker 패키지에서 발생하는데, 이 패키지는 /usr/bin/docker을 소유하며 모든 docker 명령을 podman 명령으로 가로챕니다. rpm -qf "$(command -v docker)"를 실행하여 해당 경로를 소유한 패키지를 확인해 보십시오. 출력 결과가 podman-docker으로 시작한다면 podman이 응답하고 있는 것입니다. 두 엔진을 모두 유지하는 것은 Docker가 지원하는 구성이 아니므로, 중요한 서버라면 하나만 선택하십시오.
바인드 마운트에서 컨테이너가 permission denied 오류를 내는 이유는 무엇입니까?
Rocky Linux와 AlmaLinux에서는 SELinux가 기본적으로 강제(enforcing) 모드로 동작하며, Docker의 selinux-enabled 설정이 켜지면(기본값은 꺼짐) 컨테이너는 container_t 유형으로 실행됩니다. 이 유형은 일반 호스트 디렉터리가 가진 기본 레이블에 접근할 권한이 없으므로, 소유자나 권한 모드와 관계없이 접근이 거부됩니다. 호스트 경로에서 ls -ldZ를 실행하고, 일치하지 않는 두 컨텍스트를 출력하는 sudo ausearch -m avc -ts recent(avc: denied 출력)을 통해 이를 확인하십시오. 컨테이너 간 공유되는 콘텐츠에는 볼륨 인수에 :z를 추가하고, 단일 컨테이너 전용 콘텐츠에는 :Z을 추가하십시오. :Z를 /home나 /usr으로 지정하지 마십시오. 레이블 재지정(relabel)이 재귀적으로 수행되어 호스트 시스템이 손상될 수 있습니다.
컨테이너 포트를 공개하려면 firewalld에서 포트를 열어야 합니까?
아니요, 오히려 그것이 문제입니다. Docker의 NAT 규칙은 패킷이 호스트의 입력 경로에 도달하기 전에 목적지 주소를 다시 쓰기 때문에, firewalld의 영역 규칙은 이를 검사하지 못합니다. 또한 Docker는 브리지를 docker이라는 firewalld 영역에 배치하고 대상을 ACCEPT로 설정합니다. -p 8080:80로 시작된 컨테이너는 sudo firewall-cmd --list-ports이 아무것도 출력하지 않는 상태에서도 인터넷에서 접근 가능합니다. 호스트에서만 서비스에 접근해야 한다면 -p 127.0.0.1:8080:80을 사용하여 특정 주소로만 공개하거나, Docker가 자체 허용 규칙을 처리하기 전에 실행되는 DOCKER-USER 체인에 필터링 규칙을 삽입하십시오.
사용자를 docker 그룹에 추가하는 것은 안전합니까?
그것은 root 권한을 부여하는 것과 같습니다. docker 그룹의 구성원은 /var/run/docker.sock에 쓸 수 있으며, docker run --rm -v /:/host alpine wc -l /host/etc/shadow는 sudo 권한이 없는 계정으로도 root 전용 파일을 읽을 수 있게 합니다. Docker의 설치 후 문서에서도 동일한 위험성을 명시하고 있습니다. 이미 sudo를 맡길 수 있을 만큼 신뢰하는 계정만 추가하고, 공유 계정이나 서비스 계정은 sudo docker을 계속 사용하십시오. 권한이 없는 사용자로 컨테이너를 실행해야 할 때는 설정 변경이 아닌 별도의 설치 경로를 사용하는 Rootless 모드가 대안입니다.