---
title: "用Docker中安装Navidrome"
type: source
tags: [docker, music, navidrome]
date: 2026-04-14
---

## Source File
- [[raw/Home Office/用Docker中安装Navidrome.md]]

## Summary（用中文描述）
- 核心主题：通过 Docker Compose 在群晖 NAS 上部署 Navidrome 开源音乐流媒体服务器
- 问题域：家庭音乐库、个人媒体服务、NAS 多媒体服务
- 方法/机制：使用 deluan/navidrome:latest 官方镜像，通过 Docker Compose YAML 配置服务；以只读方式挂载 /volume1/music 音乐目录，/volume1/docker/navidrome/data 存储应用数据；配置 ND_LOGLEVEL=info 详细日志、ND_ENABLETRANSCODINGCONFIG 启用转码配置界面、ND_AUTOTRANSCODEDOWNLOAD 自动根据客户端需求转码下载、ND_TRANSCODINGCACHESIZE=200MB 限制转码缓存大小
- 结论/价值：构建家庭音乐流媒体服务，支持多客户端自适应转码播放，实现"音乐文件存储 → 流媒体播放"完整工作流

## Key Claims（用中文描述）
- Navidrome 官方镜像 deluan/navidrome:latest 提供开箱即用的音乐服务器功能
- 群晖 NAS 使用 `user: "1026:100"` 固定 UID:GID，可避免容器内文件权限问题
- 音乐目录 `/volume1/music:/music:ro` 以只读（:ro）方式挂载，确保原始音乐文件安全不被篡改
- 转码缓存限制为 200MB，保护 NAS 磁盘空间
- ND_AUTOTRANSCODEDOWNLOAD=true 使 Navidrome 能根据客户端能力自动转码并下载

## Key Quotes
> "开启详细日志，便于排查流媒体传输问题" — 日志级别设置为 info 是排查 Docker 容器内 Navidrome 流媒体传输问题的基础
> "限制转码缓存大小，保护磁盘空间" — ND_TRANSCODINGCACHESIZE=200MB 是 NAS 存储空间管理的重要配置

## Key Concepts
- [[Docker 媒体服务器]]：通过 Docker 容器部署的流媒体服务，Navidrome 和 Jellyfin 均属此类
- [[音乐流媒体]]：通过网络协议（HTTP/WebDAV）向客户端传输音频内容的服务
- [[音频转码]]：将音乐文件转换为客户端支持的格式（Navidrome 在服务端处理）
- [[NAS 多媒体服务]]：在 NAS 设备上运行的多媒体服务器（视频/音乐/照片等）

## Key Entities
- [[Navidrome]]：开源音乐流媒体服务器，支持 Subsonic API，本文部署的目标服务
- [[deluan/navidrome]]：Navidrome 官方 Docker 镜像，由项目维护者 deluan 提供
- [[群晖 NAS]]（Synology NAS）：NAS 设备类型，本文 Navidrome 的宿主机，提供 /volume1/docker 和 /volume1/music 存储路径

## Connections
- [[Jellyfin]] ← 对标竞品 ← [[Navidrome]] — Jellyfin 服务视频，Navidrome 服务音乐，同属家庭媒体中心
- [[用docker安装jellyfin]] ← 共用宿主机 ← [[用docker中安装Navidrome]] — 共享群晖 NAS Docker 环境和存储基础设施
- [[群晖 NAS]] ← 宿主机 ← [[用docker中安装Navidrome]] — NAS 提供 Docker 环境和音乐文件存储
- [[Transmission]] ← 下载端 ← [[Navidrome]]（播放端）— 下载端传输→整理音乐文件→Navidrome 播放
- [[Docker卷]] ← 数据存储 ← [[Navidrome]] — /data 目录持久化配置和缓存

## Contradictions
- 无已知冲突