飞牛 NAS、群晖如何部署 Navidrome 或 Jellyfin，并连接散帅播放器？

OpenSubsonic、Navidrome 和 Jellyfin 是什么关系？

所以，正确流程不是“安装 OpenSubsonic”，而是安装兼容服务器，然后让散帅按对应服务器类型连接。不同服务器对扩展能力的实现可能不同，兼容某个 API 不代表每一项扩展都完全一致。

部署前需要准备什么？

1. 确认处理器架构

   Navidrome 官方镜像覆盖常见 amd64 与 arm 架构；Jellyfin 也提供多架构官方镜像。老旧或特殊架构 NAS 应先核对镜像支持。

2. 准备两个目录

   一个持久化目录保存数据库、配置和缓存；一个音乐目录保存音频文件。音乐目录建议先以只读方式挂载。

3. 确认文件权限

   容器使用的 UID:GID 必须能读取音乐目录并写入配置目录。`1000:1000` 只是示例，不应不加核对地复制。

4. 保留固定局域网地址

   可在路由器为 NAS 保留 DHCP 地址，避免 NAS IP 改变后客户端失联。

5. 先做局域网部署

   确认扫描和播放正常后，再考虑 HTTPS、VPN 或反向代理。不要一开始就把服务端口直接暴露到公网。

如何用 Docker Compose 部署 Navidrome？

下面示例以当前校对时的稳定版本为基线。把两个以 `/YOUR_` 开头的宿主机路径替换成 NAS 上的真实绝对路径，并把 `1000:1000` 改成有权访问这些目录的用户与用户组。

services:
  navidrome:
    image: deluan/navidrome:0.61.2
    container_name: navidrome
    user: "1000:1000"
    ports:
      - "4533:4533"
    restart: unless-stopped
    volumes:
      - /YOUR_APP_DATA/navidrome:/data
      - /YOUR_MUSIC:/music:ro

创建项目并启动后，在同一局域网的浏览器打开 http://NAS-IP:4533。首次打开时按页面提示创建管理员账号，等待音乐扫描完成。Navidrome 容器内的 `/data` 保存数据库和缓存，`/music` 是只读音乐库。

官方资料：Navidrome Docker 安装、Navidrome Overview、OpenSubsonic API Reference。

如何用 Docker Compose 部署 Jellyfin？

如果你希望用同一服务器管理音乐和视频，可以选择 Jellyfin。示例只映射散帅连接所需的 8096/TCP；7359/UDP 用于局域网自动发现，不是手动填写服务器地址的必要条件。

services:
  jellyfin:
    image: jellyfin/jellyfin:10.11
    container_name: jellyfin
    user: "1000:1000"
    ports:
      - "8096:8096/tcp"
    restart: unless-stopped
    volumes:
      - /YOUR_APP_DATA/jellyfin/config:/config
      - /YOUR_APP_DATA/jellyfin/cache:/cache
      - /YOUR_MUSIC:/media:ro

启动后打开 http://NAS-IP:8096，完成初始化向导，创建用户，并添加“音乐”媒体库。选择文件夹时使用容器内部路径 /media，不要填写宿主机上的 `/YOUR_MUSIC`。

官方镜像支持固定版本、次版本和 `latest` 标签。示例固定在 10.11 次版本线以降低意外跨版本升级风险；升级前应备份 `/config`，并阅读当前版本说明。

官方资料：Jellyfin Container、Jellyfin Quick Start。

飞牛、群晖和其他主流 NAS 分别从哪里部署？

无论使用哪种界面，本质上都要得到同样四项结果：正确镜像、持久化配置目录、只读音乐目录、可从局域网访问的端口。不要照抄别人的 `/volume1`、`/vol1` 或 `/mnt/user` 路径；它们必须换成你自己的目录。

平台资料：飞牛开发者 Docker 文档、Synology Container Manager Project、QNAP Container Station、TrueNAS Apps、Unraid Docker Overview。

服务器部署完成后，如何连接散帅播放器？

1. 先用浏览器验证服务器

   iPhone 与 NAS 连同一 Wi‑Fi，确认 Safari 能打开 Navidrome 或 Jellyfin 登录页。浏览器都打不开时，先不要排查散帅。

2. 允许本地网络访问

   首次访问局域网服务时，允许散帅使用 iOS 本地网络权限。

3. 选择正确的服务器类型

   Navidrome 选择 Navidrome / OpenSubsonic 兼容类型；Jellyfin 选择 Jellyfin。具体入口文字以当前 App 版本为准。

4. 填写完整基础地址

   Navidrome 示例：http://192.168.1.20:4533；Jellyfin 示例：http://192.168.1.20:8096。如果反向代理使用子路径，地址也要包含子路径。

5. 填写服务器账号

   使用在 Navidrome 或 Jellyfin 中创建的账号，不是 NAS 系统管理员账号。建议为日常播放创建权限较小的独立用户。

6. 连接并等待首次同步

   大型音乐库第一次读取专辑、艺人和封面需要时间。先用一张已知专辑测试浏览与播放，再处理远程访问。

如何从外网安全连接 NAS 音乐服务器？

优先使用可信 VPN 回到家庭网络，或使用带有效证书的 HTTPS 反向代理。不建议把 4533、8096 等明文 HTTP 端口直接映射到互联网。

• 使用独立域名或明确的子路径，并在散帅里填写最终可访问地址；
• 使用受信任证书。自签名证书常导致移动客户端兼容问题；
• 为账号设置强密码，及时更新 NAS、容器镜像和反向代理；
• Navidrome 默认可以直接放在反向代理后；如果代理另做登录，不能误拦客户端需要的 /rest/* API；
• Jellyfin 反向代理需要正确传递请求头；使用子路径时，客户端地址必须包含 Base URL；
• 不要在公开日志、截图或支持邮件中暴露密码、API Key、令牌和完整私人域名配置。

安全资料：Navidrome Externalized Authentication、Jellyfin Networking、Jellyfin Reverse Proxy。

连接失败时按什么顺序排查？

如果仍无法定位，联系 [email protected] 时请提供 App 版本、iOS 版本、NAS 系统、服务器类型、局域网或外网场景、脱敏后的地址结构和错误提示。不要发送密码、令牌或未脱敏日志。

音乐、账号和播放数据会发到哪里？

散帅会直接连接你填写的 NAS 或音乐服务器，Himhuu 不作为音乐流量的中转站，也不会把个人音乐库、服务器账号或播放记录上传给 Himhuu。服务器地址和连接设置保存在设备上，凭据或访问令牌保存在系统钥匙串。

但这不等于所有使用过程都“完全不联网”：你选择的 Navidrome、Jellyfin、反向代理、DNS 或远程访问服务可能处理连接日志；当服务器缺少歌词或封面并触发散帅的在线查询时，第三方服务可能收到歌曲名、艺人、专辑名或时长。完整边界以散帅播放器隐私政策为准。

常见问题