项目介绍
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:20171emby 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,不要把删除卷或清空数据目录当作更新步骤。