# Uptime Kuma 接入 Server酱：网站宕机微信告警（2026 教程）

> Uptime Kuma 自带 Server酱（ServerChan）通知类型：填入 SendKey 即可在网站宕机/恢复时收到微信告警，本文含完整配置步骤与排查。

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

# Uptime Kuma + Server酱：网站宕机，微信立刻告警

> 效果：Uptime Kuma 监控的站点宕机或恢复时，微信收到告警消息。Uptime Kuma **内置** Server酱通知类型，无需写任何代码。

## 前置条件

- 一个 Server酱Turbo SendKey（`SCT` 开头，[30 秒获取教程](https://sct.ftqq.com/docs/getting-started/sendkey/)）
- 已部署的 Uptime Kuma（1.x 及以上版本均内置 ServerChan 通知）

## 配置步骤

1. 打开 Uptime Kuma → 右上角头像 → **设置** → **通知**，点击**设置通知**。

<!-- 截图待补：uptime-kuma-step-1.png（设置→通知入口） -->

2. 通知类型选择 **ServerChan (Server酱)**，易记名称随意填（如"微信告警"）。

<!-- 截图待补：uptime-kuma-step-2.png（通知类型选择 ServerChan） -->

3. 在 **SendKey** 字段粘贴你的 SendKey，点击**测试**——微信应立刻收到测试消息，然后**保存**。

<!-- 截图待补：uptime-kuma-step-3.png（SendKey 填写与测试） -->

4. 回到监控项（或新建监控项），在**通知**区域勾选刚创建的"微信告警"。宕机（Down）与恢复（Up）都会推送。

先验证 SendKey 本身可用，可在服务器上执行：

```bash
curl -X POST "https://sctapi.ftqq.com/你的SENDKEY.send" \
  -d "title=Uptime Kuma 配置测试" -d "desp=SendKey 可用"
```

## 常见问题

**点"测试"没收到消息？**
先用上面的 curl 验证 SendKey；再检查当天免费额度（5 条/天）是否用完，以及服务器能否访问 `sctapi.ftqq.com`。完整排查见 [FAQ](https://sct.ftqq.com/docs/getting-started/faq/)。

**监控项很多，免费额度不够？**
免费每天 5 条。建议只给核心站点开启微信通知，或订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（[价格详情](https://sct.ftqq.com/subscribe)）。

**能用 Server酱³（sctp 开头）的 SendKey 吗？**
可以。Uptime Kuma 2.0 及以上版本的内置 ServerChan 通知类型已支持 Server酱³（`sctp` 开头）的 SendKey；直接填入即可。若你使用的是 2.0 以下的旧版本，则内置类型仅支持 Turbo（`SCT` 开头）端点，请升级到 2.0+ 后再使用 SC3 SendKey。

**告警风暴怎么办？**
在 Uptime Kuma 监控项中调大**重试次数**再告警，避免网络抖动误报；Server酱侧每分钟 50 条的限制也能兜底。

## 相关集成

- [Python 脚本推送微信通知](https://sct.ftqq.com/docs/integrations/python/)
- [Claude Code 任务完成微信通知](https://sct.ftqq.com/docs/integrations/claude-code/)
- [通道对比：告警也可以发到企业微信/钉钉群](https://sct.ftqq.com/docs/getting-started/channels/)


## 懒人方案：把这段话复制给你的 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 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。
```