Black Candy音乐服务器：本地音乐库同步指南

Black Candy作为一款开源的音乐服务器软件，其核心功能之一就是能够将用户本地的音乐文件整合到在线播放系统中。本文将详细介绍如何通过设置媒体路径来实现音乐库的同步管理。

工作原理

Black Candy采用目录同步机制来管理音乐文件。系统通过扫描指定目录下的音频文件，自动将其导入服务器数据库，并建立完整的音乐元信息索引。这种设计既保证了数据安全性（原始文件不会被修改），又实现了高效的媒体管理。

配置步骤

基础配置

1. 设置媒体路径：

   • 登录系统管理后台
   • 导航至"设置"→"媒体路径"
   • 输入本地存储音乐的绝对路径（如：/home/user/Music或C:\MyMusic）

2. 执行同步操作：

   • 保存路径设置后
   • 点击"同步"按钮触发扫描过程
   • 系统将自动识别支持的音频格式（MP3、FLAC等）

Docker环境特殊配置

在容器化部署时，需要特别注意：

1. 必须通过volume挂载将主机音乐目录映射到容器内
2. 媒体路径应设置为容器内部的映射路径
3. 确保容器用户对目录有读取权限

技术细节

• 支持的音乐格式包括但不限于：MP3、AAC、FLAC、ALAC、OGG等
• 系统会自动解析ID3标签等元数据
• 扫描过程会建立高效的索引结构，支持快速检索
• 文件变动监控（可选）可实现自动更新音乐库

最佳实践

1. 建议使用专用目录存放音乐文件
2. 保持规范的目录结构有助于管理
3. 定期执行手动同步以确保数据库更新
4. 大量文件初次同步可能需要较长时间

注意事项

• 当前版本暂不支持网页端直接上传
• 修改媒体路径后必须重新同步
• 网络存储需要确保稳定连接
• 文件权限问题是最常见的同步失败原因

通过以上配置，用户即可将个人音乐收藏完美整合到Black Candy系统中，享受个性化的在线音乐体验。