blackcandy-org/blackcandy

어떤 프로젝트인가요?

핵심 기능

• 01컨테이너에 마운트한 미디어 폴더의 음악을 스트리밍합니다.
• 02웹 인터페이스와 공식 iOS, Android, F-Droid 앱을 제공합니다.
• 03기본적으로 SQLite를 사용하며, 대안으로 PostgreSQL을 지원합니다.
• 04관리자 및 일반 사용자 계정을 지원하며, 데모 모드에서는 관리자 접근이 제한됩니다.
• 05Discogs API에서 아티스트 및 앨범 이미지를 가져옵니다.
• 06영구 저장소와 설정 가능한 환경 변수로 Docker 컨테이너에서 실행할 수 있습니다.

활용 사례

• 홈 서버에서 개인 음악 라이브러리를 호스팅하고 브라우저로 어디서든 감상하기.
• 가족이나 소규모 그룹을 위한 비공개 음악 스트리밍 서비스를 운영하기.
• 상용 구독 서비스에 의존하지 않고 휴대폰에서 개인 음악 컬렉션에 접근하기.
• Docker 배포를 참고하며 셀프 호스팅 Rails 애플리케이션을 시험해 보기.

빠른 시작

1. 1

   GitHub Container Registry의 Docker 이미지를 사용해 Black Candy를 실행합니다

   docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
2. 2

   브라우저에서 http://localhost를 열고 초기 관리자 사용자로 로그인합니다

사용 전 알아둘 점

• !기본 데이터베이스는 SQLite입니다. PostgreSQL을 사용하려면 추가 환경 변수 설정과 설치 과정이 필요합니다.
• !서버에서 음악 라이브러리에 접근할 수 있도록 미디어 파일을 컨테이너에 마운트해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

blackcandy은(는) 무엇인가요?

웹 브라우저나 모바일 앱에서 개인 음악 라이브러리를 재생할 수 있는 셀프 호스팅 음악 스트리밍 서버입니다. Black Candy는 Ruby on Rails로 만든 셀프 호스팅 음악 스트리밍 서버입니다. 머신이나 서버의 미디어 폴더를 지정하면 웹 인터페이스와 공식 iOS 및 Android 앱에서 해당 라이브러리를 이용할 수 있습니다.

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

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

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

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

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

홈 서버에서 개인 음악 라이브러리를 호스팅하고 브라우저로 어디서든 감상하기. 가족이나 소규모 그룹을 위한 비공개 음악 스트리밍 서비스를 운영하기. 상용 구독 서비스에 의존하지 않고 휴대폰에서 개인 음악 컬렉션에 접근하기. Docker 배포를 참고하며 셀프 호스팅 Rails 애플리케이션을 시험해 보기.

blackcandy는 어떻게 설치하나요?

GitHub Container Registry의 Docker 이미지를 사용해 Black Candy를 실행합니다: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest 브라우저에서 http://localhost를 열고 초기 관리자 사용자로 로그인합니다

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

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