Emby 是一款私有化、跨平台的媒体服务器软件，核心是把你本地的电影、剧集、音乐、照片等统一管理，在几乎所有设备上流畅串流，打造属于自己的 Netflix 式私人影库。

一、核心架构（客户端 - 服务器）

• Emby Server（服务端）：安装在 PC、NAS、Linux、Docker、树莓派等设备上，负责存储、刮削、转码、管理媒体库，自带网页管理后台。
• Emby Client（客户端）：安装在手机、电视、平板、浏览器、游戏机等，连接服务器播放内容。

二、核心功能

1、智能媒体管理

• 自动扫描、识别电影 / 剧集 / 音乐 / 照片，按文件夹与文件名匹配元数据。
• 自动抓取海报、简介、演员、评分、字幕，生成精美海报墙。
• 支持手动编辑元数据、自定义封面、本地 NFO 存储。

2、实时转码与串流

• 自动适配设备与带宽，将高码率视频实时转码为流畅格式。
• 支持硬件解码（如 Intel QuickSync），大幅降低 CPU 占用，4K 播放更稳。
• 局域网 / 外网均可访问，Emby Connect 简化远程登录Emby。

3、多端覆盖

• 客户端：Android、iOS、Windows、macOS、Android TV、Apple TV、Fire TV、Roku、LG/Samsung 智能电视、网页、PS/Xbox 等。
• 支持 DLNA、Chromecast、AirPlay 投屏Emby。

4、家庭与权限

• 多用户账号、分级权限、家长控制、观看时长限制Emby。
• 播放进度跨设备同步、历史记录、收藏。

4、高级扩展（Premiere）

• 离线下载、硬件转码、移动同步、云同步、DVR 电视录制、插件生态。

三、适合人群

• 拥有大量本地影视 / 音乐，想统一管理、多设备播放的用户。
• 家庭用户，需要共享媒体、家长控制。
• NAS 用户，打造 24 小时在线私人影音中心。
• 追求数据主权、不想依赖第三方流媒体的用户。

四、部署过程

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 创建以下目录结构，确保路径可访问：

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

同时准备媒体文件目录（示例）：​

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

4、开始部署

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

version: "2.3"
services:
  emby:
    image: emby/embyserver:latest
    container_name: Emby
    network_mode: host # 支持DLNA和局域网唤醒
    environment:
      - UID=0 # 以用户ID运行Emby（推荐：0）
      - GID=0 # 运行Emby的GID（推荐：0）
      - GIDLIST=0 # 以逗号分隔的额外GID列表，用于运行Emby（推荐：0）
    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

配置参数说明

• 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 将开始扫描媒体文件（时间取决于文件数量）