影音与下载

Emby:群晖部署、媒体库与客户端连接

  • 8 次阅读
  • 0 条评论
文章摘要

Emby 将本地或可访问的媒体文件组织成电影、剧集、音乐等媒体库,并向网页、电视和移动端提供播放服务。服务端负责扫描与权限,客户端是否直接播放仍取决于编码、音轨、字幕和设备能力。

项目介绍

Emby 用于扫描和管理本地媒体库,并向电视、手机及电脑客户端提供播放服务。下文分别列出群晖部署配置、官方最新版、amilys 最新版和 4.8.11 固定版。多个版本共用 8096 端口时不能同时启动,切换前先备份各自的配置目录。

version: '3.8'

services:
  emby:
    image: amilys/embyserver:latest
    container_name: emby
    volumes:
      - /volume1/docker/emby/config:/config
      - /volume1/media:/media    
    privileged: true
    network_mode: host
    ports:
      - "8096:8096"  # Web管理界面
      - "8920:8920"  # HTTPS端口
    restart: unless-stopped
    devices:
      - /dev/dri:/dev/dri
    environment:
      UID: "0"
      GID: "0"
      GLIST: "0"
      GIDLIST: 0,0
      no_proxy: 172.17.0.1,127.0.0.1,localhost
      https_proxy: http://127.0.0.1:20171
      http_proxy: http://127.0.0.1:20171

emby bridge网络模式

version: '3.8'

services:
  emby:
    image: amilys/embyserver:latest
    container_name: emby
    volumes:
      - /volume1/docker/emby/config:/config
      - /volume1/media:/media    
    privileged: true
    network_mode: bridge
    ports:
      - "8096:8096"  # Web管理界面
      - "8920:8920"  # HTTPS端口
    restart: unless-stopped
    devices:
      - /dev/dri:/dev/dri
    environment:
      UID: "0"
      GID: "0"
      GLIST: "0"
      GIDLIST: 0,0
      no_proxy: 172.17.0.1,127.0.0.1,localhost
      https_proxy: http://127.0.0.1:20171
      http_proxy: http://127.0.0.1:20171

补充:部署与使用

配置与操作示例

选择安装版本

三种配置任选一份。它们都使用8096端口,不能同时启动;配置目录分别保存,不能让多个 Emby 实例共用同一份数据库。

方案 镜像 配置目录
官方最新版 emby/embyserver:latest /volume1/docker/emby-official/config
开心版 / amilys 最新版 amilys/embyserver:latest /volume1/docker/emby/config
开心版 / 4.8.11 固定版 amilys/embyserver:4.8.11.0 /volume1/docker/embyTV/config

amilys 是第三方修改发行,功能与更新由其维护者提供,不能当作 Emby 官方版本。latest 是随发布变化的标签;4.8.11.0 是固定旧版本,不代表仍有后续安全更新。核对时该固定标签仅提供 amd64 镜像,ARM 机型不能直接使用。

本页沿用群晖示例的 UID: "0"、GID: "0" 与 GIDLIST: "0",无需另建 UID/GID 环境文件;容器对挂载目录以 root 身份访问。安装目录统一放在 /volume1/docker/,媒体使用 /volume1/media、/volume1/music 和 /volume1/Strm。

官方最新版

先在群晖 SSH 终端执行,或通过 File Station 创建这些文件夹:

sudo mkdir -p /volume1/docker/emby-official/config /volume1/media /volume1/music /volume1/Strm
cd /volume1/docker/emby-official

在这个目录保存 compose.yaml:

services:
  emby:
    image: emby/embyserver:latest
    container_name: emby-official
    network_mode: host
    restart: unless-stopped
    volumes:
      - /volume1/docker/emby-official/config:/config
      - /volume1/media:/media
      - /volume1/music:/music
      - /volume1/Strm:/Strm
      # 已部署网盘挂载、确认宿主机传播设置后,才启用这一行:
      # - /volume1/CloudNAS:/volume1/CloudNAS:rslave
    environment:
      UID: "0"
      GID: "0"
      GIDLIST: "0"
      TZ: Asia/Shanghai
      # 不需要代理时保持注释;示例采用 host 网络。
      # 只有 NAS 本机确实运行代理时,127.0.0.1 才能指向它。
      # 7890 为示例端口,启用前按自己的代理端口修改。
      # http_proxy: http://127.0.0.1:7890
      # https_proxy: http://127.0.0.1:7890
      # no_proxy: localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
    # 有 /dev/dri 的 Intel/AMD 设备可按需取消下面两行注释。
    # 没有该设备的 NAS 保持注释,避免容器启动失败。
    # devices:
    #   - /dev/dri:/dev/dri

