跳至主要內容

Emby：家庭媒体中心

约 1733 字大约 6 分钟...

Emby 是功能完善的自建家庭媒体服务器，可在家庭网络内外流式播放视频、音乐和照片。本文覆盖 Docker 部署、权限设置、刮削元数据、外网 HTTPS、IPTV 直播、115 云盘挂载等典型需求。

会员价位 Emby Premiere 终身会员官方价 119 美元；黑五前后常下探到 99 美元，是最划算的入手窗口。月 / 年度订阅适合只想短期体验的用户。注意 Emby 不支持蓝光 ISO 添加字幕。

Docker Compose 部署

推荐通过 Docker Compose 部署，详情参见 Docker Compose 部署教程。使用 linuxserver 镜像（内置 s6 和 PUID/PGID 支持，适合 NAS）：

services:
  emby:
    image: lscr.io/linuxserver/emby:latest
    container_name: emby
    environment:
      - PUID=1026
      - PGID=100
      - UMASK=022
      - TZ=Asia/Shanghai
    volumes:
      - /volume1/docker/emby/config:/config
      # 媒体库映射
      - /volume4/Media/TVShows:/data/tvshows
      - /volume4/Media/Movie:/data/movies
      - /volume4/Media/Anime:/data/anime
      - /volume4/Media/Documentary:/data/documentary
      - /volume4/Music/MV:/data/MV
      - /volume4/Music/Audio:/data/Audio
      #- /opt/vc/lib:/opt/vc/lib #optional
      # 云盘映射（不要挂载云盘下的子路径，否则可能无法播放）
      - /volume2/CloudNAS:/volume2/CloudNAS
    ports:
      - 8096:8096
      #- 8920:8920 #ssl
    restart: unless-stopped

也可以用 Emby 官方镜像 emby/embyserver:latest。linuxserver 的版本更适合群晖等 NAS 用户（自动处理权限），官方镜像则更接近原生部署。

部署完成后，浏览器访问 http://<你的服务器 IP 或域名>:8096，首次进入会引导完成登录和媒体库配置。媒体库目录需要对 Emby 使用的系统用户（PUID/PGID）具备读写权限，否则扫描会报错。

基本使用

添加媒体库

  • 国家/地区下拉框里中国按简称 PRC 排列，需要到字母 P 下找。
  • 媒体库偶尔出现"内容为空"通常是数据库异常，删掉当前媒体库目录再重新添加即可恢复。

刮削元数据

建议配合 tinyMediaManager 做本地刮削，再让 Emby 直接读取 NFO，可比 Emby 自带的在线刮削更稳、更统一。详细流程参考小雅提供的刮削教程。

合集：按账户隐藏

为家人配置独立账户并设置不同的媒体库权限后，「合集」默认会在所有账户首页显示，容易走光敏感内容。

逐账号登录，进入「设置 > 主屏幕 > 合集」，取消勾选「在主屏幕显示」。注意合集菜单仍保留，要彻底隔离的内容还需在对应账户的媒体文件夹权限里单独限制。

外网 HTTPS 访问

从外部访问 Emby 时强烈建议启用 HTTPS。两种思路：

方案 A：Nginx Proxy Manager 反向代理（推荐） 用 Nginx Proxy Manager 自动签发 Let's Encrypt 证书并反代 Emby，配置简单、续期全自动。

方案 B：Emby 内置 HTTPS 适合不想多加一层反代的场景。可参考这篇 Bilibili 教程（搜"Emby HTTPS DDNS pfx 配置"关键词可找到备份版本）。大致流程：

  1. 为家庭网络设置 DDNS（通常由路由器完成）。
  2. 下载与域名匹配的 Tomcat .pfx 证书。
  3. 把 pfx 文件和含密码的 txt 放到 Emby 的 config 目录指定位置。
  4. Emby 的「服务器 > 网络」里填公共端口和 DDNS 域名，启用安全连接。
Emby 网络设置中启用 HTTPS 安全连接示意
Emby 网络设置中启用 HTTPS 安全连接示意

播放资源

IPTV 直播

购买 Emby Premiere 且拥有可用 m3u 源后即可播放直播电视。m3u 是一个文本格式文件，列出每个频道的流地址。IPv4 的公共 IPTV 源容易被封，IPv6 通常更稳定，可通过 test-ipv6.com 确认本地 IPv6 支持情况。

常用源与工具：

把 m3u 保存到 Emby config 目录下，例如 /config/config/IPTV.m3u，然后在 Emby 里添加：

  1. 源类型选 M3U。
  2. 输入路径，如 /config/config/IPTV.m3u。
  3. 勾选 允许使用频道编号映射指南数据。

指南数据源选中国 + XmlTV，文件或 URL 填 https://live.fanmingming.com/e.xml，其他保持默认。

如果有多个 IPTV 源，可用 xTeVe 做聚合；大多数情况下直接在 Emby 里管理就够了。

云盘资源（115 / CloudDrive2 方案）

阿里云盘限速后，115 凭借大容量和不限速重回主流。目前较成熟的方案是 CloudDrive2 + 115 + Auto Symlink(strm)：

  1. 用 CloudDrive2 把 115 挂载为本地目录（或用 Alist 通过 302 重定向走直链）。
  2. 用 Auto Symlink 为挂载目录下的媒体生成 strm 软链接。
  3. 让 Emby 扫描存放 strm 的本地目录即可。

常用插件

除官方插件外，以下是常用的第三方插件。把解压后的 dll 放到 /config/plugins 并重启 Emby 生效：

  • StrmAssistant：优化 Emby 界面与 strm 文件的播放体验。
  • embyExternalUrl：调用外部播放器播放 Emby 内容，应对原生客户端对部分格式支持不佳的情况。
  • MeiamSubtitles：Emby / Jellyfin 中文字幕插件，支持迅雷影音、射手网自动匹配下载。

常见问题

某些格式无法播放 / 显示"未兼容的流"

Emby 的 Android TV、网页端与手机客户端只原生支持部分媒体格式。常见原因：

  • 播放器解码能力不足：在播放设置里启用"外部视频播放器"，调用 nPlayer / VLC / MX Player 等硬核播放器。
  • STRM 路径错误 / 挂载权限不足：先用 docker exec 进入容器确认 strm 指向的路径在容器内可访问、权限对。
最近更新: