【保姆级】看完这篇你就会用了——CloudEye 监控面板从入门到接 GitHub Actions

上次发出来后，收到最多的反馈是——「看着不错，但不会用 / 不知道该选哪个模式」。

这其实不怪大家。这个面板功能有点多，第一次打开「添加监控」看到一堆类型确实会懵。但只要你搞懂一个核心概念，剩下的全都通了。

这篇就把这个概念讲透，再带你走一遍最常用的玩法。

一、先记住一句话，理解全部功能

主动 = 我去查它；被动 = 它来告诉我。

面板里所有模式，本质就分这两类：

🟢 主动监控——CloudEye 每隔一段时间，自己跑去访问你的网站 / 端口 / 接口，看还活着没。
就像你每隔几分钟给朋友打个电话，打得通就正常。目标那边什么都不用配。

🔵 被动接收——CloudEye 自己不动，等着别的系统（Komari、哪吒探针）在出事时主动把消息推过来。
就像你不打电话，让朋友出事了自己给你发消息。你要做的是去那个系统后台，把 CloudEye 给的推送地址填进去。

记住这个区分，你就知道每个模式该怎么配了：

• 主动模式要填「监控地址」（我去访问哪）。
• 被动模式不填地址，反过来把 CloudEye 的地址填到探针后台。

二、不知道选哪个？照这个表对号入座

拿不准？先用 HTTP。 90% 的基础监控需求它都能满足。

三、5 分钟加第一个监控（HTTP）

1. 右上角点 「添加监控」
2. 名称随便起，比如 我的博客
3. 类型选 HTTP 检测（默认就是）
4. 地址填 https://example.com
5. 下面高级选项全部不用管，拉到底保存

搞定。绿色=正常，红色=故障。想收提醒？往下看 Telegram 部分。

四、重头戏：和 GitHub Actions 联动

这才是这个面板最有价值的地方。很多人卡在这，我讲仔细点。

有两种玩法：

玩法 A：定时触发 Actions（签到 / 保活）
到点了，CloudEye 主动去戳 GitHub 跑你的 workflow。配置就填一个「触发 URL」+ 认证头 + Body：

• 触发 URL：https://api.github.com/repos/你的用户名/仓库名/dispatches
• Headers（三行）：

  Authorization: Bearer ghp_你的Token
  Accept: application/vnd.github+json
  X-GitHub-Api-Version: 2022-11-28
  

• Body：{"event_type": "my-task"}

workflow 里用 on: repository_dispatch: types: [my-task] 接收就行。

玩法 B：反馈联动（智能续期）
比玩法 A 多一步「回执」。脚本跑完，用 curl 把「还剩多少秒」告诉 CloudEye，它就能算出下次什么时候再触发，实现「快到期才续，不浪费」。

脚本结尾加这么一段就行：

curl -X POST "$CLOUDEYE_CALLBACK_URL" \
  -H "Content-Type: application/json" \
  -d '{"server_name": "my-service", "remaining_time": 2592000, "status": "success"}'

（server_name 要和监控里填的「匹配关键词」一致，回调地址在表单里点 📋 复制。）

⚠️ 被动模式也能触发 Actions！ 别以为 Komari / 哪吒只是转发消息——某台机器掉线时，CloudEye 能自动触发你配的 Webhook 去跑重启脚本。探针发现掉线 → 自动修复，全程无人管。

完整的 workflow.yml 样本、回调字段说明、排错表，《使用指南》 里都有，照着抄就行。

五、Telegram：不只是收通知，还能一键重跑

配好 Telegram（BotFather 建机器人拿 Token → 面板填 Token 和 Chat ID）后，通知消息底部带按钮：

• 🔄 立即重试：定时 / 联动任务失败了，手机上点一下就重跑，不用开电脑
• 🔄 重发 Webhook：告警来了但自动触发那次没成功，点一下再触发一次

签到挂了、服务器没重启成功，躺床上点一下就修好了。这是我自己用得最爽的功能。

六、几个最常见的卡点

Q：被动模式监控地址为什么留空？
不是 bug。被动模式是「等推送」，不是「去访问」，所以不填地址，反过来把 CloudEye 的推送地址填到探针后台。

Q：卡片一直显示「未知」？
被动模式 / 反馈联动在收到第一条推送 / 回调之前就是未知，正常。主动模式一直未知，检查地址填对没、能不能访问。

Q：回调返回 404？
脚本里的 server_name 和监控里的「匹配关键词」对不上，检查有没有写错或多空格。

Q：只能接 GitHub Actions 吗？
不。触发本质就是发个 HTTP 请求，GitLab CI、n8n、Serverless、飞书/Slack Webhook…… 任何支持 Webhook 的都能接，填法一样。

有其他不懂的直接在下面问，我看到会回。也欢迎晒晒你用它自动化了啥 👇

传送门

• 📦 项目地址（点个 ⭐ 支持一下）：https://github.com/debbide/monitora
• 📖 完整《使用指南》（含 GitHub Actions 实战样本、回调字段、排错表）：
  https://github.com/debbide/monitora/blob/main/使用指南.md