Emby 中文文档 下载 App

Emby NAS 部署指南 — 群晖、威联通、TrueNAS 全家桶教程

为什么用 NAS 跑 Emby

NAS(网络附加存储)是跑 Emby Server 的最佳载体:

Emby 官方或社区支持的 NAS 品牌超过 15 家,下面挑主流的讲。

群晖 Synology

群晖是国内市场占有率最高的 NAS 品牌,Emby 的支持也最成熟。

套件安装(最简单)

群晖官方或 Emby 官方提供 .spk 套件文件:

  1. 进入 DSM 控制面板 → 套件中心 → 手动安装
  2. 根据你的 DSM 版本(DSM 6 / DSM 7 / DSM 7.2+)和 CPU 架构(ARMv7 / ARMv8 / x86)下载对应的 .spk 文件
  3. 上传套件文件,点"安装"
  4. 等 1 分钟左右装完,在 DSM 主菜单里打开 Emby
  5. 浏览器会自动跳到 群晖IP:8096,跑首次启动向导

套件方式的优点是简单、DSM 可以管理启停;缺点是版本可能比官方 Docker 镜像慢一些。

Docker 方式(推荐进阶用户)

群晖的 Container Manager(原 Docker)里拉 Emby 镜像:

docker run -d \
  --name emby \
  --net=host \
  -e PUID=1024 \
  -e PGID=100 \
  -e TZ=Asia/Shanghai \
  -v /volume1/docker/emby/config:/config \
  -v /volume1/video:/data/video \
  -v /volume1/music:/data/music \
  -v /volume1/photo:/data/photo \
  emby/embyserver:latest

关键参数说明:

参数说明
--net=host让容器直接用宿主机网络栈,端口不用单独映射。硬件转码需要这个。
-v /volume1/...把 NAS 上的媒体目录映射到容器里。把你群晖的实际媒体路径写进去。
PUID/PGID用 id 命令查一下群晖上你想让 Emby 以哪个用户身份跑,填对应的 uid/gid。
TZ时区,填 Asia/Shanghai。

群晖硬件转码

DSM 7.2+ 加了"高级媒体扩展"(Advanced Media Extensions),Docker 方式下 Quick Sync 能正常工作。套件方式直接支持,不需要额外配置。

威联通 QNAP

威联通 QTS 的 App Center 里有官方 Emby 应用,安装方式和群晖套件类似:

  1. 进入 QTS App Center
  2. 搜索 Emby,点"安装"
  3. 安装完成后在主菜单启动
  4. 浏览器访问 威联通IP:8096,跑向导

威联通也支持 Container Station 里跑 Docker 版 Emby,命令行参数和群晖类似。

TrueNAS / FreeNAS

TrueNAS 提供两种安装方式:

Jail 插件方式(TrueNAS SCALE)

  1. 进入 Plugins → Available
  2. 搜索 Emby,安装
  3. 配置存储池映射到插件的媒体目录
  4. 访问 Emby 地址跑向导

Docker 方式(TrueNAS Scale)

TrueNAS Scale 基于 Debian,直接拉 Emby Docker 镜像:

docker run -d \
  --name emby \
  --device=/dev/dri/renderD128 \
  --device=/dev/dri/card0 \
  -e UID=1000 \
  -e GID=1000 \
  -e TZ=Asia/Shanghai \
  -v /mnt/tank/appdata/emby/config:/config \
  -v /mnt/tank/media:/media \
  -p 8096:8096 \
  emby/embyserver:latest

注意 --device=/dev/dri/... 这两行是把核显设备透传给容器,硬件转码必需。没有核显的 NAS 可以去掉这两行,但就只能软解了。

unRAID

unRAID 社区维护了 Emby 的 Docker 模板,在 Community Applications 里搜 Emby 一键安装,或者手动 docker run:

docker run -d \
  --name emby \
  --runtime=nvidia \
  --net=host \
  -e TZ=Asia/Shanghai \
  -v /mnt/user/appdata/emby:/config \
  -v /mnt/user/Movies:/data/movies \
  -v /mnt/user/TV:/data/tvshows \
  emby/embyserver:latest

OMV(Open Media Vault)

OMV 本身没有 Emby 插件管理器,用 Docker 或直接 apt 装:

# 先添加 Emby 官方仓库
wget -O - Emby 官方 apt GPG key | apt-key add -
echo "deb Emby 官方 apt 仓库$(lsb_release -cs) main" > /etc/apt/sources.list.d/emby.list
apt update && apt install emby-server

其他 NAS

NAS 部署的通用注意事项

  1. 权限问题:Emby Server 进程需要有读取媒体目录的权限。Docker 方式下用 PUID/PGID 指定,套件方式下 DSM/QTS 会自动处理。
  2. 网络:建议给 NAS 分配固定内网 IP,不然路由器重启后 IP 变了,客户端连不上。
  3. 硬件转码:不管什么 NAS,硬件转码都需要 CPU 带核显(Intel 11 代以前基本都有,AMD 看型号)。在 Docker 里要加 --device=/dev/dri/... 透传设备。
  4. 数据备份:至少定期备份 Emby 的 config 目录(配置、数据库、用户),媒体文件靠 NAS RAID 保护。
  5. 首次启动向导:和 Windows 安装一样,跑完向导配置好管理员账号就行。