应用简介
Emby 是一款功能强大的流媒体中心软件,旨在将个人媒体内容集中管理并在各种设备上播放。Emby 支持多种媒体格式,包括视频、音乐和图片,并且能够自动转换和流式传输媒体内容,确保在任何设备上都能流畅播放。
Docker Compose 配置部署
在 UGOS Pro 系统上,推荐使用项目 Docker Compose 快速部署容器,适合需同时管理多个容器的场景,这种方法简化了容器的部署与管理工作。以下是使用 Docker Compose 部署容器的详细步骤。
1. 打开“Docker”应用,点击【项目】 > 【创建】,启动项目创建向导。
2. 在项目创建向导中,输入以下容器的 Docker Compose 配置信息。这些配置仅供参考,您可以根据自己的需求进行调整。
services:
emby:
image: emby/embyserver:beta # 镜像名
container_name: emby-server
restart: always # 重启策略
devices:
- /dev/dri:/dev/dri # 启用核显
environment:
PUID: 0 # 容器运行用户ID,root权限
PGID: 0 # 容器运行用户组ID,root权限
volumes:
- ./config:/config # 配置文件
- ./metadata:/metadata # 媒体元数据
- /volume3/media:media # 影片存放路径,容器可以读取路径中的影片,冒号左侧的路径替换为你在NAS上存放影视的实际路径,冒号右侧是容器内路径
ports:
- 8096:8096 # 将容器的 8096 端口映射到 NAS 的 8096 端口
3. 填写好配置文件后,点击“立即部署”,系统会自动拉取镜像并启动容器。

4. 部署完成后,通过浏览器访问容器,在浏览器地址栏输入 http://NAS_IP:8096
。例如 NAS 的 IP 是172.17.70.86,在浏览器中输入http://172.17.70.86:8096
进行访问。
你可以在控制面板中,找到 【网络设置】,点击 “网络连接” ,查看 NAS 设备的 IP 地址。

Compose 配置参数说明
参数 | 说明 |
image | 指定 Docker 镜像,beta 为测试版本。 |
restart | 设定重启策略为 always ,容器在崩溃或停止时会自动重启,确保服务持续运行。 |
devices | 启用 NAS 的核显进行硬件加速,如视频转码。通过挂载该设备,Emby 可以利用 NAS 的 GPU 进行视频转码,加快处理效率并减轻 CPU 负担。 |
environment | 设置环境变量,以配置容器中的服务。PUID/PGID :定义容器运行用户和组的权限。 |
ports | 端口映射:将 NAS 的 8096 端口映射到容器的 8096 端口,通过 http://NAS_IP:端口 访问 Web 界面。 |
volumes | 映射 NAS 本地文件夹到容器内的挂载路径。./config :用于存储 Emby 配置文件。./metadata :用于存储 Emby 的媒体元数据(如影片封面、演员信息等)。/volume3/media :影片存放路径,Emby 可以从该目录扫描和管理视频文件匹配电影海报等数据。冒号左侧的/volume3/media 路径替换为你在NAS上存放影视的实际路径。 |
补充说明 | ./ 表示路径是在当前创建的项目所选择的存放路径内./:/ 表示将 NAS 本地 ./ 目录挂载到容器 / 目录。冒号前是 NAS 内文件夹的存储路径,冒号后是容器内对应的挂载映射路径。 |
初始化配置
首次登录 Emby 时,需要完成初始化配置:
1. 选择首选语言(如“Chinese Simplified”),点击“next”。刷新浏览器页面可以切换成刚才设置的显示语言。

2. 设置用户名和密码,点击“下一个”继续。

3. 初始化时可暂不配置媒体库,点击“下一个”继续。

4. 是否“启用自动端口映射”对功能无影响,可直接跳过。

5. 勾选“我接受服务条款”,点击“下一个”。

6. 到图示的这一步,初始化步骤结束,点击“完成”。

● 初始化完成后,请使用刚创建的用户账户登录系统。

添加媒体库
登录后,按照以下步骤添加媒体库以管理你的资源:
1. 点击“管理 Emby Server”,进入“设置”页面。

2. 在“媒体库”选项中,点击“+新媒体库”。根据媒体内容类型(如“电影”或“电视节目”)进行分类。

电影媒体库推荐设置
● 内容类型:选择“电影”;
● 显示名称:媒体库的显示名称;
● 文件夹:参考你在 compose 配置设置的路径,如你设置的 NAS 内/volume3/media 对应的 emby 内的文件夹路径是 /volume3/media,在这里就找到对应的路径。
● 首选元数据语言、分级国家等可根据需要调整;
● 其他参数可按需调整。

电视剧/综艺等媒体库推荐设置
● 内容类型:选择“电视节目”;
● 显示名称:媒体库的显示名称;
● 首选元数据语言、分级国家等可根据需要调整;
● 文件夹:同电影设置方式。
● 其他参数可按需调整。

开启硬件转码
Emby 支持硬件转码,但需要订阅 Emby Premiere 服务。如果你不订阅这个服务,即使开启了硬件转码也无法使用。
开启硬件转码时,选择“高级”模式,加载显卡驱动后可解锁更多解码器选项。

常见问题
Q1:镜像下载失败处理方法
Docker 镜像加速器:建议配置加速器以提高下载速度,特别是在中国内地的网络环境下。参考Docker配置镜像加速与镜像仓库拉取指南 了解如何设置。
代理设置:在某些情况下,你可能需要配置 HTTP/HTTPS 代理来辅助下载,详见Docker通过设置代理下载镜像 。
Q2:获取 NAS 文件夹的真实路径并挂载到 Docker 容器
在使用Docker时,您可能需要将 NAS 中的文件夹挂载到Docker容器中,以便容器可以访问 NAS 上的数据。您可以参考获取NAS文件夹的真实路径并挂载到Docker容器 ,帮助您完成这一操作。
注意事项
● 本教程涉及的镜像由第三方开发维护,教程仅作参考,绿联不承担因操作不当、软件漏洞或镜像更新引发的风险,如文件异常、数据泄露等。请选用可信镜像,确保系统和数据安全。
● 容器文件路径可自行设定,网页访问时,容器端口和本地端口需一致,不同容器的本地端口不能冲突。
● 容器网页链接仅在 bridge 桥接模式下可访问。
● 镜像仅提供搭建教程,具体使用和玩法可网上査询,配置变动和 bug 修复请关注官方信息。
● 建议将 Docker 配置目录存于 SSD 硬盘,防止机械硬盘影响性能。