Black Candy
自托管的音乐流媒体服务器，让你轻松搭建个人专属音乐中心。
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
一键部署的私有音乐流媒体服务，自带移动端 App。
주요 기능
- 一键 Docker 部署，无需复杂配置
- 自带 iOS 和 Android 官方应用
- 支持 SQLite 和 PostgreSQL 双数据库
- 挂载本地音乐目录，自动扫描导入
- 响应式 Web 界面，移动端友好
할 수 없는 것
- •默认使用 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：在设置中添加上传音乐目录，或通过 Web 界面上传文件
- 步骤1：运行命令 docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
- 步骤2：浏览器访问 http://localhost，用默认管理员账号登录（admin@admin.com / foobar）
- 步骤3：在设置中添加上传音乐目录，或通过 Web 界面上传文件
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
停止并删除容器：docker stop <容器名> && docker rm <容器名>，同时删除挂载的持久化数据目录即可完全卸载。
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs