# DisHost

> Discord 봇 무료 호스팅 플랫폼입니다. Node.js와 Python을 지원하며, GitHub 연동 자동 배포, CLI 도구, REST API, 웹 대시보드를 제공합니다.
> 기본 리소스: CPU 25%, RAM 128MB, Disk 512MB, 백업 1개. 평생 무료.

DisHost(디스호스트)는 디스코드 봇을 24시간 무료로 호스팅할 수 있는 한국어 기반 플랫폼입니다.
Docker 컨테이너 기반으로 각 봇은 독립된 샌드박스 환경에서 실행되며, Pterodactyl 패널을 통해 관리됩니다.

- 웹 대시보드: https://dishost.kr
- API Base: https://api.dishost.kr/api/v1
- CLI: `npm install -g dishost`
- GitHub App: https://github.com/apps/dishost

## 시작하기

- [플랫폼 개요](https://dishost.kr/docs/index.md): 디스호스트를 통해 평생 무료로 나만의 초고속 디스코드 봇을 배포하고 24시간 가동하는 방법을 알아봅니다.
- [봇 생성 가이드](https://dishost.kr/docs/bot-creation.md): 디스코드 개발자 센터에서 봇 애플리케이션 등록, 토큰 발급, 그리고 디스호스트에서 컨테이너를 가동하기까지의 전체 과정을 상세히 다룹니다.
- [Node.js 퀵스타트](https://dishost.kr/docs/quickstarts/nodejs.md): discord.js v14 라이브러리를 활용해 1분 만에 핑퐁 봇을 구축하고 디스호스트 컨테이너에 완벽 배포하는 전체 코스입니다.
- [Python 퀵스타트](https://dishost.kr/docs/quickstarts/python.md): discord.py v2 라이브러리를 활용해 1분 만에 핑퐁 봇을 빌드하고 디스호스트 환경에서 오류 없이 올바르게 구동하는 코스입니다.

## CLI

- [CLI 설치](https://dishost.kr/docs/cli/install.md): 터미널에서 DisHost를 사용하는 방법을 처음부터 알려드립니다
- [CLI 명령어 Reference](https://dishost.kr/docs/cli/commands.md): DisHost CLI의 모든 명령어 사용법과 실제 활용 시나리오를 가이드합니다.
- [dishost.yml](https://dishost.kr/docs/cli/dishost-yml.md): 배포 설정 파일 레퍼런스

## GitHub 연동

- [GitHub 연결](https://dishost.kr/docs/github/connect.md): GitHub 계정을 DisHost에 연결하는 방법을 단계별로 설명합니다
- [Auto Deploy](https://dishost.kr/docs/github/auto-deploy.md): GitHub Push 시 자동 배포 설정 가이드

## API

- [API 인증](https://dishost.kr/docs/api/authentication.md): API Key 또는 JWT로 DisHost API에 접근하는 방법
- [API 레퍼런스](https://dishost.kr/docs/api/endpoints.md): DisHost API의 모든 엔드포인트를 용도별로 정리했습니다
- [Webhooks](https://dishost.kr/docs/api/webhooks.md): DisHost 이벤트를 웹훅으로 외부 서비스에 전달하는 방법
- [Swagger UI](https://api.dishost.kr/api/v1/docs): 전체 OpenAPI 명세

## 대시보드 기능

- [실시간 콘솔 및 모니터링](https://dishost.kr/docs/features/console.md): 봇 컨테이너의 실시간 작동 상황 파악, 전원 제어, 그리고 메모리 및 CPU 자원 모니터링 시스템의 올바른 활용법을 다룹니다.
- [파일 매니저 및 웹 에디터](https://dishost.kr/docs/features/file-manager.md): 웹 브라우저 환경에서 직접 파일을 수정하고 폴더를 만들며, 대용량 소스 파일 압축을 전송 및 관리하는 전체 파일 탐색기 시스템을 설명합니다.
- [스케줄 및 자동 예약 관리](https://dishost.kr/docs/features/schedules.md): 특정 주기마다 봇을 재기동하거나, 백업 스냅샷을 생성하고 명령을 실행하기 위한 크론(Cron) 스크립트 작성법을 학습합니다.
- [데이터 백업 및 복원](https://dishost.kr/docs/features/backups.md): 불의의 설정 사고나 DB 깨짐 현상을 예방하기 위해 컨테이너 상태 스냅샷을 보존하고 이전 상태로 빠르게 롤백하는 프로토콜을 제시합니다.
- [스타트업 환경 변수 설정](https://dishost.kr/docs/features/startup-env.md): 봇 컨테이너 구동 시 주입되는 런타임 환경변수(ENV)의 종류와 시작 실행 파일 이름, 파이썬 종속 패키지 리스트 선언 요령을 익힙니다.
- [포트 포워딩 및 도메인 연동](https://dishost.kr/docs/features/subdomain.md): 봇 컨테이너 내부에 Express, FastAPI 웹 서버를 구동하고 외부 포트 바인딩 및 SSL 적용 서브도메인을 할당받아 웹훅을 처리하는 기법을 다룹니다.

## 데이터베이스

- [로컬 SQLite 파일 저장 관리](https://dishost.kr/docs/database/sqlite-persistence.md): 디스호스트 컨테이너 내부 스토리지에 SQLite DB 파일을 배치해 서버 데이터를 보존하고, 쓰기 에러를 줄이는 디스크 저장법과 WAL 모드 활성화 옵션을 다룹니다.
- [외부 클라우드 DB 연동 가이드](https://dishost.kr/docs/database/external-db.md): 봇 컨테이너 외부의 Supabase, MongoDB Atlas 등의 클라우드 DB 연동법과 디스호스트 IP 대역 차단 방지를 위한 방화벽 설정 요령을 안내합니다.

## 디스코드 봇 설정

- [게이트웨이 인텐트 설정](https://dishost.kr/docs/discord/gateway-intents.md): 봇이 접속 준비를 마치고 작동하는데도 이벤트 메시지를 수신하지 못하는 대표적인 현상과 인텐트 설정법을 제시합니다.
- [OAuth2 초대 링크 생성](https://dishost.kr/docs/discord/oauth2-invite.md): 보안 위협을 방지하고 일반 서버 소유자들이 안심하고 봇을 추가할 수 있도록 안전하고 구조적인 봇 초대 링크 생성 프로세스를 설명합니다.
- [슬래시 명령어 개발 및 등록](https://dishost.kr/docs/discord/slash-commands.md): 구식 접두사 문자 명령어에서 디스코드 공식 표준인 애플리케이션 슬래시 명령어(/) 등록법과 즉시 반영 팁을 안내합니다.
- [임베드 및 컴포넌트 V2 활용](https://dishost.kr/docs/discord/embed-generator.md): 디스코드 메시지 카드(Embed) 디자인 양식과 사용자 상호작용을 돕는 버튼, 선택 메뉴, 그리고 최신 컴포넌트 V2(Components V2) 레이아웃 코드 구현법을 익힙니다.

## 마켓플레이스

- [템플릿 마켓플레이스 활용 및 공유](https://dishost.kr/docs/marketplace/templates.md): 코딩 한 줄 없이 1초 만에 음악 봇, 티켓 봇, 관리 봇을 내 컨테이너에 복제 설치하고 내가 직접 제작한 보일러플레이트를 공유하는 방법을 안내합니다.

## 포인트 및 상점

- [포인트 상점 및 무료 연장권](https://dishost.kr/docs/monetization/points-shop.md): 커뮤니티 개발 활동을 바탕으로 포인트를 모아 무료로 봇 호스팅의 하드웨어 리소스를 늘리거나 무료 구동을 연장하는 방법을 소개합니다.

## 보안

- [토큰 유출 방지 및 보안 수칙](https://dishost.kr/docs/security/token-protection.md): 봇 토큰과 기밀 설정 정보를 철저하게 비밀로 유지하고, 만약의 유출 사고 시 신속하게 대응하여 피해를 최소화하는 방법을 정리합니다.
- [API 속도 제한 및 보안 필터링](https://dishost.kr/docs/security/anti-spam.md): 디스코드 본사로부터 요청 거부(429 Too Many Requests) 차단을 당하지 않기 위한 봇 단위 요청 한도 제한 및 사용자 입력 검증 필터를 소개합니다.

## 문제 해결

- [메모리 부족 (OOM) 크래시 해결](https://dishost.kr/docs/troubleshooting/oom-crash.md): 봇 프로세스가 불규칙적으로 멈추며 종료 코드 137(Exit Code 137)이 발생하는 원인을 짚어보고, 코드 최적화 및 힙 메모리 조절법을 다룹니다.
- [패키지 설치 오류 및 해결](https://dishost.kr/docs/troubleshooting/dependency-errors.md): npm install 또는 pip install 중 발생하는 빌드 오류와 네이티브 C++ 라이브러리 모듈 빌드 실패에 대한 원인 분석 및 해결 팁을 알아봅니다.
- [흔히 발생하는 터미널 경고 및 대처](https://dishost.kr/docs/troubleshooting/common-warnings.md): 봇 실행 중 실시간 로그 콘솔에 기록되는 비동기 프로미스 예외, 디스크립터 경고, 그리고 파이썬 이벤트 루프 중단 오류의 조치법을 소개합니다.
- [자주 묻는 질문 FAQ](https://dishost.kr/docs/troubleshooting/faq.md): 디스호스트 커뮤니티 자유게시판 및 개발 Q&A 포털에서 개발자분들이 가장 빈번하게 올리시는 단골 질문들을 선별해 답변을 수록했습니다.

## Optional

- [Pterodactyl API 문서](https://api.dishost.kr/api/v1/docs): DisHost API의 Swagger UI (OpenAPI 3.0)
- [DisHost GitHub](https://github.com/dishost): DisHost GitHub 조직