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