- 项目源码地址：
https://github.com/blackcandy-org/blackcandy - Docker镜像仓库：
docker pull blackcandy/blackcandy - 快速启动命令示例：
docker run -d --name blackcandy \
-e PUID=$(id -u) -e PGID=$(id -g) \
-v <path-to-localdb-dir>:/app/storage \
-v <path-to-local-muiscs>:/media_data \
-e MEDIA_PATH=/media_data \
-p 3000:3000 \
blackcandy/blackcandy
如果您希望跳过详细说明，可以直接执行上述Docker命令来快速部署和启动服务。
项目概述与核心功能
BlackCandy可以被视为一款专为NAS环境设计的音乐流媒体平台，其理念类似于网易云音乐的本地化版本。该服务以其简洁直观的界面设计著称，能够自动识别和索引用户本地的音频文件。通过内置的智能扫描机制，它可以快速加载音乐文件的元数据，例如专辑封面和艺术家信息，从而提供流畅的网页播放体验。整体而言，BlackCandy非常适合作为个人或家庭环境中的轻量级音乐播放解决方案。
安装部署与实际操作步骤
按照上述快速启动命令，用户可以轻松完成BlackCandy的安装和运行。启动完成后，在浏览器中输入地址：http://<nas-ip>:3000，即可访问BlackCandy的登录页面。系统默认的登录凭据为用户名admin@admin.com和密码foorbar。成功登录后，用户将进入服务的主界面。
在初次安装时，主界面可能显示为空状态，因为系统尚未执行音频文件的扫描操作（上图中展示的是已完成扫描后的效果）。要启用扫描功能，用户需要进入设置界面进行调整。
具体操作是点击页面右上角的图标，选择“settings”选项，然后在打开的配置页面中点击“sync”按钮。系统将迅速开始扫描本地存储的音频文件，并自动加载相关的专辑封面和歌手信息。如果用户希望实现自动化的持续扫描，可以勾选“Enable Media Listener”选项以启用媒体监听功能。
完成上述设置后，返回主界面即可看到已识别的音乐专辑列表。此时，BlackCandy便作为一个功能完整的网页音乐播放器运行，支持基本的播放、暂停和曲目切换操作。
使用心得与整体评价
BlackCandy项目的核心优势在于其极简主义的设计哲学和高度专注的音乐播放功能。它没有集成过多复杂特性，而是将重心放在提供稳定、高效的音频流媒体服务上。对于追求简单易用的用户来说，这款工具能够很好地满足日常音乐播放需求。关于更细致的播放控制和界面交互细节，建议用户通过实际体验来探索，因为这些都属于直观的基础功能范畴。