Emby

Emby / Jellyfin / Plex 联动

Cloud189 Auto Save 与媒体服务器的结合点主要有三类：STRM 播放、入库通知/刷新、路径替换与代理播放。

---

1. STRM 播放

普通 STRM

转存完成后，系统可根据配置在本地生成 .strm 文件。STRM 中写入的是播放地址，媒体服务器读取后直接播放，无需下载大文件。

• 是否生成由 媒体 页 STRM 设置 中的 启用 STRM 生成 决定。
• 账号的 云端媒体目录前缀 和 本地目录前缀 会影响生成路径和映射关系。
• 如果启用 普通任务使用系统中转，STRM 中写入的是本项目代理地址，而不是短时有效直链。

懒转存 STRM

• 先生成可播放入口，不立即占用网盘空间。
• 播放时由系统动态转存并换取直链。

---

2. Emby 配置

进入 媒体 页，在 Emby 设置 中配置：

配置项	说明
Emby 地址	Emby 服务器 URL，如 http://127.0.0.1:8096
API Key	Emby 服务器设置中生成的 API 密钥
启用 Emby 入库通知	转存完成后自动触发 Emby 增量扫描
启用 Emby 反代播放	开启内置 Emby 代理，支持 302 直链跳转
代理端口	反代独立端口，默认 8097
启用下一集预热	播放结束前预热下一集，减少等待
Sessions 轮询间隔(ms)	检测当前播放会话的间隔
预热去重时长(ms)	避免短时间内重复预热

---

3. 反代播放

启用 Emby 反代播放 后：

• 系统会在主服务端口（默认 3000）挂载 /emby-proxy 路径。
• 同时还会额外启动一个独立端口（默认 8097）直接反代 Emby 根路径。
• 播放请求会优先尝试 302 跳转到天翼云直链；其余请求回源到 Emby。

如果 Docker 部署，需要映射代理端口：

-p 8097:8097

Nginx 反代示例：

# 主服务
location / {
    proxy_pass http://127.0.0.1:3000;
}

# Emby 代理端口
location /emby-proxy/ {
    proxy_pass http://127.0.0.1:8097/;
}

---

4. 路径替换

由于 Docker 映射或网络挂载，云盘路径与媒体服务器识别的路径可能不一致。

账号级路径配置

在 账号 页点击账号的 媒体目录 列可以配置：

• 云端媒体目录前缀：云盘中对应媒体目录的路径。
• 本地目录前缀：STRM 生成到本地的基路径。

Emby 路径替换

通过 API 可以为账号配置 Emby 替换路径：

PUT /api/accounts/:id/strm-prefix
{
  "strmPrefix": "/影视/动漫:/media/animation",
  "type": "emby"
}

系统在发送通知或刷新请求时，会自动将云端路径替换为 Emby 可识别的本地路径。

---

5. NFO 与刮削

系统在启用 TMDB 刮削后，会为 STRM 文件旁生成：

• .nfo 文件（电视剧、电影、单集）
• 海报图片
• Logo 图片

配置入口在 媒体 页 TMDB 刮削：

配置项	说明
启用刮削	开启后自动为 STRM 生成 NFO 和海报
TMDB API Key	从 TMDB 申请的 API Key

---

使用建议

• 先在 媒体 页完成 Emby 地址和 API Key 配置。
• 确保账号的 云端媒体目录前缀 和 本地目录前缀 已正确设置。
• 如果直链频繁过期，优先开启 普通任务使用系统中转。
• 确保 Docker 中的 PUID/PGID 与宿主机的媒体文件所有者一致。