# Apprise 接入 Server酱：一条 URL 让 55+ 开源应用推送微信（2026 教程）

> Server酱 内置于通知库 Apprise：在 Uptime Kuma、Home Assistant、changedetection 等 55+ 应用中填一条 schan://SendKey 即可推送微信，本文是通用接法母页。

- 网页版：https://sct.ftqq.com/docs/integrations/apprise/
- 更新日期：2026-07-17

# Apprise + Server酱：一条 URL，55+ 开源应用推送微信

> 效果：凡是支持 Apprise 通知的应用（Home Assistant、Uptime Kuma、changedetection.io、Healthchecks 等 55+ 个），填一条 `schan://你的SENDKEY` 就能把通知发到微信——不用写任何代码。

[Apprise](https://github.com/caronc/apprise) 是最流行的开源通知聚合库（16.9k★），**Server酱 是它的内置服务之一**（插件源码 `apprise/plugins/serverchan.py`）。这意味着大量自托管应用天然支持 Server酱。

## 前置条件

- 一个 Server酱Turbo SendKey（`SCT` 开头，[30 秒获取教程](https://sct.ftqq.com/docs/getting-started/sendkey/)）
- 一个支持 Apprise 的应用（后文有清单）

## 通用接法

Server酱 在 Apprise 中的 URL 格式只有一种：

```text
schan://你的SENDKEY
```

在应用的通知设置里找到 Apprise URL 输入框，粘贴即可。应用产生的通知标题/正文会自动映射为 Server酱 的 `title`/`desp`（正文支持 Markdown）。

先用命令行验证这条 URL 可用（可选但推荐）：

```bash
pip install apprise
apprise -t "测试标题" -b "测试正文" "schan://你的SENDKEY"
```

微信收到消息即验证通过。

## 三种接入形态

支持 Apprise 的应用分三类，配置入口略有不同：

| 形态 | 说明 | 例子 |
|---|---|---|
| 内置 apprise 库 | 应用设置里直接有 Apprise URL 输入框 | Uptime Kuma、changedetection.io、Healthchecks、Mealie |
| 对接 Apprise API | 应用连接独立部署的 [apprise-api](https://github.com/caronc/apprise-api) 容器，`schan://` URL 配在 API 侧或应用侧 | NetAlertX 等 |
| 插件 | 先装 Apprise 插件再填 URL | Home Assistant（apprise 集成）、OctoPrint 类 |

## 支持 Apprise 的高影响力应用

以下应用均经源码核实支持 Apprise（完整 55+ 清单与各应用的配置入口，见对应集成页，陆续上线）：

Home Assistant · Uptime Kuma · Apache Airflow · changedetection.io · Sonarr / Radarr · Audiobookshelf · Mealie · [Healthchecks](https://sct.ftqq.com/docs/integrations/healthchecks/) · Speedtest Tracker · Moonraker（Klipper 3D 打印）· borgmatic · Mailrise（把"只会发邮件"的老设备转成微信推送）等。

已上线的详细教程：

- [Healthchecks：定时任务没打卡就告警](https://sct.ftqq.com/docs/integrations/healthchecks/)
- [changedetection.io：网页变更推微信](https://sct.ftqq.com/docs/integrations/changedetection/)

## 常见问题

**Server酱³（sctp 开头的 SendKey）能用 `schan://` 吗？**
不能，`schan://` 只对接 Server酱Turbo。Server酱³ 用户可改用 Apprise 的 `json://` 通用 HTTP 插件直连 SC3 端点（`{uid}.push.ft07.com`），或直接用 SCT 的 SendKey。

**消息没收到？**
先用上面的 `apprise -vv` 命令行验证 URL（`-vv` 会输出详细错误）；再检查免费额度（每天 5 条）与频率限制（每分钟 50 条）。完整排查见 [FAQ](https://sct.ftqq.com/docs/getting-started/faq/)。

**应用的通知太频繁，额度不够？**
优先在应用侧收敛通知触发条件（多数应用支持只在失败/恢复时通知）；量大可订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（[价格详情](https://sct.ftqq.com/subscribe)）。

**我的应用没有 Apprise 支持怎么办？**
看它是否支持自定义 Webhook（参考 [通道对比](https://sct.ftqq.com/docs/getting-started/channels/) 与各集成页），或用 Mailrise 把邮件通知转成 Apprise。

## 相关集成

- [Healthchecks 定时任务监控告警](https://sct.ftqq.com/docs/integrations/healthchecks/)
- [changedetection.io 网页变更通知](https://sct.ftqq.com/docs/integrations/changedetection/)
- [Uptime Kuma 宕机告警](https://sct.ftqq.com/docs/integrations/uptime-kuma/)


## 懒人方案：把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手，它就会替你完成 Server酱 的接入：

```text
请帮我把 Server酱 微信通知接入到我当前的项目/工具中：
1. API：POST https://sctapi.ftqq.com/{SendKey}.send，参数 title（必填，不能含换行）、desp（正文，支持 Markdown，可选）；成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头，则改用 https://{uid}.push.ft07.com/send/{SendKey}.send，uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取；如果没有，提醒我到 https://sct.ftqq.com 免费获取（每天 5 条额度）。
4. 安全要求：不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定：任务结束发 1 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。
```