Pulsarr 是一款实时 Plex 片单（watchlist）监控与内容获取工具，能把用户收藏自动同步到 Sonarr、Radarr，并在内容就绪时通过四大通知渠道——Telegram、Slack、Plex 移动端推送和 Webhook——自动告知请求者与管理员。本文带你逐一打通这四条通知链路。

通知体系总览：先看懂入口

所有通知设置都在左侧菜单Notifications页面下，官方文档对应 docs/content/docs/notifications/index.mdx。四条渠道分工清晰：

渠道的具体发送逻辑位于 src/services/notifications/channels/ 目录，每个渠道一个独立服务文件，例如 apprise.service.ts 与 native-webhook.ts。

渠道一：用 Apprise 打通 Telegram、Slack 和邮件

Apprise 是一个"通知中转站"：它把各种服务的推送地址统一成 URL 格式，Pulsarr 只需对接它一个服务，就能覆盖 Telegram、Slack、邮件等众多渠道。

1. 一键启动 Apprise 服务

推荐用 Docker Compose 与 Pulsarr 一起部署，这样 Pulsarr 可以直接通过容器名访问它。完整配置示例见官方文档 docs/content/docs/notifications/apprise.mdx：

services: apprise: image: caronc/apprise:latest ports: - "8000:8000" restart: unless-stopped

然后在 Pulsarr 的.env中写入服务地址并重启：

appriseUrl=http://apprise:8000

启动后进入Notifications > Apprise，页面会显示当前地址以及 Pulsarr 是否成功连上了 Apprise。

2. 配置系统通知 URL

在System notifications区域填入 Apprise URL，例如tgram://bot_token/chat_id（Telegram 机器人）；多填几个即可推送到多个服务。每个 URL 旁边都有Send test按钮，点一下就能立刻收到测试消息，省去排查配置的烦恼。

3. 让用户自己配 Telegram 地址

每个用户自己的 Apprise URL 填在自己的用户页（Plex users 下），也可以让有 Discord 的用户直接输入/notifications自己设置。管理员通知和用户通知各走各的 URL，互不干扰。

💡 小贴士：配置一个mailtos://邮箱发件人后，所有 Apprise 输入框都可以直接填普通邮箱地址，Pulsarr 会通过该邮箱代发通知。

渠道二：Plex 移动端推送，点击直达影片

这是用户体验最丝滑的渠道：用户收藏的内容一就绪，Plex App 就直接弹出推送，点一下打开对应影片。前提是 Plex 服务器订阅了 Plex Pass。

开启 Plex 移动推送

1. 进入Notifications > Plex mobile，打开Send to Plex mobile apps总开关；
2. 在 Plex users 页面为每个用户单独打开Plex mobile开关（也可批量编辑）；
3. 点Send a test push向单个用户推一条测试消息验证链路。

两个容易踩的坑

• 内容尚未入库：影片就绪但 Plex 还没扫描完成时，Pulsarr 会自动重试约 10 分钟（见 plex-mobile.service.ts 中的重试逻辑），所以"没收到推送"稍等片刻再判断。
• 重复推送：Plex 自身的 "New Content Added to Library" 也会对新内容发推送，与 Pulsarr 的推送叠加会变成两条。建议取消勾选该选项，只保留 Pulsarr 的精准推送。

渠道三：Webhook 自动化，把 Pulsarr 接进你的智能家居

Webhook 是管理员渠道：Pulsarr 把标准化 JSON 事件 POST 到你指定的 URL，适合接 Home Assistant、n8n 或自建脚本，官方文档见 docs/content/docs/notifications/webhooks.mdx。

添加端点并选择事件

在Notifications > Webhooks点Add endpoint，填写名称、URL、可选的鉴权头（Header name / value），再勾选要订阅的事件。填完先点Send test，你的服务会收到一条"event": "test"的测试载荷。

内置 9 种事件，覆盖全流程

交付机制：超时重试与证书校验

端点需在约 10 秒内返回 2xx；超时、5xx、429 会重试至多 3 次，4xx 只发一次。注意 Pulsarr 严格校验 HTTPS 证书，自签名证书会导致投递失败。发送实现见 native-webhook.ts，路由入口为 src/routes/v1/notifications/webhook.ts。

加分项：Delivery 设置统一管理所有渠道

Notifications > Delivery（delivery.mdx）里的选项对每条渠道生效：

• 剧集分组：多集剧集接连到达时合并成一条通知。Queue wait time控制合并等待时长，New episode threshold之内播出的新集则立即推送、老集自动归组；
• 管理员通知路由：可选择推送给"全部渠道 / 仅 Apprise / Discord webhook 等"，并单独开关片单新增、版本更新提醒；
• 用户就绪通知：总开关决定是否告知用户"你要的内容好了"，各用户仍可在个人页自选具体渠道。

总结

Pulsarr 的通知设计思路是"分层解耦"：Apprise 负责通用消息面（Telegram、Slack、邮件），Plex 推送负责最佳用户体验，Webhook 负责机器对机器的自动化，Discord 则兼顾聊天场景。按本文顺序配置——先起 Apprise、再开 Plex 推送、最后接 Webhook——你就能在一个统一的Notifications页面里，把整个媒体库的"到货提醒"彻底自动化。