디스호스트 Pterodactyl 패널에 봇 업로드하기#

1. 압축 파일 생성#

1. 업로드할 모든 봇 파일을 하나의 폴더에 모읍니다.
2. 필수 파일 목록을 확인합니다:
   • 봇 소스 코드 파일
   • 의존성 정의 파일 (package.json, requirements.txt 등)
   • 환경 설정 파일 (config.json, .env 등)
   • 기타 필요한 자원 파일 (이미지, 데이터 등)
3. 모든 파일을 ZIP 형식으로 압축합니다.

중요: ZIP 파일 내부에 추가 폴더를 만들지 말고, 모든 파일이 루트 디렉토리에 바로 위치하도록 압축하세요.

2. 파일 크기 확인#

디스호스트 Pterodactyl 패널에서는 다음과 같은 파일 크기 제한이 있습니다:

• 최대 ZIP 파일 크기: 300MB
• 최대 개별 파일 크기: 100MB

대용량 미디어 파일이나 데이터 세트가 필요한 경우, 외부 저장소를 사용하거나 업로드 후 다운로드하는 방식을 고려하세요.

1. 패널 접속 방법 (두 가지 옵션)#

옵션 1: 디스호스트 대시보드를 통한 접속

1. 디스호스트 웹사이트에 로그인합니다.
2. 왼쪽 사이드바에서 ‘내 봇’ 메뉴를 클릭합니다.
3. 원하는 봇 서버 카드에서 ‘패널로 이동’ 또는 ‘콘솔’ 버튼을 클릭합니다.

옵션 2: 직접 패널 URL 접속

1. 웹 브라우저에서 https://panel.dishost.kr로 이동합니다.
2. Pterodactyl 패널에 연동된 계정 정보로 로그인합니다.

2. 서버 선택#

로그인 후 서버 목록 페이지가 표시됩니다:

1. 봇 코드를 업로드할 서버를 찾습니다.
2. 해당 서버를 클릭하여 서버 관리 페이지로 이동합니다.

서버 관리 페이지에서는 다양한 탭을 통해 봇을 관리할 수 있습니다.

1. 파일 관리자 접속#

1. 서버 관리 페이지 상단의 탭 중 ‘Files’ 탭을 클릭합니다.
2. 파일 관리자 인터페이스가 표시됩니다.

2. ZIP 파일 업로드#

1. 파일 관리자 화면 오른쪽 상단에 있는 ‘Upload’ 버튼을 클릭합니다.
2. 파일 선택 대화 상자가 나타나면 앞서 준비한 봇 ZIP 파일을 선택합니다.
3. ‘Upload’ 버튼을 클릭하여 업로드를 시작합니다.
4. 업로드 진행 상황이 표시됩니다. 파일 크기에 따라 몇 분이 소요될 수 있습니다.

팁: 업로드 중에는 패널 창을 닫거나 다른 페이지로 이동하지 마세요. 업로드가 중단될 수 있습니다.

3. ZIP 파일 압축 해제#

업로드가 완료되면 다음 단계를 따라 ZIP 파일을 압축 해제합니다:

1. 업로드된 ZIP 파일을 찾습니다.
2. ZIP 파일을 마우스 오른쪽 버튼으로 클릭합니다.
3. 나타나는 메뉴에서 ‘Unarchive’ 옵션을 선택합니다.
4. 압축 해제 작업이 시작되며, 이 과정은 파일 크기에 따라 몇 분이 소요될 수 있습니다.
5. 압축 해제가 완료되면 모든 봇 파일이 현재 디렉토리에 표시됩니다.

중요: 압축 해제 후에는 원본 ZIP 파일을 삭제하여 디스크 공간을 절약할 수 있습니다. ZIP 파일을 선택하고 마우스 오른쪽 버튼을 클릭한 후 ‘Delete’ 옵션을 선택하세요.

1. Startup 탭으로 이동#

1. 서버 관리 페이지 상단의 탭 중 ‘Startup’ 탭을 클릭합니다.
2. 시작 설정 인터페이스가 표시됩니다.

