Sign in
Development

Invidious 사용법: 추적을 줄인 YouTube 대체 프런트엔드를 직접 운영하기

GitHub Trending 일간 4위에 오른 Invidious의 기능과 Docker 설치 흐름, 지원 환경, 데이터·네트워크 권한, 운영상 한계를 확인한다.

Invidious 사용법: 추적을 줄인 YouTube 대체 프런트엔드를 직접 운영하기

Invidious는 YouTube 영상을 더 가벼운 웹 화면에서 탐색하고 재생할 수 있게 하는 오픈소스 대체 프런트엔드다. 광고와 자체 추적을 넣지 않고, JavaScript 없이도 기본 기능을 쓸 수 있으며, Google 계정과 분리된 구독·재생목록·시청 기록을 제공한다.

2026년 9월 2일 10:04(Asia/Seoul) 확인 기준 GitHub Trending 일간 목록 4위에 올랐고, 화면에 577 stars today가 표시됐다. 같은 시각 GitHub 저장소 API의 총 스타는 23,770개였다. 일간 1위 OpenClaude는 라이선스가 API에서 명확히 식별되지 않았고, 2위는 자료 모음, 3위 OpenMAIC는 전날 이미 다뤘기 때문에 다음 적합 후보인 Invidious를 골랐다.

무엇을 하는 소프트웨어인가

Invidious는 공식 YouTube API를 사용하지 않고 YouTube의 공개 웹 요청을 해석해 별도 화면과 개발자 API를 제공한다. 사용자는 공개 인스턴스를 선택해 바로 쓸 수도 있고 자신의 서버에 설치할 수도 있다. 다국어, 밝고 어두운 테마, 오디오 전용 재생, 구독 알림, 데이터 가져오기·내보내기 같은 기능을 제공한다.

여기에는 분명한 대가가 있다. YouTube의 비공개 인터페이스 변화에 따라 재생이 갑자기 깨질 수 있고, 공개 인스턴스 운영자는 큰 대역폭과 빈번한 유지보수를 감당해야 한다. ‘프라이버시 친화적 화면’이 곧 익명성을 보장한다는 뜻도 아니다. 운영 서버와 상위 영상 제공자는 네트워크 메타데이터를 볼 수 있다.

최소 설치 흐름

공식 문서는 Docker Engine과 Docker Compose V2를 이용한 구성을 권장한다. 현재 구성은 PostgreSQL과 Invidious Companion을 함께 사용하므로 저장소의 compose 파일과 데이터베이스 초기화 파일이 필요하다.

git clone https://github.com/iv-org/invidious.git
cd invidious
# docker-compose.yml에서 서로 다른 임의의 HMAC 키와 Companion 키를 설정
docker compose up -d

명령 형식은 공식 설치 문서와 저장소를 대조했다. 이 글에서는 실제 서비스를 띄우지 않았다. 기본 예제의 키와 데이터베이스 비밀번호를 그대로 인터넷에 노출하면 안 되며, 외부 공개 시에는 HTTPS 역방향 프록시와 도메인 설정, 로그·백업 정책을 추가해야 한다.

실제 활용 시나리오

  • 개인용 인스턴스: 구독 목록을 Google 계정과 분리하고 광고 없는 가벼운 화면을 사용한다.
  • 내부 교육망: 허용된 영상 링크를 단순한 화면으로 제공하되 저작권과 기관 정책을 함께 적용한다.
  • 개발자 API: 영상·채널 메타데이터를 읽는 애플리케이션을 만들 수 있지만 비공식 상위 인터페이스 변화에 대비해야 한다.
  • 브라우저 리디렉션: 확장 기능을 통해 YouTube 링크를 선택한 Invidious 인스턴스로 보내는 방식이 가능하다.

지원 환경과 운영 비용

최신 안정 릴리스는 v2.20260804.1이며 OCI 이미지의 디버그 심볼 누락을 고친 패치다. 기본 브랜치는 master, 확인 시점의 최신 커밋은 b3a3f3a6df47, 라이선스는 AGPL-3.0이다. 수정한 서비스를 네트워크로 제공하면 AGPL의 소스 제공 의무를 검토해야 한다.

공식 문서는 최소 20GB 디스크와 2GB 여유 RAM을 제시하며, 공개 인스턴스에는 60GB 디스크, 4GB RAM, 2 vCPU, 200Mbps 회선과 월 20TB 수준의 트래픽을 권장한다. PaaS·SaaS 환경은 대역폭이 큰 프록시 성격 때문에 지원하지 않는다고 명시한다. 수치는 하한이나 보장이 아니라 운영 계획의 출발점으로 봐야 한다.

권한·보안·데이터 주의점

  • HMAC 키와 Companion 키를 서로 다르게 생성하고 저장소에 커밋하지 않는다.
  • PostgreSQL은 외부에 노출하지 않고, Invidious와 Companion 사이의 내부 포트도 필요한 범위로만 연다.
  • 공개 인스턴스에는 가입·요청 속도 제한, 로그 보존, 신고 대응과 콘텐츠 정책이 필요하다.
  • 구독·시청 기록을 서버 계정에 저장하면 운영자가 그 데이터를 관리하게 된다. 백업 암호화와 삭제 절차를 정한다.
  • YouTube 서비스 약관과 지역 법률, 저작권을 확인한다. 도구가 제공하는 기능이 다운로드나 재배포 권리를 부여하지 않는다.

도입 전 확인할 한계

Invidious는 YouTube의 공식 클라이언트가 아니다. 상위 서비스가 응답 형식이나 접근 통제를 바꾸면 재생·검색·자막이 일시적으로 중단될 수 있다. 공식 문서가 인스턴스의 정기 재시작을 권할 만큼 운영 손이 필요하고, 공개 서비스는 트래픽 비용과 차단 대응이 크다. 가볍게 시험하려면 먼저 신뢰할 수 있는 공개 인스턴스를 사용하고, 장기간 쓸 목적과 운영 역량이 분명할 때 자체 호스팅을 검토하는 편이 현실적이다.

출처와 확인 수치

순위·일간 스타 증가·총 스타·브랜치·커밋·라이선스는 2026년 9월 2일 10:04(Asia/Seoul) 확인값이다.

Read next