nexus/wiki/entities/Navidrome.md

title, type, aliases, tags

title	type	aliases	tags
Navidrome	entity		music media-server self-hosted open-source

Navidrome

Basic Info

• Type: Entity / Product / Open-source Project
• Description: 开源音乐流媒体服务器，支持 Subsonic API 协议，可通过网页端或移动客户端访问个人音乐库
• Author: Deluan
• Repository: github.com/navidrome/navidrome
• License: GPL v3

Aliases

• Navidrome
• deluan/navidrome（Docker 镜像名）

Key Capabilities

1. Subsonic API 兼容 — 与 Subsonic 协议兼容的客户端均可使用（Jellyfin/Subsonic 客户端通用）
2. 网页播放器 — 内置响应式 Web UI，支持播放列表、专辑浏览、搜索
3. 移动端支持 — 支持 DSub、Substreamer、Avanté 等 Subsonic 客户端
4. 转码支持 — 按客户端网络情况自动转码为合适码率，节省带宽
5. 元数据扫描 — 自动从音乐文件中读取 ID3 标签、封面信息
6. 轻量部署 — 单 Docker 容器运行，最低 512MB 内存即可运行

Configuration Highlights (Docker Compose)

image: deluan/navidrome:latest
user: "1026:100"          # 以非 root 用户运行
ports:
  - "4533:4533"
volumes:
  - /volume1/music:/music:ro   # 只读挂载音乐目录
  - /volume1/docker/navidrome/data:/data  # 数据目录
environment:
  - ND_LOGLEVEL=info
  - ND_ENABLETRANSCODINGCONFIG=true   # 启用转码配置 UI
  - ND_AUTOTRANSCODEDOWNLOAD=true     # 启用自动转码下载
  - ND_TRANSCODINGCACHESIZE=200MB     # 转码缓存上限 200MB

Key Design Decisions

• 只读音乐挂载（:ro） — 防止容器误操作修改原始音乐文件
• 非 root 用户运行 — 提升容器安全性，UID/GID 与宿主机用户对应
• 转码缓存限制 — 200MB 上限防止磁盘空间被缓存占满
• 端口 4533 — Navidrome 默认端口，局域网访问地址：http://<host>:4533

Related Entities

• Jellyfin — 视频媒体服务器，架构类似但服务视频内容
• 群晖 NAS — Navidrome 常见部署环境，音乐文件的存储位置
• Docker-Image — Navidrome 的部署方式
• Docker Compose — Navidrome 的配置管理方式
• Deluan/Navidrome — 官方 Docker 镜像发布者

Source

• 用docker中安装navidrome — Navidrome Docker 部署实战笔记