Server酱文档中心

Obico + Server酱：AI 检测 3D 打印失败时微信秒级告警

效果：Obico 的 AI 监控发现打印失败或其他异常时，自动通过 Server酱 推送告警到微信。

前置条件

  • Server酱 SendKey（30 秒获取教程），需 SCT 开头的 Turbo 版 Key
  • Obico 自托管版已部署运行（本方案仅适用于自托管版；官方托管版以其自带通知渠道为准）
  • 自托管服务端的通知框架基于 Apprise，无需额外安装依赖

配置步骤

schan://你的SENDKEY

在 Obico 自托管服务端的通知设置中配置 Apprise 通知，填入该地址。schan:// 是 Apprise 中 Server酱 的专用协议，底层调用 https://sctapi.ftqq.com/你的SENDKEY.send，SCT 开头的 SendKey 直接可用。

保存后，可用命令行自测验证通路是否正常：

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

终端输出中看到成功响应即表示配置正确。此后 Obico 的 AI 检测到打印失败或其他异常事件时，会自动通过该地址推送消息到微信。

如需同时推送到企业微信/钉钉/飞书群，可参考通道配置说明。通用 Apprise 接法详见 Apprise 接入 Server酱。

常见问题

免费额度够用吗？

Server酱 免费版每天 5 条，每分钟上限 50 条。3D 打印告警通常触发频率不高，免费额度一般够用。订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（价格详情）。

配置后没收到消息怎么办？

先用命令行 apprise -vv 自测排除网络问题；再检查 SendKey 是否 SCT 开头、是否完整复制。更多排查步骤见常见问题与排查。

自托管版和托管版有什么区别？

Apprise 通知能力仅自托管版可配。官方托管版使用其自带通知渠道，不支持自定义 Apprise 地址。

消息频率有限制吗？

Server酱 每分钟上限 50 条，会员每日 API 请求上限 1000 次。Obico 的告警事件通常不会触及此限制。

相关集成

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

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

请帮我把 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 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。