문서
빠른 시작 + 부분별, 기기별 기능 설명 (계속 업데이트 중)
앱 모음
이 문서는 패널의 「앱 모음」 — 자주 쓰는 앱을 원클릭으로 배포하는 완전 가이드를 소개합니다.
한 문장으로 이해
앱 모음은 내장된 「앱 스토어」로, 수많은 오픈소스 앱(블로그, 클라우드 저장소, 노트, 모니터링, 데이터베이스 등)을 수록하고 있습니다. 한 번 클릭하면 대상 서버에서 Docker 배포가 자동으로 끝나며, docker-compose를 직접 작성하거나 튜토리얼을 찾아볼 필요가 없습니다.
기능 소개
앱 모음에는 자주 쓰는 오픈소스 앱이 수록되어 있고, 각 앱마다 「기본 계정과 비밀번호 + 포트 + 데이터 디렉터리 + 배포 단계 + 주의 사항」이 준비되어 있습니다. 「설치」를 누르고 서버를 고르고 몇 가지 핵심 파라미터만 채우면, 나머지(이미지 받기, 데이터베이스 생성, 환경 변수 설정, 컨테이너 시작)는 전부 자동으로 처리됩니다.
활용 시나리오
- 앱을 빠르게 배포하고 싶을 때 (예: Nextcloud 클라우드 저장소, WordPress 블로그, Memos 노트)
- 환경 변수, 포트 매핑, 데이터 영속화를 직접 연구하고 싶지 않을 때
- 각 앱마다 「기본 계정과 비밀번호 + 배포 단계 + 주의 사항」이 준비되어 있기를 바랄 때
사용 방법
1. 「앱 모음」에 들어가 앱을 둘러보거나 검색합니다
2. 「전체」 또는 「설치됨」으로 전환해 확인합니다
3. 앱을 클릭해 상세 정보(기본 계정과 비밀번호, 포트, 데이터 디렉터리, 주의 사항)를 확인합니다
4. 「설치」를 클릭하고 대상 서버를 선택한 뒤 안내에 따라 설정(비밀번호, 포트 등)을 입력합니다
콘텐츠 관리 시스템(CMS) 원클릭 설치
앱 모음에는 「콘텐츠 관리 시스템 (CMS 원클릭 설치)」 분류가 내장되어 있으며, WordPress, Joomla, Drupal, MediaWiki, Halo, Ghost 등 주요 CMS를 포함합니다. 모두 원클릭 설치 + 데이터베이스 자동 구성을 지원하며, 전 과정에서 SQL을 직접 작성할 필요가 없습니다:
1. Docker 자동 확인/설치
2. 공유 MariaDB 데이터베이스 컨테이너 자동 시작 (sshe-mysql, 한 번만 필요하고 이후 CMS가 재사용)
3. 각 사이트마다 개별 데이터베이스와 사용자 자동 생성 (무작위 강력 비밀번호, root 비밀번호는 서버의 /opt/sshe-mysql/.root_password에 저장되어 재사용 가능)
4. CMS 컨테이너를 자동 시작하고 데이터베이스 설정을 주입
5. 설치가 끝나면 접속 주소 + 데이터베이스 자격 증명을 팝업으로 표시하며 원클릭 복사 가능
세 가지 형태:
- 완전 자동 (WordPress / Joomla): 공식 이미지가 데이터베이스 환경 변수를 지원해 설치 후 바로 사용할 수 있습니다
- 웹 마법사 (Drupal / MediaWiki): 도구가 자동으로 DB와 사용자를 만들고, 여러분은 웹 설치 마법사에서 자동 생성된 자격 증명을 입력하면 됩니다 (SQL을 칠 필요 없음)
- 내장 데이터베이스 (Halo / Ghost): 외부 데이터베이스가 필요 없고 원클릭으로 바로 실행됩니다
> 팁: 중국 본토 서버에서 Docker Hub 이미지 받기가 타임아웃되면, 서버에 Docker 이미지 가속기를 먼저 설정하세요 (공용 가속기 예: docker.1ms.run / docker.m.daocloud.io).
특정 사이트의 데이터베이스 자격 증명 조회 / 백업
원클릭 설치 후 각 사이트의 데이터베이스 자격 증명은 대상 서버에 자동 저장됩니다: /opt/sshe-db-creds/<컨테이너명>.conf (DB_HOST / DB_NAME / DB_USER / DB_PASS / DB_ROOT 포함, 권한 600).
앱 모음 또는 이미지 모음의 CMS 상세에서 「데이터베이스 자격 증명 보기」를 누르면 언제든 확인할 수 있고, 팝업에 다음이 자동으로 함께 표시됩니다:
- 🚀 phpMyAdmin 원클릭 배포: 한 번 누르면
sshe-cms-net네트워크에 phpMyAdmin을 자동 배포하고 (빈 포트를 자동 선택, 기본 8888,sshe-mysql지정), 「phpMyAdmin 열기(로그인 자동 입력됨)」 버튼을 제공해 바로 데이터베이스에 들어가 초보자도 쉽게 시각적으로 조회 / 가져오기·내보내기 / 쿼리를 할 수 있습니다. - 백업 명령:
docker exec sshe-mysql mariadb-dump -uroot -p'<DB_ROOT>' <DB_NAME> > /opt/sshe-db-creds/<DB_NAME>.bak.sql - phpMyAdmin 대체 로그인: 서버에는
sshe-mysql, 사용자/비밀번호는 위의 데이터베이스 사용자/비밀번호를 사용합니다.
> 설명: 이 자격 증명 파일은 CMS를 「원클릭 설치」로 배포할 때만 생성됩니다. docker run으로 수동 배포했다면 앱 설정(예: WordPress의 wp-config.php)을 직접 확인하세요.
각 앱의 상세 정보에 포함되는 내용
| 정보 | 설명 |
|---|---|
| 기본 계정 / 비밀번호 | 앱 초기 계정 (예: Nextcloud의 admin) |
| 기본 포트 | 앱 리스닝 포트 |
| 데이터 디렉터리 | 데이터 영속화 위치 |
| 배포 단계 | 데이터베이스 의존형 앱의 전체 단계 (DB 먼저 설치 → DB와 사용자 생성 → 환경 변수 설정 → 초기화) |
| 주의 사항 | 포트 충돌, 리소스 사용, 보안 주의 등 |
설치된 앱 관리
「설치됨」으로 전환하면 설치된 앱마다 인라인 작업을 제공합니다: 설치 / 제거 / 중지 / 시작 / 재시작 / 삭제 — 일상 운영에 편리합니다.
데이터베이스 의존형 앱
일부 앱(예: Nextcloud, WordPress)은 MySQL/PostgreSQL에 의존합니다. 이런 앱의 배포 단계에는 자동으로 다음이 포함됩니다:
1. 데이터베이스 먼저 배포 (MySQL/MariaDB/PostgreSQL)
2. 데이터베이스와 사용자 생성
3. 앱의 환경 변수 설정 (데이터베이스 주소, 계정, 비밀번호)
4. 앱 초기화
패널이 이 단계들을 이어 주므로, 여러분은 안내에 따라 비밀번호 등 핵심 정보만 입력하면 됩니다.
다양한 배포판 지원
앱 모음의 설치 명령은 대상 서버의 패키지 관리자를 자동으로 맞춰 주므로 직접 선택할 필요가 없습니다:
| 배포판 | 패키지 관리자 | 대응 방식 |
|---|---|---|
| Debian / Ubuntu | apt | 기본 명령 |
| Fedora / Rocky / CentOS / RHEL | dnf / yum | 자동 매핑 (apt-get → dnf/yum) |
| Alpine | apk | 자동 매핑 |
동시에 흔한 패키지 이름 차이(예: apache2 → httpd, apache2-utils → httpd-tools)와 서비스 이름 차이(apache2.service → httpd.service)도 자동으로 처리합니다.
> ⚠️ 주의: 일부 앱은 배포판별 설치 방식에 의존합니다(예: ufw는 Ubuntu 전용, Node.js의 deb.nodesource 저장소는 Debian/Ubuntu 전용). Fedora/Rocky에서는 설치되지 않을 수 있습니다. 설치가 실패하면 패널은 오류 메시지를 있는 그대로 표시합니다.
주의 사항
1. 앱을 배포하려면 대상 서버에 Docker가 설치되어 있어야 합니다.
2. 비밀번호 플레이스홀더는 명확히 표시됩니다(예: 「<데이터베이스 비밀번호>」). 자신의 강력한 비밀번호로 교체하세요.
3. 앱은 기본적으로 대상 서버의 포트에 바인딩됩니다. 그 서버에 공인 IP가 없다면(NAT/터널링 서버) 포트 터널링 또는 포트 포워딩과 함께 사용해야 외부에서 접속할 수 있습니다.
4. 너무 오래된 배포판(Fedora 32 등 이미 EOL된 버전)은 소프트웨어 저장소가 유지보수를 중단해 설치가 타임아웃되거나 실패할 수 있습니다. 지원되는 버전으로 업그레이드하는 것을 권장합니다.