媒体服务器

xylplm2026/7/17大约 9 分钟媒体服务器EmbyJellyfinPlexWebhook

📺 媒体服务 - 媒体服务器

媒体服务器页用于新增、编辑、同步和管理各类媒体服务实例。页面以卡片网格展示，可直接查看启灵状态、默认同步结果与快捷操作。

⚡ 快速操作流程

建议按以下顺序完成媒体服务器配置：

新增媒体服务器并填写基础信息
点击「测试」确认连接可用
保存后执行一次手动同步
按需配置定时同步任务
Emby / Jellyfin / Plex 建议配置 Webhook 消息推送
如涉及网盘 .strm 播放，配置媒体代理

📋 媒体服务器列表

媒体服务器列表展示所有已添加的媒体服务器，支持 Emby、Jellyfin、Plex、绿影视、飞牛影视、极影视等类型。

🎯 功能操作

🔄 刷新：重新加载媒体服务器列表
➕ 新增媒体服务器：添加新的媒体服务器配置
⏰ 定时任务：设置媒体库自动同步计划
✏️ 编辑：修改现有媒体服务器配置
❌ 删除：删除不需要的媒体服务器配置
▶️ 同步：手动同步媒体库数据
🗂️ 媒体库启用范围：勾选参与同步与展示的媒体库（见下文说明）
👁️ 同步历史记录：查看同步历史
🗑️ 删除同步历史记录：清除同步历史
🔗 Webhook 地址：仅 Emby / Jellyfin / Plex 显示，一键查看并复制内网 / 外网地址

📊 状态显示

类型：媒体服务器类型图标
名称：自定义名称
开启：是否启灵
默认：是否作为默认媒体服务器
同步信息：最近一次同步统计（电影数、电视剧数、耗时等）
更新时间：配置最后更新时间

📚 支持的媒体服务器类型

类型	说明	教程
Emby	功能强大，生态成熟	查看
Jellyfin	开源免费，社区活跃	查看
Plex	使用体验完善，插件生态丰富	查看
绿影视 (UGoS)	绿联私有云设备上的媒体服务器	查看
飞牛影视 (FNOS)	飞牛系统中的媒体服务器	查看
极影视 (极空间)	极空间私有云设备上的媒体服务器	查看

每种媒体服务器都需要填写对应的地址、密钥或其他鉴权信息。点击上表教程可查看详细配置方式。

➕ 新增媒体服务器

以 Emby 为例，输入服务器地址、名称、Api Key，点击「保存」即可完成添加。

💡 建议在服务器地址中直接填入外网访问地址。
若填写的是内网地址（例如 http://ip:port），则必须在「媒体播放地址」中填入外网访问地址以保证远程可访问。

🎛️ 媒体服务器配置字段

📺 媒体服务器：选择类型（Emby / Jellyfin / Plex 等）
📝 名称：自定义显示名称
✅ 是否开启：控制是否启灵
⭐ 默认：默认媒体服务器，用于判断媒体是否存在或缺失集数
🆔 服务 ID：保存后生成的只读标识，配置 Webhook 时会用到
其他字段：按媒体服务器类型动态展示（地址、API Key、Cookie 等）

🧪 测试连接

保存前可点击「测试」验证配置；测试通过后再保存。

🔔 Webhook 消息推送

Emby / Jellyfin / Plex 支持在媒体服务器编辑页直接配置 Webhook 消息推送。

推送开关与事件

配置项	说明
启用消息推送	总开关。关闭后不会通过消息渠道推送，但 Webhook 仍会接收并处理业务（如观影报告实时采集）
推送事件类型	可多选。不选或全选表示推送全部事件

常见事件包括播放开始 / 停止 / 进度、媒体入库 / 删除、用户登录等，具体选项由后端按服务器类型下发。

一键获取 Webhook 地址

保存媒体服务器后，可在以下入口打开地址弹窗：

列表卡片上的 Webhook 地址 按钮
编辑弹窗中的 Webhook 地址 按钮

弹窗会按已启用的 API Key 生成地址，并尽量同时给出：

内网地址：媒体服务与 Media Saber 同内网时优先使用
外网地址：媒体服务需要跨网络访问时使用

若暂时无法生成，会给出明确原因：

原因	处理方式
尚未配置访问地址	到系统设置填写内网主机地址 / 外网访问地址
尚未启用 API Key	到账户安全设置创建并启用 API Key
当前类型不支持	仅 Emby / Jellyfin / Plex 支持媒体服务级 Webhook

地址中包含 API Key，请勿分享。停用或删除对应 Key 后，地址会立即失效。

🗂️ 媒体库启用范围

每台媒体服务器都可以配置「媒体库启用范围」：只有勾选启用的媒体库才会进入 Media Saber。这个功能专为隐私场景设计 —— 例如某些媒体库的内容敏感，只希望在媒体服务器里直接观看，不希望它们在本系统任何地方出现。

未启用的媒体库会发生什么

取消启用一个媒体库后，它在本系统中同步、扫描、采集、推送、展示全链路失效：

影响范围	行为
媒体库同步	不再同步该库的媒体数据
字幕扫描	不再对该库巡检字幕，已有扫描数据被清理
播放记录	不再采集该库的播放记录，Webhook 事件也不会推送该库的消息
界面展示	我的媒体库、最近入库、继续观看、正在播放、观影报告、健康中心、字幕中心全都不显示

💡 使用界面对屏蔽完全无痕：不会有「已隐藏 N 个媒体库」之类的提示，空区块的文案与「确实没有数据」时完全一致。旁人看屏幕看不出这里配置过隐私。

配置步骤

打开 媒体服务 → 媒体服务器
在对应服务器卡片上点击 媒体库启用范围
勾选需要启用的媒体库（弹窗内始终展示全部媒体库，含未启用的）
按需设置任务周期（与定时同步共用同一计划）
点击 保存配置，立即生效，无需等待下一次定时同步

保存时会发生什么

取消启用的媒体库：其已同步的媒体数据与字幕扫描数据会被清理（可通过确认弹窗了解清理范围）
可选勾选 「同时删除已有播放记录」：彻底删除该库此前的播放记录（不可恢复，默认不勾选）。不勾选时历史记录仍保留在数据库中，但界面与统计均不展示
该库的字幕策略配置会保留，重新启用后原样可用，扫描数据也会在下一次巡检时重建

⚠️ 媒体服务器上新增的媒体库默认未启用，需要到本页面手动勾选后才会参与同步。

已知限制

场景	说明
飞牛影视	其接口不提供媒体库归属信息，存在屏蔽库时该服务器的「继续观看」与播放记录采集会停止（其余功能不受影响）
工具类插件弹窗	部分运维工具的媒体库选择仍为全量，便于对被屏蔽的库执行操作
媒体服务器自身	在 Emby / Plex 客户端里的可见性由媒体服务器自己控制，超出本系统边界

🔄 媒体库同步

媒体库同步是把媒体服务器里的媒体项、路径、季集、内封字幕等事实拉回 Media Saber 的过程。
我的媒体库、媒体健康中心、字幕中心都依赖同步结果。

手动同步

打开 媒体服务 → 媒体服务器
在对应服务器卡片上点击 同步媒体库
等待同步任务完成
可到 同步历史记录 查看结果明细
再到「我的媒体库 / 媒体健康中心 / 字幕中心」确认数据是否更新

卡片上常见相关操作：

操作	说明
同步媒体库	立即拉取该服务器的媒体库数据
同步历史记录	查看最近同步明细（电影 / 剧集 / 耗时等）
删除同步历史	清理历史记录，不影响媒体服务器本身
定时任务	配置自动同步计划