威联通NAS通过 Docker Compose 部署Emby


1、必备条件

  • 威联通 NAS(需 x86 架构,如 TS-453D、TS-673A 等,ARM 架构需选择对应镜像)​
  • 已安装 Container Station(Docker 环境,通过 QTS 应用中心搜索安装)​
  • 网络环境:NAS 与终端设备在同一局域网,确保 8096/8920 端口未被占用​
  • 存储规划:预留至少 10GB 空间用于 Emby 配置文件和缓存

2、关键概念说明

  • 持久化存储:Emby 的配置(用户数据、媒体库设置)需挂载到 NAS 本地目录,避免容器删除后数据丢失​
  • 权限匹配:威联通默认用户 UID 为 0、GID 为 0(admin 用户),需在容器中指定对应参数避免权限错误​
  • 硬件转码:Intel 处理器需开启核显直通(/dev/dri 设备映射),提升视频转码性能​
  • 网络模式:推荐使用 bridge 模式(端口映射),兼容性更强;host 模式可直接使用 NASIP 访问

3、目录规划

通过威联通 File Station 创建以下目录结构,确保路径可访问:

/share/Container/  # 容器默认存储目录​
└── emby/​
    ├── config/    # 配置文件目录(必须)​
    ├── cache/     # 缓存目录(可选,提升加载速度)​
    └── docker-compose.yml  # 编排配置文件
YAML

同时准备媒体文件目录(示例):​

电影:/share/Media/Movies​
电视剧:/share/Media/TVShows​
音乐:/share/Media/Music
YAML

4、开始部署

打开Container Station,创建应用程序,复制粘贴以下代码(根据自己情况修改文件路径)

version: "2.3"
services:
  emby:
    image: emby/embyserver:latest
    container_name: Emby
    network_mode: host # Enable DLNA and Wake-on-Lan
    environment:
      - UID=0 # The UID to run emby as (default: 2)
      - GID=0 # The GID to run emby as (default 2)
      - GIDLIST=0 # A comma-separated list of additional GIDs to run emby as (default: 2)
    volumes:
      - /share/Container/Emby:/config         # 配置文件持久化(必须挂载)
      - /share/Container/emby/cache:/cache    # 缓存目录(可选,建议挂载)
      - /share/Multimedia/strm:/mnt/share1    # 媒体库目录(根据实际路径修改,可添加多个)
    ports:
      - 8096:8096 # HTTP port
      - 8920:8920 # HTTPS port
    restart: on-failure
YAML

配置参数说明

  • PUID/PGID 获取:通过 SSH 连接 NAS,执行id admin命令,输出中 uid=0 (admin)、gid=0 (users) 即为对应值​
  • 媒体目录映射:左侧为 NAS 实际路径,右侧为容器内路径(需与后续 Emby 设置一致)​
  • 硬件转码:若 NAS 无 Intel 核显(如 AMD 处理器),删除devices节点;ARM 架构(如 TS-231P)需使用emby/embyserver:arm64v8-latest镜像

5、 访问 Web 界面​

  • 打开浏览器,输入http://NAS_IP:8096(NAS_IP 为威联通局域网 IP,如 192.168.1.100)​
  • 首次访问将进入初始化向导,按以下步骤配置:​

6、初始化步骤​

  1. 语言选择:选择「中文(简体)」,点击「下一步」​
  2. 创建管理员账户:设置用户名和密码(用于登录 Emby 管理界面)​
  3. 添加媒体库:​
  • 点击「添加媒体库」→ 选择类型(如电影)→ 点击「浏览」​
  • 选择容器内媒体路径(如/media/movies,对应 NAS 的/share/Media/Movies)​
  • 元数据语言选择「中文」,勾选「自动下载图片和元数据」,点击「确定」​
  • 重复添加电视剧、音乐等媒体库​
  1. 远程访问设置:默认开启局域网访问,如需外网访问可后续配置端口映射(路由器转发 8096 端口)
  2. 完成设置:点击「完成」,Emby 将开始扫描媒体文件(时间取决于文件数量)

声明:麦子花开|版权所有,违者必究|如未注明,均为原创|本网站采用BY-NC-SA协议进行授权

转载:转载请注明原文链接 - 威联通NAS通过 Docker Compose 部署Emby


休对故人思故国,且将新火试新茶。诗酒趁年华!