Docker 版本 Navidrome 安装指引
应用商店版本缺点
飞牛OS应用中心中已经有了 Navidrome 应用，但应用商店版本的 Navidrome 存在一些不太方便的地方，如：
-
音乐目录锁定
只能在安装时设置音乐文件夹，后期修改需管理员权限编辑配置文件
-
版本滞后问题
当前版本较旧，缺少以下新特性，如：
- WAV 音频标签支持
- 多艺术家支持
- 更多的音乐标签
-
管理不便
配置修改、数据库备份等操作不够友好
Docker 部署优势
通过 Docker 管理器可直接安装最新版 Navidrome，享受新版本特性、更方便管理。
重要提示
若已使用应用商店版本，迁移前请备份数据库文件，如：
/vol1/@appdata/navidrome/navidrome.db
避免账号和歌单数据丢失
注：先不要勾选立即启动
部署指南
1. navidrome.toml 文件内容：
services:
navidrome:
image: de**/navidrome:latest
user: 1000:1000 # 启动权限
ports:
- "4533:4533"
restart: unless-stopped
environment:
# 使用配置文件，其实最新版默认会读取这个路径，ND_CONFIGFILE 可以删除
ND_CONFIGFILE: "/data/navidrome.toml"
volumes:
- /vol1/1000/Docker/Navidrome:/data # 映射 Navidrome /data/ 路径（缓存、数据库、配置文件，如果不想把缓存映射出来，请手动映射单个文件）
- /vol1/1000/Music:/music:ro # 音乐路径
2. 创建配置文件
打开刚刚新建的 Navidrome 文件夹，如上面的 /vol1/1000/Docker/Navidrome，新建一个 navidrome.toml 配置文件，修改和输入以下内容：
# This is just an example! Please see available options to customize Navidrome for your needs at
# https://www.navidrome.org/docs/usage/configuration-options/#available-options
# 默认语言相关
# Web 端默认语言
DefaultLanguage = "zh-Hans"
# 搜索全字符串（适用于单词不以空格分隔的语言，如中文）
SearchFullString = "true"
# LastFM 相关（歌手经历、类似歌手、专辑封面、热门歌曲、播放记录等信息）
# 忘记什么版本开始，内置 LastFM API 已被禁用，你可能需要自行获取
LastFM.Language= "zh"
# LastFM.ApiKey = "xxx"
# LastFM.Secret = "xxx"
# Spotify 相关（歌手照片）
# 需要自行获取
# Spotify.ID = "xxx"
# Spotify.Secret = "xxx"
# 歌曲分享功能
# EnableSharing = "true"
# 扫描间隔（0 为禁用，0.55 版本后使用 Cron 语法和Scanner.Schedule）
Scanner.Schedule = "0"
# 图像缓存最大大小
ImageCacheSize = "2GB"
# 转码缓存最大大小
TranscodingCacheSize = "1024MB"
# 日志等级
LogLevel = "error"
然后就可以启动 navidrome，享受你的音乐之旅了
注：
- 转码功能不需要额外开启，飞牛默认已经安装了
/usr/bin/ffmpeg ，ND_ENABLETRANSCODINGCONFIG 配置控制的是 WEBUI 中的默认转码设置，但这通常由客户端指定，不需要额外设置
- 客户端推荐：
PC：音流/Feishin
安卓：音流/Symfonium
- 如果需要更多个性化设置，请参考 https://www.navidrome.org/docs/usage/configuration-options/#available-options，并在修改
/vol1/1000/Docker/Navidrome/navidrome.toml 后重启容器
- 歌手照片可以通过Spotify API 或者歌手同名文件夹下的 artist.*. 获取；歌手信息只能通过 LastFM API 获取；歌词和年份等需要手动或 music-tags-web 刮削，或音流的歌词 API
2025-4-26 11:42:03
