Docker 관리 · 3 min read · Sep 22, 2025

우분투에서 Portainer를 사용하여 Docker 컨테이너 관리하는 방법

Portainer는 Docker 및 Docker Swarm 환경을 위한 오픈 소스 관리 UI입니다. Portainer는 웹 기반 Portainer 대시보드에서 컨테이너, 이미지, 네트워크 및 볼륨을 관리할 수 있도록 하여 Docker 컨테이너를 더 쉽게 관리할 수 있게 해줍니다.

이 튜토리얼에서는 우분투 16.04 LTS에 Portainer를 설치하고 구성하는 방법을 단계별로 보여드리겠습니다. Portainer를 설치하고 구성한 후, 앱 컨테이너를 배포하고 Docker 환경을 위한 컨테이너, 이미지, 네트워크 및 볼륨을 관리할 것입니다.

전제 조건

  • 우분투 서버 16.04
  • 루트 권한

우리가 할 일

  1. 우분투 16.04에 Docker 설치
  2. Portainer 설치 및 구성
  3. Ghost 블로그 앱 컨테이너 배포
  4. Docker 환경 관리

1단계 - 우분투 16.04 LTS에 Docker 설치

Docker 패키지를 설치하기 전에 시스템의 저장소를 업데이트하고 패키지를 업그레이드하십시오.

sudo apt update  
sudo apt upgrade

이제 아래의 apt 명령을 사용하여 Docker를 설치합니다.

sudo apt install docker.io -y

설치가 완료되면 Docker 서비스를 시작하고 시스템 부팅 시마다 시작되도록 활성화합니다.

systemctl start docker  
systemctl enable docker

우분투 16.04 서버에 설치된 Docker를 아래 명령어를 사용하여 확인합니다.

docker version

그리고 시스템에 설치된 Docker 버전 1.x를 확인할 수 있습니다.

우분투에 Docker 설치

2단계 - Portainer 설치 및 구성

Portainer는 Docker 컨테이너로 설치할 수 있으며, Docker 컨테이너 없이 독립적으로 설치할 수 있습니다.

이 튜토리얼에서는 Portainer를 Docker 컨테이너로 설치할 것입니다. 시스템이 Docker를 지원하기만 하면 설치하고 실행하는 것이 매우 간단합니다.

Portainer를 설치하기 전에 아래의 docker pull 명령을 사용하여 DockerHub에서 Portainer 이미지를 다운로드합니다.

docker pull portainer/portainer

Portainer 설치

이제 아래의 간단한 Docker 명령을 사용하여 Portainer를 실행합니다.

docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer

Portainer가 이제 컨테이너로 실행되고 있으며, docker ps 명령어를 사용하여 확인합니다.

docker ps

그리고 아래와 같은 결과를 얻을 수 있습니다.

Portainer는 이제 이름이 ‘elatted_hopper’인 Docker 컨테이너로 실행되고 있으며, 포트 9000에서 실행되고 있습니다.

다음으로 Portainer의 관리자 비밀번호를 구성하겠습니다.

웹 브라우저를 열고 포트 9000과 함께 서버 IP 주소를 입력합니다.

http://192.168.33.10:9000/

관리자 사용자 및 비밀번호 구성에 대한 페이지가 표시됩니다.

Portainer UI

강력한 관리자 비밀번호를 입력하고 ‘사용자 생성’ 버튼을 클릭합니다.

이제 Portainer가 연결할 환경을 정의해야 합니다. Portainer는 독립형 Docker 환경, Docker Swarm 및 Swarm 모드를 지원합니다.

이 가이드에서는 Portainer를 로컬 Docker 환경에 연결하도록 구성합니다.

Portainer를 Docker에 연결

‘로컬’ 환경을 선택하고 ‘연결’ 버튼을 클릭합니다.

이제 Portainer 관리자 대시보드를 볼 수 있습니다.

Portainer 관리자 대시보드

Portainer가 우분투 16.04에 Docker 컨테이너로 설치되었습니다.

3단계 - 새로운 앱 컨테이너 배포

Portainer 설치 후, Portainer를 사용하여 애플리케이션 컨테이너를 실행합니다.

‘앱 템플릿’ 메뉴를 클릭합니다.

이제 설치할 애플리케이션을 선택합니다. 이 가이드에서는 ‘Ghost’ 블로그를 Docker 컨테이너로 설치할 것입니다.

앱 컨테이너 배포

‘Ghost’를 클릭합니다.

컨테이너 이름 ‘ghost-blog’를 입력하고 ‘고급 옵션 표시‘를 클릭합니다. ‘포트 매핑’ 구성에서 ‘호스트’에 포트 80을 입력합니다.

Ghost 블로그용 컨테이너 생성

이제 ‘컨테이너 배포’ 버튼을 클릭합니다.

완료되면 아래와 같은 컨테이너 페이지를 얻을 수 있습니다.

컨테이너 세부정보

Ghost가 이제 Docker 컨테이너로 설치되었으며, 호스트의 포트 80을 사용하고 있습니다.

웹 브라우저를 열고 서버 IP 주소를 입력합니다.

http://192.168.33.10/

그리고 아래와 같은 ‘Ghost’ 블로그 홈페이지를 확인할 수 있습니다.

컨테이너가 성공적으로 배포됨

4단계 - Portainer를 사용하여 Docker 환경 관리

이 단계에서는 Docker 이미지, 컨테이너, 볼륨 및 네트워크와 같은 Docker 환경을 구성합니다.

컨테이너 관리

Portainer는 Docker 컨테이너 관리를 위한 간단하고 쉬운 방법을 제공합니다.

왼쪽의 ‘컨테이너’ 메뉴를 클릭하면 아래와 같은 페이지를 얻을 수 있습니다.

Portainer로 컨테이너 관리

여기에서 컨테이너를 시작, 중지, 재시작하고, 새 컨테이너를 생성하고, 컨테이너의 셸에 접근하고, 컨테이너 로그 및 통계를 볼 수 있습니다.

Ghost 컨테이너의 셸:

컨테이너의 셸 접근

Ghost 컨테이너 로그:

컨테이너의 로그 파일

컨테이너 통계:

Docker 컨테이너의 통계

Docker 이미지 관리

‘이미지‘ 메뉴를 클릭하면 아래와 같은 페이지를 얻을 수 있습니다.

Docker 이미지 관리

이제 시스템의 Docker 이미지 목록을 볼 수 있으며, 수동으로 새 Docker 이미지를 생성하거나 DockerHub 저장소에서 새 이미지를 가져올 수 있습니다.

네트워크 관리

이 메뉴에서 Docker 환경을 위한 새로운 사용자 정의 네트워크를 생성합니다. ‘네트워크’ 메뉴를 클릭합니다.

Docker 컨테이너를 위한 네트워크 설정 관리

볼륨 관리

이 메뉴는 컨테이너를 위한 새로운 사용자 정의 볼륨을 생성하는 쉬운 방법을 제공합니다.

새로운 사용자 정의 볼륨을 생성하기만 하면 되며, 새로운 컨테이너를 생성할 때 애플리케이션을 ‘고급 옵션’ 메뉴를 통해 컨테이너에 연결하면 됩니다.

Docker 볼륨 관리

우분투 16.04에서 Portainer Docker 관리 UI의 설치 및 구성이 성공적으로 완료되었습니다.

참고

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.