开心版:amilys 最新版

先在群晖 SSH 终端执行,或通过 File Station 创建这些文件夹:

sudo mkdir -p /volume1/docker/emby/config /volume1/media /volume1/music /volume1/Strm
cd /volume1/docker/emby

在这个目录保存 compose.yaml:

services:
  emby:
    image: amilys/embyserver:latest
    container_name: emby
    privileged: true
    network_mode: host
    restart: unless-stopped
    volumes:
      - /volume1/docker/emby/config:/config
      - /volume1/media:/media
      - /volume1/music:/music
      - /volume1/Strm:/Strm
      # 已部署网盘挂载、确认宿主机传播设置后,才启用这一行:
      # - /volume1/CloudNAS:/volume1/CloudNAS:rslave
    environment:
      UID: "0"
      GID: "0"
      GIDLIST: "0"
      TZ: Asia/Shanghai
      # 不需要代理时保持注释;示例采用 host 网络。
      # 只有 NAS 本机确实运行代理时,127.0.0.1 才能指向它。
      # 7890 为示例端口,启用前按自己的代理端口修改。
      # http_proxy: http://127.0.0.1:7890
      # https_proxy: http://127.0.0.1:7890
      # no_proxy: localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
    # 有 /dev/dri 的 Intel/AMD 设备可按需取消下面两行注释。
    # 没有该设备的 NAS 保持注释,避免容器启动失败。
    # devices:
    #   - /dev/dri:/dev/dri

开心版:4.8.11 固定版

先在群晖 SSH 终端执行,或通过 File Station 创建这些文件夹:

sudo mkdir -p /volume1/docker/embyTV/config /volume1/media /volume1/music /volume1/Strm
cd /volume1/docker/embyTV

在这个目录保存 compose.yaml:

services:
  emby:
    image: amilys/embyserver:4.8.11.0
    container_name: embytv
    privileged: true
    network_mode: host
    restart: unless-stopped
    volumes:
      - /volume1/docker/embyTV/config:/config
      - /volume1/media:/media
      - /volume1/music:/music
      - /volume1/Strm:/Strm
      # 已部署网盘挂载、确认宿主机传播设置后,才启用这一行:
      # - /volume1/CloudNAS:/volume1/CloudNAS:rslave
    environment:
      UID: "0"
      GID: "0"
      GIDLIST: "0"
      TZ: Asia/Shanghai
      # 不需要代理时保持注释;示例采用 host 网络。
      # 只有 NAS 本机确实运行代理时,127.0.0.1 才能指向它。
      # 7890 为示例端口,启用前按自己的代理端口修改。
      # http_proxy: http://127.0.0.1:7890
      # https_proxy: http://127.0.0.1:7890
      # no_proxy: localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12
    # 有 /dev/dri 的 Intel/AMD 设备可按需取消下面两行注释。
    # 没有该设备的 NAS 保持注释,避免容器启动失败。
    # devices:
    #   - /dev/dri:/dev/dri

启动与首次访问

在所选版本的项目目录运行:

sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100 emby

也可在 Container Manager 新建项目,选择对应目录并上传配置后启动。浏览器访问 http://群晖IP:8096,按页面创建管理员。添加电影、音乐和 STRM 库时,分别选择 /media、/music、/Strm;首次扫描先选一个小目录。

三份配置采用 host 网络,因此不再写 ports 映射。要改用 bridge 网络,需要添加 8096:8096 等实际端口映射;此时代理地址应改为容器能访问的 NAS 局域网地址,不能原样启用 127.0.0.1。

需要硬件转码时,先确认 NAS 存在 /dev/dri、型号和驱动支持,再启用对应映射;官方版的付费功能遵循其许可。网盘挂载与 STRM 是可选扩展,基础安装不依赖它们。

升级与版本切换

从4.8.11升级到新版前停止写入并完整备份配置目录。新版本可能迁移数据库,不能用新版打开后的配置直接降级到4.8.11;恢复应配合当时的旧版配置副本。不同方案使用独立配置目录,避免误覆盖已有实例。

常见问题

  • 转码和直接播放的性能需求不同,先从仪表盘确认实际播放方式再排查。

  • 外网接入单独配置 HTTPS 和访问控制,不能只把所有服务端口转发出去。

更新与备份

备份配置数据库、观看记录及原始媒体;更新前停止写入并保留可恢复的数据副本。

更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。

官方资料