디스호스트 뮤직봇 템플릿 사용 가이드

이 가이드는 디스호스트에서 뮤직봇 템플릿을 사용하여 Discord 뮤직봇 서버를 생성하고 설정하는 방법을 설명합니다.

개요

디스호스트 뮤직봇 템플릿을 사용하면 YouTube 음악을 재생할 수 있는 Discord 봇을 쉽게 배포할 수 있습니다. 자신만의 음악 봇을 통해 안정적인 음악 스트리밍 환경을 구축할 수 있습니다.

준비사항

1. Discord 봇 토큰: Discord Developer Portal에서 생성
   • 디스코드 봇 생성 및 초대 링크 만들기 해당 글을 참고하여 봇 토큰을 생성합니다.
2. Firefox 브라우저: 쿠키 추출을 위해 필요
3. 디스호스트 계정: 서버 생성을 위해 필요

단계별 설정 가이드

1단계: 뮤직봇 템플릿으로 서버 생성

1. 디스호스트 대시보드 접속

   • 디스호스트 웹사이트에 로그인합니다.
   • 대시보드에서 "새 서버 생성" 버튼을 클릭합니다.

2. 템플릿 선택

   • 템플릿 목록에서 뮤직봇 템플릿을 선택합니다.
   • 서버 생성을 완료합니다.

3. 서버 확인

   • 생성된 서버가 대시보드에 표시되는지 확인합니다.

2단계: Firefox로 YouTube 쿠키 추출

YouTube의 지역 제한을 우회하기 위해 쿠키 파일이 필요합니다.

1단계: 브라우저 확장 프로그램 설치

• Chrome: Get cookies.txt LOCALLY 확장 프로그램 설치
• Firefox: cookies.txt 확장 프로그램 설치

⚠️ 주의: "Get cookies.txt" (not "LOCALLY") Chrome 확장 프로그램은 악성코드로 신고되어 Chrome 웹스토어에서 제거되었습니다. 반드시 "LOCALLY" 버전을 사용하세요.

2단계: 쿠키 추출 과정

1. 시크릿/사생활 보호 모드로 새 창을 엽니다.
2. 해당 창에서 YouTube에 로그인합니다.
3. 같은 창, 같은 탭에서 https://www.youtube.com/robots.txt로 이동합니다.
   • 이 단계가 매우 중요합니다! 반드시 robots.txt 페이지에서 쿠키를 추출하세요.
4. 확장 프로그램을 사용하여 youtube.com 쿠키를 추출합니다.
5. cookies.txt 파일로 저장합니다.
6. 시크릿 창을 완전히 닫습니다 (세션이 다시 열리지 않도록)

3단계: 쿠키 파일 업로드

1. 디스호스트 파일 관리자 접속

   • 서버 대시보드에서 "파일 관리자" 탭을 클릭합니다.
   • 루트 디렉터리가 표시됩니다.

2. 쿠키 파일 업로드

   1. "업로드" 버튼을 클릭합니다.
   2. 앞서 다운로드한 cookies.txt 파일을 선택합니다.
   3. 업로드가 완료될 때까지 기다립니다.

3. 파일 위치 확인

   • 업로드된 cookies.txt 파일이 루트 디렉터리에 있는지 확인합니다.

4단계: Discord 봇 토큰 설정

1. 환경 변수 파일 편집

   • 파일 관리자에서 .env 파일을 찾아 더블클릭하여 편집합니다.

2. 봇 토큰 추가

   # Discord 봇 토큰을 입력하세요
   DISCORD_TOKEN=여기에_봇_토큰을_입력하세요

3. 파일 저장

5단계: 서버 실행

1. 서버 시작

   • 서버 대시보드의 "콘솔" 탭으로 이동합니다
   • "시작" 버튼을 클릭하여 서버를 실행합니다

2. 실행 로그 확인

   콘솔에서 다음과 같은 메시지가 표시되면 성공입니다:
   
   [INFO] - dishost_musicbot - Bot is ready!
   [INFO] - discord.client - Logged in as YourBotName#1234

3. 오류 해결

   • 토큰 오류: .env 파일의 DISCORD_TOKEN 값을 확인합니다
   • 쿠키 오류: cookies.txt 파일이 올바르게 업로드되었는지 확인합니다

🔧 고급 설정

쿠키 갱신

YouTube 쿠키는 시간이 지나면 만료됩니다. 주기적으로 갱신해야 합니다:

1. Firefox에서 새로운 쿠키 파일을 추출합니다
2. 기존 cookies.txt 파일을 삭제합니다
3. 새로운 쿠키 파일을 업로드합니다
4. 서버를 재시작합니다

봇 권한 설정

Discord 서버에서 봇이 정상적으로 작동하려면 다음 권한이 필요합니다:

• 메시지 보내기
• 슬래시 명령어 사용
• 음성 채널 연결
• 음성 채널에서 말하기
• 활동 상태 사용

❓ 문제 해결

자주 발생하는 문제

1. 봇이 음성 채널에 연결되지 않는 경우

   • 봇 권한을 확인합니다
   • 음성 채널에 다른 사용자가 있는지 확인합니다

2. YouTube 영상이 재생되지 않는 경우

   • 쿠키 파일이 최신인지 확인합니다
   • 지역 제한된 영상인지 확인합니다

3. 봇이 응답하지 않는 경우

   • 서버 콘솔에서 오류 로그를 확인합니다
   • 봇 토큰이 올바른지 확인합니다

로그 확인

서버 콘솔에서 실시간으로 봇의 상태를 확인할 수 있습니다:

[INFO] - 정상 작동 메시지
[WARNING] - 주의가 필요한 상황
[ERROR] - 오류 발생

📞 지원

문제가 해결되지 않는 경우:

1. 디스호스트 디스코드 서버에서 도움 요청
2. 디스호스트 블로그에서 추가 가이드 확인
3. 서버 콘솔의 오류 로그를 첨부하여 문의

---

이 가이드는 디스호스트 뮤직봇 템플릿 v2.0 기준으로 작성되었습니다.