봇 생성 및 배포하기
디스코드 개발자 센터에서 봇 애플리케이션을 만들고 토큰을 발급받아, 디스호스트 컨테이너에 배포하는 전체 과정을 안내합니다.
디스호스트에 봇을 배포하려면 먼저 디스코드 개발자 포털(Developer Portal)에서 애플리케이션을 등록하고, 봇 인증에 필요한 봇 토큰(Token)을 발급받아야 합니다.
1단계: 디스코드 개발자 포털에서 봇 등록
- 포털 접속: 디스코드 개발자 포털에 접속해 디스코드 계정으로 로그인합니다.
- 애플리케이션 생성: 오른쪽 상단의 New Application 버튼을 클릭합니다.
- 팝업창에서 봇의 이름을 입력하고, 약관 동의 체크 후 Create를 누릅니다.
- Bot 설정 이동: 왼쪽 메뉴에서 Bot 탭을 선택합니다.
- 토큰 발급 (Reset Token):
- Reset Token 버튼을 누르고 보안 인증을 완료합니다.
- 화면에 표시되는 긴 문자열이 바로 봇 토큰입니다.
- 이 토큰을 복사해 안전한 곳에 보관해 둡니다.
주의
토큰은 봇의 비밀번호입니다. 토큰이 GitHub 공개 저장소 등에 유출되면 제3자가 봇 계정을 탈취해 악용할 수 있습니다. 유출이 의심되면 즉시 개발자 포털에서 Reset Token을 눌러 토큰을 재발급하세요.
- 인텐트(Intents) 설정:
- 같은 페이지 아래쪽의 Privileged Gateway Intents 섹션으로 이동합니다.
- 메시지 수신이나 멤버 목록 조회가 필요한 경우 해당 토글(특히 Message Content Intent)을 활성화합니다.
- 변경 후 페이지 하단의 Save Changes 버튼을 눌러 저장합니다.
2단계: 디스호스트 대시보드 연동
- 대시보드 접속: 디스호스트 대시보드(
/dashboard)로 이동합니다. - 봇 생성 시작: 오른쪽 상단의 봇 생성 버튼을 클릭합니다.
- 프로젝트 설정 입력:
- 프로젝트 이름: 관리하기 편한 이름을 입력합니다. (예:
my-bot) - 디스코드 봇 토큰: 1단계에서 복사한 토큰 문자열을 붙여넣습니다.
- 런타임 엔진:
- NodeJS: JavaScript 또는 TypeScript로 개발할 때 선택합니다.
- Python: Python(
discord.py,nextcord등)으로 개발할 때 선택합니다.
- 프로젝트 이름: 관리하기 편한 이름을 입력합니다. (예:
- 생성 완료: 생성하기를 누르면 독립된 컨테이너 볼륨이 준비되고 가상 서버가 바로 구성됩니다.
3단계: 소스코드 업로드
- 봇 관리 패널 진입: 대시보드 목록에서 생성한 봇 카드를 클릭합니다.
- 필수 파일 업로드:
- 파일 매니저 탭으로 이동합니다.
- Node.js: 메인 소스 파일(
index.js)과 의존성 목록이 적힌package.json파일을 드래그 앤 드롭으로 업로드합니다. - Python: 메인 소스 파일(
main.py또는bot.py)과requirements.txt파일을 드래그 앤 드롭으로 업로드합니다.
- 진입 파일 확인:
- 스타트업 설정 탭에서 실행할 진입 파일 이름이 실제로 업로드한 파일명(예:
index.js,bot.py)과 일치하는지 확인합니다.
- 스타트업 설정 탭에서 실행할 진입 파일 이름이 실제로 업로드한 파일명(예:
4단계: 봇 실행 및 상태 확인
- 봇 시작: 화면 상단 제어 바에서 시작 (Start) 버튼을 누릅니다.
- 실시간 로그 모니터링:
- 중앙 콘솔 화면에서 부팅 로그를 확인합니다.
- 시스템이
package.json또는requirements.txt를 감지해 필요한 패키지를 자동으로 설치합니다.
- 구동 완료: 로그 콘솔에
Logged in as ...등 로그인 완료 메시지가 출력되면 정상 실행된 것입니다. 디스코드 서버 목록에서도 봇이 온라인으로 전환됩니다.