문서
빠른 시작 + 부분별, 기기별 기능 설명 (계속 업데이트 중)
Docker 관리
이 문서는 패널로 대상 서버의 Docker 컨테이너, 이미지, 네트워크를 관리하는 방법을 소개합니다.
먼저 알아두기: Docker란
Docker는 「소프트웨어를 패키징해 실행하는」 기술입니다. 애플리케이션과 그것이 필요로 하는 환경(시스템 라이브러리, 의존성 등)을 하나의 「컨테이너」로 묶어, Docker가 설치된 어떤 서버에서든 환경을 수동으로 구성하지 않고 원클릭으로 실행할 수 있게 합니다.
- 이미지: 소프트웨어의 「설치 패키지 템플릿」 (예:
nginx:latest) - 컨테이너: 이미지가 「실행된」 인스턴스 (돌아가고 있는 소프트웨어)
- 네트워크: 컨테이너끼리, 컨테이너와 호스트 사이의 통신 방식
패널은 SSH로 대상 서버의 Docker를 원격 호출해 컨테이너/이미지/네트워크를 GUI로 관리하는 인터페이스를 제공하므로, docker 명령을 외울 필요가 없습니다.
사전 조건
대상 서버에 Docker가 설치되어 있어야 합니다. 설치되어 있지 않으면 Docker 패널 상단에 「⚡ Docker 설치」 버튼이 있습니다: 원클릭 설치(공식 소스에 연결되지 않으면 자동으로 국내 미러로 폴백하며, Debian/Ubuntu/CentOS/Rocky/AlmaLinux 등 주요 배포판 지원), 설치 진행 상황은 오른쪽 위 「백그라운드 작업」 패널에 실시간 표시되고 중간에 종료할 수도 있으며, 완료되면 Docker 패널이 자동으로 새로고침됩니다.
활용 시나리오
- 다양한 Docker 앱 배포 및 관리
- 컨테이너 실행 상태, 로그 확인
- 컨테이너 시작/중지, 쓸모없는 이미지 정리
주요 기능
컨테이너 관리
| 작업 | 설명 |
|---|---|
| 조회 | 모든 컨테이너 나열 (이름, 이미지, 상태, 포트, 자원 사용) |
| 시작 / 중지 / 재시작 | 컨테이너 실행 상태 제어 |
| 로그 | 컨테이너 실시간 로그 조회 |
| 삭제 | 컨테이너 삭제 (데이터 볼륨을 함께 삭제할지 선택 가능) |
| 터미널 열기 | 컨테이너 안에 들어가 명령 실행 |
| 마운트 디렉터리 열기 | 컨테이너의 호스트 디렉터리(bind 마운트)마다 버튼 하나, 클릭하면 파일 관리자로 바로 이동해 업로드/다운로드/편집 |
| 데이터베이스 보기 | 데이터베이스 자격 증명 표시 + phpMyAdmin 원클릭 배포로 시각적 조회 (원클릭 설치한 사이트만) |
마운트 디렉터리 원클릭 이동
컨테이너 목록의 작업 열에는 각 bind 마운트(호스트 디렉터리 → 컨테이너 디렉터리)마다 📁 디렉터리 버튼이 표시됩니다(디렉터리 이름 표시, 마우스를 올리면 전체 경로). 클릭하면 자동으로 「파일」 탭으로 전환해 그 디렉터리를 바로 열고, 컨테이너 안의 사이트 파일을 업로드, 다운로드, 편집, 삭제할 수 있습니다.
- bind 마운트(호스트의 실제 디렉터리)만 표시하며, 익명 볼륨 / named volume은 표시하지 않습니다 (Docker 내부에서 관리하므로 파일 작업이 필요 없음).
- 마운트 디렉터리가 여러 개인 컨테이너는 그 수만큼 디렉터리 버튼이 표시됩니다.
- 예를 들어 WordPress의
/opt/sshe-wordpress, MySQL의/opt/sshe-mysql/data에 각각 버튼 하나씩 생깁니다.
데이터베이스 내용 조회
컨테이너 목록 작업 열의 🗄 버튼(「데이터베이스 내용 보기」)은 해당 사이트를 원클릭 설치할 때 생성된 자격 증명 파일을 읽어 데이터베이스 호스트/이름/사용자/비밀번호를 팝업으로 보여 주고, phpMyAdmin 원클릭 배포를 지원합니다(빈 포트 자동 선택, 같은 Docker 네트워크에 합류, 로그인 정보 미리 채움). 클릭하면 테이블 조회, 쿼리, 데이터 가져오기·내보내기를 시각적으로 할 수 있습니다. 원클릭 설치가 아닌 컨테이너를 클릭하면 자격 증명이 없다고 안내합니다.
이미지 관리
| 작업 | 설명 |
|---|---|
| 조회 | 로컬 이미지 나열 (저장소, 태그, 크기) |
| 받기 | 저장소에서 이미지 다운로드 |
| 삭제 | 쓸모없는 이미지 삭제 |
네트워크 관리
Docker 네트워크(bridge, host 등)를 조회하고 관리합니다.
앱 모음 / 이미지 모음과의 관계
- 앱 모음: 바로 쓸 수 있는 앱을 원클릭 배포 (docker-compose 자동 작성, 포트 구성, 환경 변수 구성)
- 이미지 모음: 자주 쓰는 Docker 이미지를 둘러보고 원클릭으로 받기/실행
- Docker 관리: 이미 배포된 컨테이너/이미지의 일상 운영
셋이 함께 동작합니다: 앱 모음/이미지 모음은 「설치」를, Docker 관리는 「일상 관리」를 담당합니다.
주의 사항
1. Docker 작업은 SSH 로그인 사용자 권한으로 실행되며, 보통 root 또는 docker 그룹에 속한 사용자가 필요합니다.
2. 컨테이너를 삭제하기 전에 데이터 볼륨을 남길지 확인하세요 (볼륨을 삭제하면 데이터는 복구할 수 없습니다).
3. 패널은 SSH로 docker 명령을 원격 실행하며, 대상 서버에 별도 Agent를 설치하지 않습니다. 흔적 없음.
4. 배포판 간 설치: 패널 백그라운드가 대상 서버의 패키지 관리자를 자동으로 인식해, 앱 모음의 apt-get 명령을 해당하는 dnf/yum(RHEL 계열) 또는 apk(Alpine)로 자동 변환합니다. 그래서 Rocky/CentOS/AlmaLinux에서 「Nginx 설치」 등을 눌러도 명령을 직접 고치지 않고 바로 성공합니다.