当前位置：首页 > news >正文

Navidrome（docker-compose） + Tempo + Feishin 完整部署文档（DeepSeek）

news 2026/6/3 23:17:43

Navidrome + Tempo + Feishin 完整部署文档

这份文档整理了从零开始部署私人音乐流媒体服务的完整流程，包括服务端（Navidrome）和两个客户端（Android 的 Tempo、桌面端的 Feishin）的配置方法。

一、整体架构说明

这是一个典型的自托管音乐流媒体方案：

Navidrome：核心音乐服务器，负责管理音乐库、提供流媒体服务（支持 Subsonic API）
Tempo：Android 客户端，免费开源，连接 Navidrome 听歌
Feishin：桌面端播放器（支持 Windows/Mac/Linux），界面现代，功能丰富

工作流程：音乐文件存放在指定目录 → Navidrome 扫描并建立索引 → 客户端（Tempo/Feishin）通过 API 连接 Navidrome 进行播放

二、部署 Navidrome 音乐服务器（Docker 方式）

2.1 创建项目目录

mkdir -p ~/navidrome/{data,music}
cd ~/navidrome

data 目录：存放数据库、缓存等运行时数据
music 目录：存放你的音乐文件

2.2 准备音乐文件

如果你想把音乐放在 Windows 分区（如 E 盘），创建软链接：

ln -s /mnt/e/MyMusic ~/navidrome/music/MyMusic

或者直接在 docker-compose.yml 中挂载 Windows 文件夹（见下方配置注释）。

2.3 创建 docker-compose.yml

nano docker-compose.yml

粘贴以下内容：

version: '3.8'services:navidrome:image: deluan/navidrome:latestcontainer_name: navidromerestart: unless-stoppedports:- "4533:4533"environment:# 基础配置- ND_SCANINTERVAL=5m                    # 扫描间隔- ND_LOGLEVEL=info                      # 日志级别- ND_SESSIONTIMEOUT=24h                 # 会话超时时间# 语言和地区设置（中文界面）- ND_LANGUAGE=zh-Hans                   # 简体中文界面- ND_TZ=Asia/Shanghai                   # 时区：上海# UI界面配置- ND_UIWELCOMEMESSAGE=欢迎使用私人音乐库  # 欢迎语- ND_UIWELCOMEMESSAGE=欢迎来到你的音乐空间  # 登录页欢迎信息# 转码和流媒体配置- ND_ENABLETRANSCODINGCONFIG=true       # 允许配置转码- ND_TRANSCODINGCACHESIZE=200MB         # 转码缓存大小# 封面图片尺寸- ND_COVERARTPRIORITY=cover.jpg,folder.jpg,front.jpg,embedded,*.jpg  # 封面优先级# 多用户支持（可选，如果需要注册功能）- ND_ENABLECLIENTSFORLASTFM=false       # 关闭Last.fm（国内用不上）# 性能优化（根据你的音乐数量调整）- ND_SEARCHFULLSTRING=true              # 搜索时全文匹配- ND_AUTOPLAYLISTS=true                 # 自动生成智能播放列表volumes:- ./data:/data- ./music:/music:ro# 如需直接挂载 Windows 文件夹（取消注释并修改路径）# - /mnt/e/MyMusic:/music/MyMusic:ronetworks:- music-networknetworks:music-network:driver: bridge

2.4 启动服务

docker-compose up -d# 查看启动日志
docker-compose logs -f# 查看运行状态
docker-compose ps

2.5 初始化配置

浏览器访问 http://你的WSL_IP地址:4533
- 查看 WSL IP：ip addr show eth0 | grep inet
首次访问会进入注册页面，填写用户名和密码创建管理员账户
登录后，点击右上角头像 → Personal → Language，选择 简体中文

2.6 常用维护命令

# 查看日志
docker-compose logs -f navidrome# 重启服务
docker-compose restart# 停止服务
docker-compose down# 升级到最新版本
docker-compose down
docker pull deluan/navidrome:latest
docker-compose up -d

三、配置 Android 客户端：Tempo

Tempo 是一款免费开源的 Android Subsonic 客户端，专为连接 Navidrome 这类服务器设计。

3.1 安装 Tempo

方式一：F-Droid 商店（推荐）

安装 F-Droid 应用商店（ https://f-droid.org ）
在 F-Droid 中搜索 Tempo
点击安装

方式二：直接下载 APK

GitHub Releases：https://github.com/eddyizm/tempo/releases

3.2 配置连接

打开 Tempo 应用
点击 Add Server（或首次启动时的服务器配置向导）
填写连接信息：
- Server URL：http://你的WSL_IP地址:4533
- Username：你创建的 Navidrome 用户名
- Password：对应的密码
点击 Save 或 Test Connection 验证
连接成功后，Tempo 会自动同步你的音乐库

3.3 关键功能说明

离线下载：长按专辑或歌单，选择下载到本地
Last.fm 记录：可选，在设置中开启 Scrobbling
转码设置：在网络不佳时可开启转码降低码率

四、配置桌面客户端：Feishin

Feishin 是一款现代的自托管音乐播放器，支持 Navidrome 和 Jellyfin，界面类似 Spotify。

4.1 安装方式

Windows：

winget install --id=jeffvli.Feishin -e

或从 GitHub Releases 下载 exe 安装包：https://github.com/jeffvli/feishin/releases

macOS：下载 .dmg 文件安装

Linux：下载 AppImage 或 deb 包

4.2 配置连接

打开 Feishin 应用
点击菜单按钮（左上角三条横线）→ Manage Servers
点击 Add Server
填写信息：
- Server URL：http://你的WSL_IP地址:4533
- Username：Navidrome 用户名
- Password：Navidrome 密码
点击 Save
返回主界面即可看到音乐库

4.3 Feishin 特色功能

MPV 播放后端：高品质音频输出，Windows 下支持 WASAPI 独占模式
智能播放列表编辑：在 Navidrome 中创建动态播放列表
歌词支持：可显示同步或非同步歌词
Last.fm Scrobbling：自动记录播放记录

五、客户端对比总结

客户端	平台	价格	特点	适用场景
Tempo	Android	免费开源	轻量、Material Design、支持离线下载	手机端日常听歌
Feishin	Win/Mac/Linux	免费开源	界面现代、MPV后端、WASAPI独占	桌面端高品质欣赏
网页端	全平台	免费	浏览器直接访问 Navidrome	临时使用、管理设置