Telegram 通知
读者：希望通过手机即时收到节点告警的管理员。
将 Master 的告警与关键运维事件推送到 Telegram Bot，便于离线巡检。各套餐均包含此能力（见 套餐说明）。
1. 适用场景
Section titled “1. 适用场景”- Host 离线、资源超限、同步失败时手机推送
- 小团队无 7×24 值班，靠 Telegram 补位
- 与 节点观测与告警 规则配合
2. 前置条件
Section titled “2. 前置条件”- 在 Telegram 找 @BotFather 创建 Bot，获得 Bot Token
- 与 Bot 对话或拉入群组，获取 Chat ID（可用
@userinfobot或 getUpdates API） - Master 服务器能访问
api.telegram.org（出网 HTTPS）
3. 配置步骤
Section titled “3. 配置步骤”- 控制台 → 设置 → Telegram（或通知相关页）
- 填入 Bot Token、Chat ID
- 选择要推送的事件类型（告警、同步失败、授权临期等——以界面选项为准）
- 点击 发送测试消息，确认收到
- 保存
Bot Token 保存在 Master 设置中，勿泄露给他人。
4. 典型通知内容
Section titled “4. 典型通知内容”| 事件 | 示例 |
|---|---|
| 主机离线 | Host hk-01 offline > 5m |
| 资源告警 | CPU > 90% on us-02 |
| 同步失败 | Logical node sg-hy2 sync failed on host-3 |
| 全继承端口冲突 | 同一 Node Group 下多个面板 node_id 的 server_port 不一致（仅提醒，不拦同步） |
| 证书临期 / 续签失败 | ACME 自动续签失败或手动证书即将过期 |
| 授权临期 | License expires in 7 days |
消息格式与频率取决于当前版本实现；可在设置中调整静默期避免刷屏。
5. 注意事项
Section titled “5. 注意事项”- Telegram 不可作为唯一告警通道；重要环境建议叠加邮件 / 自建监控
- 群组 Chat ID 为负数；频道需 Bot 有发帖权限
- 防火墙封锁 Telegram 时推送失败，Master 日志会有 HTTP 错误
6. 常见问题
Section titled “6. 常见问题”Q：测试消息发不出？
A：Token 是否多余空格；Chat ID 是否正确；Master 出网是否受限。
Q：告警太多？
A：调高阈值、加长离线判定时间、对同一 Host 启用合并静默。