Skip to content

告警通知 ​

Podux 可以在服务器或代理出现异常时发送通知,恢复正常后再通知一次。在 设置 → 通知 中配置。

触发条件 ​

告警只针对正在运行的服务器。为了避免网络抖动和配置重载造成误报,都需要异常持续一段时间:

事件触发条件
服务器不可达连续 3 次延迟探测都连不上 frps
延迟过高连续 3 次探测延迟超过设定的阈值(阈值为 0 时不检查)
代理掉线已启用的代理离线超过 15 秒;同一服务器上同时掉线的多个代理合并成一条消息
代理外网不可达代理在 frpc 中在线,但连续 3 个完整服务器轮次的外部探测都连不上(通常约 3 分钟,取决于完整轮次;目标较多或响应较慢时会更久),见流量与可达性
frpc 意外退出frpc 不是由你停止而退出,例如启动时第一次登录 frps 失败
临时代理到期设置了有效期的代理到期并被自动停用
恢复通知上述问题恢复正常时再发送一条

延迟探测的间隔在 设置 → 常规 中修改(10–300 秒),"服务器不可达"和"延迟过高"的反应时间约为 3 个探测间隔。

每个问题只通知一次,直到恢复。手动停止服务器不会触发告警。

通知内容的语言跟随安装时选择的默认语言。

通知渠道 ​

可以同时开启多个渠道。修改后可以先点 发送测试,确认各渠道都能收到,再保存。

Webhook ​

向指定地址发送 POST 请求,支持四种格式:

格式说明
通用 JSON{"event", "title", "message", "serverId", "serverName", "time"},适合自己写脚本或接入 Home Assistant、n8n 等
企业微信机器人填写群机器人的 Webhook 地址
钉钉机器人填写自定义机器人的 Webhook 地址;安全设置请选择"自定义关键词",关键词填 Podux
飞书机器人填写自定义机器人的 Webhook 地址

通用 JSON 的 event 取值:server_unreachable、server_recovered、high_latency、latency_recovered、proxy_down、proxy_recovered、proxy_unreachable、proxy_reachable、proxy_expired、frpc_exited、test。

Telegram ​

填写 Bot Token(向 @BotFather 创建机器人获得)和 Chat ID。如果运行 Podux 的机器无法直连 api.telegram.org,可以在 API 地址 中填写反向代理或自建 Bot API 的地址。

Bark ​

填写 Bark App 中的 Device Key。使用自建 Bark 服务端时修改 服务器地址,默认为 https://api.day.app。

邮件 ​

使用 PocketBase 的发件设置。先在 PocketBase 管理后台(/_/)的 Settings → Mail settings 中配置发件人地址和 SMTP 服务器,再在 Podux 中填写收件人(多个地址用逗号分隔)。

WARNING

通知设置中的 Bot Token 等信息保存在数据目录的数据库里,请参考数据与备份保护好数据目录。

基于 Apache 2.0 协议开源