chaslllll/navidrome

魔改网盘路径替换镜像

镜像概述

该镜像为魔改版本，核心功能是在播放过程中，将应用原本读取的本地路径替换为用户本地挂载的网盘路径，适用于需要访问网盘中媒体文件（如音乐）的场景，通过简单配置即可实现本地路径与网盘路径的映射。

核心功能与特性

• 路径替换功能：支持在播放时自动将指定本地路径替换为本地挂载的网盘路径
• 配置简单：通过应用配置文件即可启用和设置路径映射关系
• 兼容性：适用于需要访问网盘中媒体文件的应用场景

使用场景

• 需要通过应用访问网盘中存储的音乐等媒体文件
• 希望保持应用原有配置逻辑，仅替换实际文件读取路径
• 本地存储空间不足，需利用网盘存储媒体文件的场景

使用方法与配置说明

前置条件

1. 已将网盘本地挂载到服务器/设备的指定路径（如/mnt/cloud-drive）
2. 已获取应用配置文件（如navidrome.toml）

配置步骤

1. 编辑应用配置文件（以navidrome.toml为例），添加以下配置项：

   toml
   # 启用路径覆盖功能
   EnablePathOverride = true
   
   # 配置路径映射关系：左侧为应用原本地路径，右侧为本地挂载的网盘路径
   [PathOverride]
   "/music" = "/网盘映射路径"  # 示例："/music" = "/mnt/cloud-drive/music"
   

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name navidrome-mod \
  -p 4533:4533 \
  -v /path/to/navidrome.toml:/app/navidrome.toml \  # 挂载配置文件
  -v /网盘映射路径:/网盘映射路径 \  # 挂载本地网盘路径（需与配置文件中一致）
  your-image-name:tag

配置说明

• EnablePathOverride：布尔值，设为true启用路径替换功能
• [PathOverride]：路径映射配置段，键为应用原本地路径（如"/music"），值为本地挂载的网盘路径（如"/mnt/cloud-drive/music"）

注意事项

• 确保本地网盘路径已正确挂载且应用容器有权限访问
• 路径映射中的原路径和目标路径需使用绝对路径
• 修改配置文件后需重启容器使配置生效