你是否厌倦了主流音乐平台的广告和限制？Black Candy或许是你一直在寻找的解决方案。这款自建音乐流媒体服务器，让你完全掌控自己的音乐体验。

什么是Black Candy？

Black Candy是一款开源的、自建的音乐流媒体服务器，允许用户在自己的服务器上托管和管理音乐库。它支持多种功能，包括音乐播放、专辑管理、艺术家信息获取等。Black Candy的设计理念是让用户能够完全掌控自己的音乐体验，摆脱主流音乐平台的限制。

主要功能

• 自建音乐流媒体：Black Candy允许用户在自己的服务器上托管音乐库，随时随地访问和播放音乐。
• 多平台支持：Black Candy提供了iOS和Android的移动应用，用户可以在手机上轻松访问自己的音乐库。
• Discogs集成：通过Discogs API，Black Candy可以自动获取艺术家和专辑的封面图片，丰富音乐库的视觉体验。
• Docker支持：Black Candy提供了Docker镜像，用户可以轻松地在任何支持Docker的环境中部署和运行。

如何安装？

Black Candy的安装非常简单，只需使用Docker命令即可完成：

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

安装完成后，访问http://localhost:3000即可使用初始管理员账户登录（邮箱：admin@admin.com，密码：foobar）。

升级指南

Black Candy的升级也非常简单，只需拉取最新的Docker镜像并重新启动容器即可：

docker pull ghcr.io/blackcandy-org/blackcandy:latest
docker stop 
docker rm 
docker run  ghcr.io/blackcandy-org/blackcandy:latest

移动应用

Black Candy的移动应用已经在App Store和F-Droid上架，用户可以通过以下链接下载：

• App Store: https://apps.apple.com/app/blackcandy/id6444304071
• F-Droid: https://f-droid.org/packages/org.blackcandy.android/

配置选项

Black Candy支持多种配置选项，包括端口映射、媒体文件挂载、PostgreSQL数据库等。用户可以根据自己的需求进行配置。

环境变量

Black Candy支持多种环境变量，用户可以通过设置环境变量来配置Black Candy的行为。例如：

• DB_URL：PostgreSQL数据库的URL。
• MEDIA_PATH：媒体文件的路径。
• NGINX_SENDFILE：是否启用Nginx发送文件功能。

开发与贡献

Black Candy是一个开源项目，欢迎开发者参与贡献。项目使用Ruby 3.3和Node.js 20进行开发，开发者可以通过以下命令启动开发环境：

bundle install
npm install
rails db:prepare
rails db:seed
./bin/dev

参考资料

1. Black Candy GitHub仓库: https://github.com/blackcandy-org/blackcandy
2. Black Candy Demo: https://demo.blackcandy.org

如果你喜欢这篇文章，请点赞并分享给你的朋友们！