Lucky网络异常告警配置：邮件、Webhook通知，实时故障响应

一、告警配置总览

Lucky作为软硬路由公网神器，提供了DDNS动态域名解析、端口转发、反向代理等核心功能。当网络发生异常（如DDNS解析失败、端口转发连接中断）时，及时的告警通知能帮助管理员快速响应。本文将详细介绍如何配置Lucky的邮件通知与Webhook告警功能，实现故障的实时监控与处理。

配置文件结构可参考config/config.go，其中ProgramConfigure结构体包含了系统所有核心配置项，包括DDNS、端口转发等模块的告警相关参数。

二、Webhook告警配置

Webhook是实现第三方系统集成的常用方式，Lucky通过回调接口支持将告警信息推送到企业微信、钉钉、Slack等平台。

2.1 配置参数说明

在DDNS任务配置中，可通过Callback结构体定义Webhook参数，关键字段包括：

• URL：回调接口地址，支持动态参数替换（如#{ip}、#{domain}）
• Method：HTTP请求方法（GET/POST）
• RequestBody：请求体内容，支持变量替换
• Headers：自定义请求头
• CallbackSuccessContent：成功响应特征字符串

相关实现逻辑可参考module/ddns/providers/callback.go中的createUpdateDomain函数，该函数负责动态替换URL与请求体中的参数：

url := replacePara(cb.task.DNS.Callback.URL, ipAddr, domain, recordType, cb.TTL)
requestBody := replacePara(cb.task.DNS.Callback.RequestBody, ipAddr, domain, recordType, cb.TTL)

2.2 动态参数列表

支持的变量替换参数如下表：

参数名	说明	示例
#{ip}	当前解析IP地址	192.168.1.100
#{domain}	域名	example.com
#{recordType}	记录类型	A/AAAA
#{ttl}	DNS记录TTL值	600

2.3 配置示例（企业微信机器人）

1. 进入企业微信群机器人设置，获取Webhook地址
2. 在DDNS任务中配置：
   • URL：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_key
   • Method：POST
   • RequestBody：

     {
       "msgtype": "text",
       "text": {
         "content": "DDNS更新通知：#{domain} -> #{ip}"
       }
     }
     

   • Headers：Content-Type: application/json
   • CallbackSuccessContent："errcode":0

三、日志监控与告警联动

Lucky的日志系统记录了所有关键操作与错误信息，通过监控日志可实现异常检测。日志配置位于config/config.go的BaseConfigure结构体：

type BaseConfigure struct {
    LogMaxSize int `json:"LogMaxSize"` //日志记录最大条数
}

建议将日志最大条数设置为4096（默认2048），以便保留更多历史记录。日志查看界面位于Web管理后台的Log模块，界面效果可参考预预览图previews/iphistroy.png。

四、配置步骤总结

1. 准备工作：获取Webhook接口地址（如企业微信机器人、钉钉机器人）
2. 配置DDNS任务：在DDNSTaskList数组中添加Callback配置
3. 测试验证：手动触发DDNS更新，检查回调是否生效
4. 日志监控：通过Web界面或日志文件监控告警触发情况

五、常见问题排查

1. 回调失败：检查module/ddns/providers/callback.go中的CallbackHttpClientDo函数输出，确认HTTP请求状态码与响应内容
2. 参数替换异常：通过日志查看替换后的实际URL与请求体
3. 网络连通性：检查Lucky服务器是否能访问目标Webhook地址，可通过telnet命令测试端口连通性

六、高级应用场景

6.1 多渠道通知

可通过配置多个DDNS任务实现多Webhook并行通知，或在回调接口中集成消息转发服务（如同时推送企业微信与短信）。

6.2 告警抑制

通过CallbackSuccessContent字段设置成功响应特征，避免重复告警。例如配置"errcode":0仅在接口调用成功时不触发错误告警。

6.3 自定义监控指标

结合Lucky的端口转发日志previews/relayrules.png，可监控异常连接尝试，通过Webhook推送安全告警。

七、配置文件示例

完整的DDNS任务配置示例（含Webhook）：

{
  "DDNSTaskList": [
    {
      "DNS": {
        "Provider": "callback",
        "Callback": {
          "URL": "https://api.example.com/alert",
          "Method": "POST",
          "RequestBody": "{\"domain\":\"#{domain}\",\"ip\":\"#{ip}\"}",
          "Headers": ["Content-Type: application/json"],
          "CallbackSuccessContent": ["success"]
        }
      },
      "DomainList": ["example.com"],
      "RecordType": "A"
    }
  ]
}

通过以上配置，Lucky将在DDNS记录更新时自动触发Webhook通知，实现网络异常的实时响应。如需进一步扩展告警能力，可参考module/ddns/ddnscore.go中的任务调度逻辑，添加自定义告警触发条件。