kaybi-gh/K7

어떤 프로젝트인가요?

핵심 기능

• 01로컬에 저장된 영화, TV 시리즈, 음악을 하나로 모은 통합 라이브러리
• 02제한된 클라이언트나 네트워크에서도 재생할 수 있도록 ffmpeg를 사용한 HLS 트랜스코딩
• 03공통 인터페이스를 사용하는 웹, Android, Windows 및 기타 클라이언트
• 04파일을 중복 저장하지 않고 원격 미디어를 스트리밍하는 K7 인스턴스 간 페더레이션
• 05타사 음악 앱을 위한 OpenSubsonic 지원
• 06선택적 2FA 및 OIDC 로그인, 관리자 제어 게스트 접근

활용 사례

• 가정의 영화와 음악 컬렉션을 가족과 공유
• 홈랩에서 친구 몇 명을 위한 비공개 미디어 서버 운영
• 셀프 호스팅 서버 두 대를 연결해 친구끼리 서로의 라이브러리 스트리밍
• OpenSubsonic 호환 앱으로 개인 음악 컬렉션 재생

빠른 시작

1. 1

   예제 환경 설정 파일을 복사합니다

   cp .env.example .env
2. 2

   .env에서 POSTGRES_PASSWORD를 설정한 다음 Docker Compose로 시작합니다

   docker compose up -d
3. 3

   브라우저에서 http://localhost:7080을 열고 초기 설정을 완료합니다

사용 전 알아둘 점

• !가족과 친구 등 소규모 그룹을 위해 만들어졌습니다. 메인테이너는 모든 기능 요청을 구현하지는 않을 것이라고 밝혔습니다.
• !라이브 데모에서는 게스트 로그인만 사용할 수 있어 전체 계정 기능을 체험할 수 없습니다.
• !Linux 클라이언트는 실험 단계이며, iOS 및 Mac 빌드는 메인테이너가 테스트하지 않았습니다.

토픽

자주 묻는 질문

K7은(는) 무엇인가요?

가족과 친구 몇 명을 위해 설계된 셀프 호스팅 미디어 서버 K7은 로컬 저장소에 보유한 영화, TV 시리즈, 음악을 하나의 라이브러리로 모아주는 셀프 호스팅 미디어 서버입니다. 공개 스트리밍이 아닌 가족과 친구로 이루어진 소규모 그룹을 대상으로 하며, ASP.NET Core와 Blazor로 개발되고 PostgreSQL과 함께 Docker Compose로 배포됩니다.

K7은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

K7은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

K7은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. K7의 마지막 커밋은 2026년 10월 19일입니다.

K7은(는) 어디에 사용할 수 있나요?

가정의 영화와 음악 컬렉션을 가족과 공유 홈랩에서 친구 몇 명을 위한 비공개 미디어 서버 운영 셀프 호스팅 서버 두 대를 연결해 친구끼리 서로의 라이브러리 스트리밍 OpenSubsonic 호환 앱으로 개인 음악 컬렉션 재생

K7는 어떻게 설치하나요?

예제 환경 설정 파일을 복사합니다: cp .env.example .env .env에서 POSTGRES_PASSWORD를 설정한 다음 Docker Compose로 시작합니다: docker compose up -d 브라우저에서 http://localhost:7080을 열고 초기 설정을 완료합니다

K7은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kaybi-gh/K7