tkrmagid e7283ae862 experiment: 더 빠른 경로 발견 — 유튜브 내부 API(VISIONOS) 직접 호출로 리졸브 0.3초
yt-dlp 호출 자체를 없애는 경로를 탐색해 실측했다.

[탐색 과정]
- 내부 player API 를 클라이언트별로 호출해 비교:
  ANDROID_VR/TVHTML5/WEB_EMBEDDED = LOGIN_REQUIRED·ERROR, WEB = SABR 전용(직접 URL 없음)
  IOS = 0.32s 로 직접 URL(itag 140) 획득했으나 뒷부분 range 요청이 403 → 이어받기 불가
- 정상 재생되는 yt-dlp URL 의 c= 파라미터가 VISIONOS 임을 확인하고 동일 클라이언트로 재현.
  visitorData 없이 호출하면 LOGIN_REQUIRED, 넣으면 status=OK.

[결과] VISIONOS + visitorData 직접 호출
- 추출 0.30~0.38s (현행 상주 리졸버 1.7~2.3s, 기존 subprocess 4.2~4.7s)
- itag 251 로 yt-dlp 결과와 동일 포맷, Lavalink loadType=track
- range 0 / 1MB / 2MB / 3MB 전부 206 → 이어받기 정상(SABR·IOS 와 다름)
- 실제 재생: 90초 끊김 0/17, 일반곡·곡전환 성공. 첫 소리 2.0~2.3s
- 리졸버에 0순위로 넣고 실패 시 상주 lib → subprocess 로 폴백(경로 통계 innertube 5 / lib 1 / 실패 0)

미해결/주의: visitorData 를 정적 파일에서 읽는 프로토타입이라, 운영 적용 시 봇이 2시간마다
생성하는 visitorData 를 공유받도록 배선해야 한다. 검색어(비 URL) 입력은 영상 ID 가 없어
기존 경로로 폴백한다. 연령제한곡은 미검증(폴백 경로가 쿠키로 처리).
프로덕션(리졸버 8779, Lavalink, master)은 변경하지 않았다.
2026-09-17 19:06:47 +09:00

music_bot_v2

디스코드 음악봇 + 웹 대시보드 모노레포. 디스코드에서 명령으로 음악을 틀 수도 있고, 웹에서 로그인해 검색·재생·대기열을 제어할 수도 있다. 성인인증(연령제한) 영상 재생까지 지원한다.

구성

디렉터리 내용 문서
bot/ 디스코드 봇 본체(discord.js + shoukaku/Lavalink). 검색·재생·대기열·자동재생·연령제한 우회. bot/README.md
page/ 웹 대시보드(Next.js 16 + NextAuth + Redis). 브라우저에서 봇 제어·상태 표시. page/README.md
resolver/ ytresolver.py — yt-dlp 기반 오디오 URL 리졸버(+systemd 유닛). 봇이 연령제한/SABR 우회에 사용. 아래 + bot/README §1·2
scripts/ refresh-cookies.mjs — 유튜브 쿠키(ytcookie.txt) 재발급 스크립트(Chromium). bot/README §4

전체 아키텍처

                         ┌─────────────── 디스코드 제어 평면 ───────────────┐
[Discord 유저] ── 명령 ──▶ 봇(music1/2/3, .5 docker) ── shoukaku ──▶ Lavalink(.6:2333)
                               │  ▲                                   └ youtube-plugin(일반)
                               │  │ 재생 직전 리졸브
                               ▼  │
                         ytresolver(.5:8779) ── yt-dlp(+쿠키) ──▶ 직접 오디오 URL
                               │                                   (Lavalink http 소스로 재생)
                               │
         ┌───────── Redis(.7) Pub/Sub + Key ─────────┐   ← 제어/상태 버스
         │                                           │
[브라우저] ──▶ 웹 대시보드 page/(Next.js, NextAuth) ──┘
              · site→bot: "site-bot" 명령 + 결과키 폴링(botRpc)
              · bot→site: "bot-site" 이벤트 → SSE 실시간 표시
  • 봇과 대시보드는 직접 연결되지 않고 Redis로 느슨하게 연동된다(대시보드는 Redis만 있으면 봇과 통신).
  • 봇은 유튜브 연령제한 영상을 Lavalink만으로는 못 틀어서, resolver/가 쿠키로 직접 오디오 URL을 뽑아 우회한다.
  • 봇 서버(.5)와 Lavalink(.6)가 같은 공인 IP라, .5에서 뽑은 스트림 URL을 .6이 그대로 재생한다.

빠르게 보기

  • 봇 배포/쿠키/검색·재생 동작·성능·트러블슈팅 → bot/README.md
  • 대시보드 개발/환경변수/Redis 통신 구조/API·UI → page/README.md

리포 규칙

  • bot/.gitignore가 *.env, *.db를 제외 → 실제 토큰/DB는 커밋되지 않는다. 예시는 bot/.env.example.
  • 원격: Gitea git.tkrmagid.kr/tkrmagid/music_bot_v2 (master).
Description
음악봇 v2
Readme 1.8 MiB
Languages
TypeScript 88.2%
Python 8.8%
JavaScript 1.9%
CSS 0.5%
Dockerfile 0.4%
Other 0.2%