2. 시작 명령어 설정#

‘Startup’ 섹션에서 봇을 실행하기 위한 설정을 구성합니다:

1. 언어별 설정 방법:

   Node.js 봇:

   • ‘STARTUP FILE’ 필드에 진입점 파일 이름(예: index.js, main.js, bot.js)을 입력합니다.
   • 필요에 따라 추가 시작 옵션을 구성합니다.

   Python 봇:

   • ‘STARTUP FILE’ 필드에 메인 Python 파일 이름(예: bot.py, main.py)을 입력합니다.
   • 필요에 따라 Python 버전이나 가상 환경 설정을 조정합니다.

2. 설정을 완료한 후 ‘Save’ 버튼을 클릭하여 변경 사항을 저장합니다.

1. Console 탭으로 이동#

1. 서버 관리 페이지 상단의 탭 중 ‘Console’ 탭을 클릭합니다.
2. 서버 콘솔 인터페이스가 표시됩니다.

2. 봇 시작하기#

1. 콘솔 화면 상단에 있는 ‘Start’ 버튼을 클릭합니다.
2. 봇 시작 프로세스가 시작되며 콘솔에 로그가 표시됩니다.
3. 로그를 모니터링하여 봇이 성공적으로 시작되었는지 확인합니다.

팁: 시작 과정에서 오류가 발생한 경우, 콘솔 로그를 확인하여 문제를 파악하고 수정하세요.

3. 봇 상태 확인#

봇이 성공적으로 실행되면 다음과 같은 징후를 확인할 수 있습니다:

1. 콘솔에 ‘Ready’ 또는 ‘온라인’ 메시지가 표시됩니다.
2. 디스코드에서 봇의 상태가 온라인으로 변경됩니다.
3. 봇이 명령어에 응답합니다.

파일 수정하기#

업로드 후 코드나 설정을 수정해야 하는 경우:

1. ‘Files’ 탭으로 이동합니다.
2. 수정할 파일을 찾아 클릭합니다.
3. 파일 편집기가 열리면 내용을 수정합니다.
4. ‘Save Content’ 버튼을 클릭하여 변경 사항을 저장합니다.
5. 변경 사항을 적용하려면 봇을 재시작해야 할 수 있습니다.

일반적인 문제 해결#

1. 봇이 시작되지 않는 경우:

   • 콘솔 로그에서 오류 메시지를 확인합니다.
   • ‘Startup’ 탭에서 시작 파일 설정이 올바른지 확인합니다.
   • 환경 변수가 올바르게 설정되었는지 확인합니다.

2. 파일 업로드 실패:

   • 파일 크기가 제한(300MB)을 초과하지 않는지 확인합니다.
   • 네트워크 연결 상태를 확인합니다.
   • 업로드를 더 작은 파일로 나누어 시도합니다.

3. 압축 해제 오류:

   • ZIP 파일이 손상되지 않았는지 확인합니다.
   • 다른 압축 도구로 ZIP 파일을 다시 생성해 봅니다.

4. 의존성 관련 오류:

   • 의존성 파일(package.json, requirements.txt)이 루트 디렉토리에 있는지 확인합니다.

Q: 봇 코드를 압축하지 않고 개별 파일로 업로드할 수 있나요?#

A: 네, 가능합니다. 하지만 파일이 많은 경우 ZIP 압축 방식이 더 효율적입니다.

Q: 봇이 24/7 실행되나요?#

A: 네, 서버가 활성화되어 있는 한 봇은 중단 없이 24시간 실행됩니다.

Q: 봇이 자동으로 재시작되나요?#

A: 예상치 못한 오류로 봇이 종료되어도 Pterodactyl 시스템이 자동으로 재시작을 시도합니다.

Q: 패널에서 봇의 성능을 모니터링할 수 있나요?#

A: 네, ‘Console’ 탭에서 실시간 로그를 확인하고, ‘Resources’ 탭에서 CPU, 메모리 사용량 등을 모니터링할 수 있습니다.