在飞牛os上使用docker安装navidrome

svendog
1
2025-05-22

一、应用商店版的局限性

飞牛OS应用中心虽已上架Navidrome应用,但体验下来,诸多不便之处凸显:

  1. 音乐目录设定僵化 :仅安装时能设音乐文件夹,后续修改得管理员权限编辑配置文件,繁琐且对普通用户不友好。

  2. 版本更新滞后 :现版本老旧,错失诸多新特性,像WAV音频标签支持、多艺术家支持以及更丰富的音乐标签等均缺席。

  3. 管理操作不便捷 :配置修改、数据库备份等操作流程复杂,缺乏直观友好的界面与简便步骤。

二、Docker 部署的卓越优势

借助 Docker 管理器安装 Navidrome,优势尽显:

  1. 轻松获取最新版 :可直接安装最新版 Navidrome,第一时间畅享新功能、新特性。

  2. 管理高效便捷 :极大地简化配置修改、数据库备份等管理操作,提升使用效率,降低操作难度。

三、迁移与部署关键提示

  1. 迁移前备份数据库 :使用应用商店版的用户,迁移前务必备份数据库文件 /vol1/@appdata/navidrome/navidrome.db ,以防账号和歌单数据丢失。

  2. 部署时暂勿启动 :部署过程中,先别勾选立即启动选项。

四、Docker 部署详尽指南

  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  # 音乐路径
  1. 创建配置文件 :打开新建的 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 。

动物装饰