blackcandy-org/blackcandy

这是什么？

核心功能

• 01从挂载到容器中的媒体目录读取并播放音乐。
• 02提供网页界面，以及官方 iOS、Android 和 F-Droid 应用。
• 03默认使用 SQLite，也可切换为 PostgreSQL。
• 04支持管理员和普通用户账户，并提供限制管理权限的演示模式。
• 05通过 Discogs API 获取艺人和专辑图片。
• 06以 Docker 容器运行，支持数据持久化和环境变量配置。

适用场景

• 在家庭服务器上托管个人音乐库，并通过任意浏览器收听。
• 为家人或小团队搭建私人音乐流媒体服务。
• 不依赖商业订阅服务，在手机上访问自己的音乐收藏。
• 以该项目作为参考，学习使用 Docker 部署 Rails 应用。

快速上手

1. 1

   使用 Docker 从 GitHub Container Registry 运行 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 怎么安装和运行？

使用 Docker 从 GitHub Container Registry 运行 Black Candy: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest 在浏览器中打开 http://localhost 并使用初始管理员账户登录

在哪里获取 blackcandy？

源代码和安装说明在 GitHub 上：https://github.com/blackcandy-org/blackcandy