트러블슈팅 및 FAQ

자주 묻는 질문 FAQ

디스호스트 커뮤니티 자유게시판 및 개발 Q&A 포털에서 개발자분들이 가장 빈번하게 올리시는 단골 질문들을 선별해 답변을 수록했습니다.

디스호스트 사용 중에 발생할 수 있는 일반적인 질문과 핵심 궁금증에 대한 답변입니다. 원하는 질문을 찾지 못했다면 커뮤니티 Q&A 포털에 자유롭게 질문글을 남겨주시면 고수 개발자들이 빠르게 도와드립니다.


자주 묻는 질문 모음

Q. 봇이 대시보드에서는 시작(Started) 상태인데 디스코드 서버에서는 오프라인(Offline)으로 보입니다.

  • A: 디스코드 포털에서의 게이트웨이 인텐트(Gateway Intents) 누락이 원인일 가능성이 99%입니다.
    • 디스코드 개발자 센터 -> Bot 탭으로 가셔서 Privileged Gateway Intents 섹션 하단의 세 가지 권한(특히 Message Content Intent) 스위치를 모두 활성화한 뒤 저장해 주세요.
    • 코드가 다시 실행되도록 봇을 재기동해 주셔야 온전하게 온라인 마킹이 들어옵니다. 자세한 세부 조치는 게이트웨이 인텐트 설정 가이드를 참조하세요.

Q. 평생 무료로 가동할 수 있는 봇 슬롯은 최대 몇 개까지인가요?

  • A: 디스호스트는 최초 가입 시 1개의 무료 기본 봇 슬롯을 제공합니다.
    • 만약 더 많은 봇을 동시에 독립 가동하고 싶다면, 커뮤니티 활동으로 포인트를 획득해 추가 봇 슬롯 (+1개) 확장권을 포인트 상점에서 구매하여 늘리실 수 있습니다.

Q. 봇이 음성(보이스) 채널에 입장하여 노래를 재생(Streaming)할 수 있나요?

  • A: 음악 재생은 가능하지만 권장하지 않으며, 추가 의존성 세팅이 필요합니다.
    • 음악 봇 구동 시 오디오 변환을 위해 필수 도구인 ffmpeg 엔진이 컨테이너 내부 런타임 상에 사전 포함되어 있어야 합니다.
    • 디스호스트는 오디오 연동을 위해 경량화된 빌드 환경을 구축해두었으나, 다량의 음원 디코딩 및 보이스 스트리밍 연산은 CPU(25%) 및 128MB 램 메모리 한계를 순식간에 침범하여 OOM(메모리 부족) 137 크래시를 촉발합니다.
    • 되도록 소규모 서버용 핑퐁/안내봇 용도로 활용하시는 것을 권장합니다.

Q. 봇에서 외부 웹 서버(Express, FastAPI)를 띄워 포트 연결을 수신할 수 있나요?

  • A: 기본 무료 플랜에서는 지원하지 않습니다.
    • 기본 무료 슬롯에서는 외부 접속(포트 포워딩 및 서브도메인 연동) 기능이 제한됩니다. 이 기능을 활용하여 외부 웹훅이나 대시보드 웹 서버 접속을 수신하시려면 업그레이드가 필요합니다.