thruthesky Dokploy 서버 관리 스킬
Dokploy는 셀프호스팅 PaaS 도구로, Docker 기반 애플리케이션 배포를 간편하게 관리합니다.
필수 파라미터
아래 4가지 정보 없이는 어떤 작업도 시작하지 마세요. 사용자가 Dokploy 관련 작업을 요청하면, 첫 번째 응답에서 아래 정보를 확인하세요.
| # | 항목 | 예시 |
|---|---|---|
| 1 | Dokploy 서버 URL | http://1.2.3.4:3000 |
| 2 | 프로덕션 사이트 URL | https://example.com |
| 3 | Root SSH 접속 정보 | root@1.2.3.4 |
| 4 | 애플리케이션 ID | DYmNZmKYtRG0RdNrsGcfn |
- SSH는 반드시 키 인증 방식이어야 합니다 (비밀번호 인증 미지원).
- 정보가 누락된 경우, 작업을 진행하지 말고 사용자에게 요청하세요.
참조 문서
작업 유형에 따라 해당 references 문서를 읽고 진행합니다:
| 작업 | 문서 |
|---|---|
| API를 통한 원격 관리 | center-api.md |
| 애플리케이션 관리/설정 | applications.md |
| 빌드 타입 선택 | build-types.md |
| Cloudflare 도메인/SSL | cloudflare.md |
| traefik.me 무료 도메인 | traefik-me-domain.md |
| 볼륨 백업/복원 | volume-backups.md |
| 데이터베이스 관리 | database.md |
| Docker Compose 관리 | docker-compose.md |
| 와일드카드 서브도메인 라우팅 | wildcard-subdomain-routing.md |
| pgAdmin4 설치/설정 | pgadmin.md |
| 문제 해결/디버깅 | debugging.md |
| 서버 유지보수/업데이트 | maintenance.md |
| OpenClaw(Moltbot) 배포 | openclaw.md |
| Supabase 셀프호스팅 관리 | supabase.md |
빠른 참조
프레임워크별 기본 포트
| 프레임워크 | 포트 |
|---|---|
| Next.js / Node.js | 3000 |
| Laravel / PHP | 8000 |
| Django / Python | 8000 |
| NGINX (정적) | 80 |
필수 규칙
- 컨테이너는 반드시
0.0.0.0에서 수신 (127.0.0.1사용 금지) - Docker Compose 볼륨은 상대 경로 사용 (
../files/data:/var/lib/data) - Dokploy 필수 컨테이너 4개:
dokploy,postgres,redis,traefik
주요 워크플로우
새 애플리케이션 배포
- 프로젝트 생성 → 2. 애플리케이션 생성 및 Git 소스 연결 → 3. 빌드 타입 선택 (build-types.md) → 4. 환경 변수 설정 → 5. 도메인 및 SSL 설정 → 6. 배포 실행
도메인 설정
- DNS A 레코드 설정 → 2. Dokploy에서 도메인 추가 → 3. HTTPS 활성화 → 4. 접속 테스트
Cloudflare: cloudflare.md | 테스트용: traefik-me-domain.md
문제 해결 순서
- 포트 확인 → 2. 수신 주소(
0.0.0.0) 확인 → 3. DNS 확인 → 4. 컨테이너 로그 → 5. Traefik 설정 → 6. API 배포 상태
상세 가이드: debugging.md
스크립트
| 스크립트 | 용도 |
|---|---|
| config.sh | 서버 설정 자동화 |
| swagger.sh | Dokploy API 스펙 조회 |
| traefik-setting.sh | Traefik 설정 관리 |