服主教程 · Emby

Emby 服主：配置新片入库推送

让订阅你 Emby 服务器的用户及时看到想追剧集的新集更新。当你把新一集加入媒体库，如果用户已把该剧集加入收藏夹，OopsPlayer 就可以向他们发送带有剧集名称和封面的推送通知。本教程带你在大约 5 分钟内完成配置。

面向 Emby 服务器管理员 · 中文 · 2026-09-24

你的订阅用户会看到什么

当你为用户收藏的剧集添加新一集时，用户可以在 OopsPlayer 收到包含标题和封面的通知。下面是 iPhone 上的效果示例。

iPhone 上的 OopsPlayer 新集推送通知，显示剧集标题与封面 — 新集入库推送示例。通知语言和封面取决于设备语言与媒体信息。

开始前准备

准备好 Emby 服务器的管理员账号、提供给订阅用户使用的服务器地址，以及 Telegram 账号。接下来会通过 @OopsMediaBot 创建 Webhook。Bot 建议使用 Emby 4.8 或更新版本。

Webhook URL 请勿公开。只应将它填入你自己的 Emby 通知设置。下方示例截图已经遮盖该 URL。

从 OopsMediaBot 获取专属 Webhook

Bot 会为你的服务器生成专属 Webhook URL，下一步需要把它完整粘贴到 Emby。

在 Telegram 搜索 @OopsMediaBot，发送 /start。按照 Bot 提示添加 Emby 服务器；如果已经使用过 Bot，可以发送 /new 开始新的配置。
发送订阅用户实际使用的 Emby 服务器地址，包括协议、端口和路径（如有），例如 https://emby.example.com。
核对地址，确认该服务器由你管理。如果 Bot 提示无法从公网访问，请仅在地址确实正确时选择“地址正确，继续”。
复制 Bot 生成的完整 Webhook URL，下一步会用到它。

Telegram Bot 提示确认 Emby 地址并生成专属 Webhook URL，URL 已遮盖 — 截图从 /new 开始，展示地址确认与生成 Webhook 的过程；公开示例已遮盖私密 URL。

在 Emby 中配置新增媒体通知

让 Emby 在媒体库新增内容时，向刚才的 Webhook 发送事件。

以管理员身份打开 Emby 设置，进入通知 → 添加通知 → Webhooks。

在“通知”页面点击“添加通知”，再选择 Webhooks。
给通知填写便于识别的名称，例如 OopsPlayerNewMedia；把 Bot 给你的完整地址粘贴到“网址”栏。
将“请求内容类型”设为 application/json。

名称可自定；网址填入你自己的完整 Webhook URL，内容类型选择 application/json。此截图来自编辑既有通知，新增时填写相同字段。
向下找到事件设置，勾选媒体库 → 已添加新媒体；如果这条 Webhook 只用于新片入库，无需勾选其他事件。

勾选“媒体库”下的“已添加新媒体”。

发送测试并保存

在 Emby Webhook 表单中点击发送测试通知。

点击“发送测试通知”后，回到 Bot 查看验证结果。此图是编辑已有通知的页面，因此底部显示“保存”；新建通知时按钮名称可能不同。
返回 Telegram，等 Bot 显示✅ Emby Webhook 已验证完成。这表示测试事件已送达。

收到 Bot 的验证成功消息后，再完成 Emby 表单的保存。
返回 Emby，点击页面底部的保存或添加新通知，完成创建。不要只测试却忘记提交。

配置完成后，可以给一部已被订阅用户加入收藏夹的剧集添加新一集，请该用户确认是否收到通知。测试通知确认 Webhook 可用；真实的新集入库可以验证整条推送链路。

订阅用户收不到通知时

Bot 没有确认验证：检查 Webhook URL 是否完整，确认请求内容类型为 application/json，再发送一次测试通知。
测试通过，但新增剧集没有提醒：确认已勾选“媒体库 → 已添加新媒体”，并在测试后保存了 Emby 通知；再用真正新增的一集验证。
只有部分用户收到提醒：请用户检查是否已在 OopsPlayer 添加你的 Emby 服务器，并允许 OopsPlayer 发送通知。
想追的剧集没有更新提醒：确认订阅用户已经把想追的剧集加入 OopsPlayer 的收藏夹。

最后更新：2026-09-24