一、先记住一句话，理解全部功能
主动 = 我去查它；被动 = 它来告诉我。
面板里所有模式，本质就分这两类：
主动监控——CloudEye 每隔一段时间，自己跑去访问你的网站 / 端口 / 接口，看还活着没。
就像你每隔几分钟给朋友打个电话，打得通就正常。目标那边什么都不用配。
被动接收——CloudEye 自己不动，等着别的系统（Komari、哪吒探针）在出事时主动把消息推过来。
就像你不打电话，让朋友出事了自己给你发消息。你要做的是去那个系统后台，把 CloudEye 给的推送地址填进去。
记住这个区分，你就知道每个模式该怎么配了：
- 主动模式要填「监控地址」（我去访问哪）。
- 被动模式不填地址，反过来把 CloudEye 的地址填到探针后台。
二、不知道选哪个？照这个表对号入座
| 我想…… | 选这个模式 |
|---|---|
| 看我的网站 / API 活没活 | HTTP |
| 看某个端口（数据库、SSH、游戏服）通不通 | TCP |
| 定时跑个签到 / 保活 / 触发 GitHub Actions | 定时触发 |
| 到期前自动续期（要根据剩余时间智能安排） | 反馈联动 |
| 已经在用 Komari / 哪吒，想掉线时自动处理 | 对应的 Webhook 模式 |
拿不准？先用 HTTP。 90% 的基础监控需求它都能满足。
三、5 分钟加第一个监控（HTTP）
- 右上角点 「添加监控」
- 名称随便起，比如
我的博客 - 类型选
HTTP 检测（默认就是） - 地址填
https://example.com - 下面高级选项全部不用管，拉到底保存
搞定。绿色=正常，红色=故障。想收提醒？往下看 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 的都能接，填法一样。
有其他不懂的直接在下面问，我看到会回。也欢迎晒晒你用它自动化了啥
传送门
- 项目地址（点个 支持一下）：访问链接GitHub - debbide/monitoraContribute to debbide/monitora development by creating an account on GitHub.github.com
- 完整《使用指南》（含 GitHub Actions 实战样本、回调字段、排错表）：访问链接GitHub - debbide/monitoraContribute to debbide/monitora development by creating an account on GitHub.github.com
评论(0)