Black Candy
자체 호스팅 음악 스트리밍 서버로 개인 전용 음악 센터를 손쉽게 구축하세요.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
원클릭으로 배포할 수 있는 프라이빗 음악 스트리밍 서비스로, 모바일 App이 기본 제공됩니다.
주요 기능
- 원클릭 Docker 배포, 복잡한 설정 불필요
- iOS 및 Android 공식 앱 기본 제공
- SQLite 및 PostgreSQL 이중 데이터베이스 지원
- 로컬 음악 디렉터리 마운트, 자동 스캔 및 가져오기
- 반응형 웹 인터페이스, 모바일 친화적
할 수 없는 것
- •기본값은 SQLite이며, 음악 라이브러리가 수천 곡을 초과하는 경우 PostgreSQL로 변경하여 성능을 향상시키는 것을 권장합니다,업그레이드 전에 반드시 공식 업그레이드 가이드를 읽어보세요. 새 버전에는 호환되지 않는 변경 사항이 있을 수 있습니다,실행 시 /app/storage 디렉터리를 영속화해야 하며, 그렇지 않으면 재시작 후 모든 데이터가 손실됩니다,SECRET_KEY_BASE 환경 변수는 사용자 정의하는 것을 권장하며, 그렇지 않으면 재시작할 때마다 session이 무효화됩니다
사용 사례
- 집에서 개인 음악 클라우드를 직접 구축하여 언제든지 내 컬렉션 감상
- 网易云, Spotify 등 서드파티 서비스를 대체하여 프라이버시 보호
- 여러 기기(휴대폰, 컴퓨터, 태블릿)에서 동일한 음악 라이브러리를 동기화하여 재생
Black Candy는 개인 또는 가정용으로 적합한 셀프 호스팅 음악 스트리밍 서버입니다. 로컬 음악 라이브러리를 Spotify와 유사한 비공개 스트리밍 서비스로 바꿔주며, 브라우저 또는 전용 iOS/Android 앱을 통해 재생할 수 있습니다. 서버는 단일 Docker 이미지 형태로 제공되어 배포가 매우 간단하며, 기본적으로 SQLite 데이터베이스를 사용합니다(PostgreSQL 선택 가능). 기능에는 사용자 인증, 미디어 파일 마운트, 백그라운드 작업 처리, 그리고 환경 변수를 통한 유연한 설정이 포함됩니다. 공식 모바일 앱은 App Store와 F-Droid에 출시되어 있어, 추가 클라이언트 없이도 광고와 추적이 없는 음악 경험을 즐길 수 있습니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: 다음 명령을 실행합니다 docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
2단계: 브라우저에서 http://localhost 에 접속하여 기본 관리자 계정으로 로그인합니다(admin@admin.com / foobar)
3단계: 설정에서 업로드할 음악 디렉터리를 추가하거나 웹 인터페이스를 통해 파일을 업로드합니다
- 1단계: 다음 명령을 실행합니다 docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
- 2단계: 브라우저에서 http://localhost 에 접속하여 기본 관리자 계정으로 로그인합니다(admin@admin.com / foobar)
- 3단계: 설정에서 업로드할 음악 디렉터리를 추가하거나 웹 인터페이스를 통해 파일을 업로드합니다
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
컨테이너 중지 및 삭제: docker stop <컨테이너 이름> && docker rm <컨테이너 이름>, 마운트된 영구 데이터 디렉토리도 함께 삭제하면 완전히 제거할 수 있습니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs