BlackCandy音乐服务器媒体文件挂载配置指南

在部署BlackCandy音乐服务器时，正确配置媒体文件路径是确保音乐库正常工作的关键步骤。本文将详细介绍如何为BlackCandy设置媒体文件路径，特别是使用Docker容器部署时的注意事项。

媒体路径配置原理

BlackCandy作为一款自托管音乐服务器，需要访问存储在服务器上的音乐文件。当系统报告"Media path does not exist"或"Media path is unreadable"错误时，通常意味着应用程序无法访问指定的目录路径。

Docker环境下的特殊配置

使用Docker部署时，容器内的文件系统与宿主机是隔离的。这意味着即使宿主机上存在/home/shash29/server/music/目录，容器内部也无法直接访问这个路径。必须通过Docker的卷挂载(volume mount)机制将宿主机的目录映射到容器内部。

正确配置步骤

1. 确定宿主机音乐目录：首先确认音乐文件在宿主机上的实际存储位置，例如/home/user/music

2. 修改Docker运行命令：在启动容器时添加-v参数进行目录挂载

3. 设置容器内路径：将宿主机的音乐目录挂载到容器内的某个路径，例如/music

4. 配置BlackCandy：在BlackCandy的设置界面中，使用容器内部的挂载路径作为媒体路径

实际配置示例

假设宿主机音乐存储在/home/user/music，启动Docker容器时应使用类似以下命令：

docker run -v /home/user/music:/music [其他参数] blackcandy

然后在BlackCandy的媒体路径设置中填写容器内的路径/music。

权限问题排查

如果配置正确路径后仍遇到权限问题，需要检查：

1. 宿主机目录的读写权限
2. Docker容器运行用户的权限
3. 挂载目录的SELinux上下文(如果使用SELinux系统)

最佳实践建议

1. 为音乐文件创建专用目录，避免使用用户主目录
2. 设置适当的目录权限(建议755)
3. 在Docker Compose文件中固化挂载配置
4. 定期检查挂载状态是否正常

通过以上配置，BlackCandy音乐服务器就能正确访问和管理您的音乐文件库了。