在Uptime-Kuma中通过USB GSM设备发送告警通知

概述

Uptime-Kuma作为一款开源的监控工具，提供了多种告警通知方式。本文将详细介绍如何通过USB连接的GSM设备（如GSM调制解调器或4G/LTE USB Dongle）来实现消息提醒功能。

技术背景

USB GSM设备通常会被系统识别为串行设备（如/dev/ttyUSB0或/dev/ttyACM0），可以通过AT指令集来控制发送消息。这类设备在无网络连接环境下特别有用，可以作为独立的告警通道。

实现方案

方案一：使用Push Monitor结合脚本

Uptime-Kuma的Push Monitor功能可以执行外部脚本，这是最直接的集成方式：

1. 编写一个bash脚本，使用工具如gammu或mmcli与GSM设备交互
2. 脚本接收监控数据并通过AT指令发送消息
3. 在Uptime-Kuma中配置Push Monitor调用该脚本

示例脚本框架：

#!/bin/bash
# 从环境变量获取告警信息
MESSAGE="$UPTIME_KUMA_MONITOR_NAME - $UPTIME_KUMA_MONITOR_STATUS"

# 使用gammu发送消息
echo "$MESSAGE" | gammu --sendsms TEXT 13800138000

方案二：通过Webhook间接调用

如果更倾向于使用Webhook方式：

1. 搭建一个简单的HTTP服务（如Flask或Node.js应用）
2. 该服务接收Webhook请求并调用本地GSM发送程序
3. 在Uptime-Kuma中配置Webhook通知指向该服务

设备准备

确保GSM设备已正确安装驱动并被系统识别：

1. 插入设备后检查dmesg输出
2. 确认设备节点（通常为/dev/ttyUSB*）
3. 安装必要的工具链（如gammu、wvdial等）

配置建议

1. 权限管理：确保运行Uptime-Kuma的用户有访问串行设备的权限
2. 错误处理：在脚本中添加重试机制和设备状态检查
3. 日志记录：记录发送状态以便排查问题
4. 节流控制：避免短时间内发送过多消息

注意事项

1. 不同型号的GSM设备可能需要特定的AT指令
2. 考虑SIM卡的消息余额和发送限制
3. 在Docker环境中运行时，需要将设备挂载到容器中
4. 某些地区可能对消息发送有合规性要求

扩展应用

此方案不仅适用于Uptime-Kuma，也可应用于其他需要消息提醒的场景。通过适当修改，还可以实现：

• 语音告警
• USSD查询
• 设备状态反馈

总结

通过USB GSM设备实现消息提醒为Uptime-Kuma提供了一种不依赖互联网的可靠通知方式，特别适合关键基础设施监控或网络不稳定环境。虽然需要一些额外的配置工作，但其独立性和可靠性使其成为值得考虑的备选方案。