自定义消息通道使用指南

自定义消息通道使用指南

****注意****本教程适用于堡塔Linux面板9.5.0版本，如果您的面板不是这个版本，请到面板首页右上角点击更新按钮来获取更新到最新版本

宝塔告警模块中的自定义消息通道是什么？
  宝塔告警模块中的自定义消息通道允许用户根据自身需求配置信息，并通过网络请求的方式传递信息。它支持通过自定义的Webhook URL来发送告警信息，类似于设置钉钉机器人、企业微信应用等第三方通知服务。
  您可以指定一个HTTP/HTTPS请求地址，由系统自动向这个地址发送包含告警详情的数据。这样做的好处是让您能够将服务器的状态变化即时同步到自己习惯使用的沟通平台上，便于及时响应和处理问题。

如何配置自定义消息通道？

  A. 获取请求的URL：
    1. 如果您使用的是第三方服务（如飞书机器人），请先在中飞书创建一个机器人，并获取其Webhook URL
    2. 如果您使用的是自己启动的服务，请确保该服务已经启动并提供了一个可以接收http/https请求的URL
  B. 获取配置验证信息
    1. 如果服务需要在请求头中添加验证信息（如API密钥或Token），请确保您有这些信息
  C. 填写信息并测试
    1. 填写请求URL，确保URL包含所有必要的验证参数，形如：
https://oapi.dingtalk.com/robot/ ... r_access_token_here
    2. 配置自定义请求内容
      宝塔打包的告警信息包含3个字段[title,msg,type]，分别指代告警标题，告警内容和告警类型，且都是文本格式，可用$title, $msg, $type 表示并填充到您自定义的模板中。如果您不作配置将会以默认格式进行发送，默认形式如下：

1. {
   
2.    "title": "$title",
   
3.    "msg": "$msg",
   
4.    "type": "$type"
   
5. }

复制代码

    3. 配置请求头
      如果服务要求在HTTP请求头中添加验证信息（如Authorization），您可以在宝塔面板的自定义消息通道配置中指定请求头，例如：

1.      {
   
2.        "Authorization": "JWT your_token_here"
   
3.      }

复制代码

    4. 保存配置，同时会发送一条告警信息，测试是否能够顺利发送

详细案例：
  1. 背景：
    1.1. 我自己部署了一个服务接收告警信息，这个服务的访问地址是http://192.168.69.154:8417/，当接收到信息后可以打印到日志中

  2. 添加
    2.1. 默认格式添加，不指定$title, $msg, $type这些字段，此时添加会收到以下信息


   2.2.通过自定参数的格式添加，指定$title, $msg, $type这些字段，并测试信息

1. {
   
2.   "name": "API通知",
   
3.   "version": "1.0",
   
4.   "token": "your token",
   
5.   "content": "这是信息内容--->\n$msg\n<---------",
   
6.   "msg_type": "这是信息标题和信息类型--->\n$title\n$type\n<---------"
   
7. }

复制代码

Linux面板9.5.0,配置好之后点确定没反应，控制台报错
Uncaught TypeError: Cannot read properties of undefined (reading 'domQueryService')
    at checkPageContainsShadowDom (bootstrap-autofill.js:1857:14)
    at bootstrap-autofill.js:334:53