# 告警设置

> 在宝塔面板（BT Panel）「设置 → 告警设置」配置告警消息通道，支持微信公众号、邮箱、钉钉、企业微信、飞书、Webhook 等多种通道，统一接收服务器、站点与服务告警通知。

# 告警设置

本文将介绍如何配置告警消息通道。

## 配置告警消息通道

  :::info[说明]
   - 微信公众号通知在改版后会出现被折叠的问题，使用该方式通知可能无法及时收到告警。
  :::

  1. 点击`配置`按钮，进入微信公众号配置页面。
   
  ![微信公众号配置](https://docs.bt.cn/img/wechat-config.png)

  2. 点击`添加`按钮，添加要通知的微信。
   
  ![微信公众号配置](https://docs.bt.cn/img/wechat-add.png)

  3. 扫描二维码，关注微信公众号并绑定账号。
   
  ![微信公众号配置](https://docs.bt.cn/img/wechat-qrcode.png)

  4. 扫码关注并绑定成功后，点击右上角的`×`关闭页面。
   
  ![微信公众号配置](https://docs.bt.cn/img/wechat-success.png)

  5. 返回到公众号配置页面，可以看到添加的微信。
   
  ![微信公众号配置](https://docs.bt.cn/img/wechat-list.png)

  1. 点击`配置`按钮，进入邮箱配置页面。
   
  ![邮箱配置](https://docs.bt.cn/img/email-config.png)

  2. 点击`添加`按钮，添加要通知的邮箱。
   
  ![邮箱配置](https://docs.bt.cn/img/email-add.png)

  3. 输入邮箱相关信息。
   
  ![邮箱配置](https://docs.bt.cn/img/email-send.png)

  QQ邮箱开启SMTP可参考教程：

  [如何打开POP3/SMTP/IMAP功能？](https://service.mail.qq.com/detail/128/428)

  [QQ邮箱的POP3与SMTP服务器是什么？](https://service.mail.qq.com/detail/0/427)

  网易邮箱开启SMTP可参考教程：

  [如何开启客户端协议？](https://help.mail.163.com/faqDetail.do?code=d7a5dc8471cd0c0e8b4b8f4f8e49998b374173cfe9171305fa1ce630d7f67ac2a5feb28b66796d3b)

  [如何开启POP3/SMTP/IMAP服务？](https://help.mail.163.com/faqDetail.do?code=367)

  4. 点击`确定`按钮，添加邮箱。
   
  ![邮箱配置](https://docs.bt.cn/img/email-success.png)

  5. 返回到邮箱配置页面，可以看到添加的邮箱。
   
  ![邮箱配置](https://docs.bt.cn/img/email-list.png)

  ## 创建机器人

  可参考教程：

  [创建自定义机器人](https://open.dingtalk.com/document/orgapp/custom-bot-creation-and-installation)

  - 机器人安全设置可选择IP地址，并填入服务器IP地址。

  ## 配置机器人

  1. 点击`配置`按钮，进入钉钉配置页面。
   
  ![钉钉配置](https://docs.bt.cn/img/dingtalk-config.png)

  2. 点击`添加`按钮，添加要通知的钉钉机器人。
   
  ![钉钉配置](https://docs.bt.cn/img/dingtalk-add.png)

  3. 输入钉钉机器人相关信息。
   
  获取机器人Webhook URL可参考教程：

  [获取自定义机器人 Webhook 地址](https://open.dingtalk.com/document/orgapp/obtain-the-webhook-address-of-a-custom-robot)
   
  ![钉钉配置](https://docs.bt.cn/img/dingtalk-send.png)
   
  4. 点击`确定`按钮，添加钉钉机器人。
  
  ![钉钉配置](https://docs.bt.cn/img/dingtalk-success.png)

  5. 返回到钉钉配置页面，可以看到添加的钉钉机器人。
   
  ![钉钉配置](https://docs.bt.cn/img/dingtalk-list.png)

  ## 创建机器人

  可参考教程：

  [在群组中添加自定义机器人](https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot#399d949c)

  ## 配置机器人

  1. 点击`配置`按钮，进入飞书配置页面。
   
  ![飞书配置](https://docs.bt.cn/img/feishu-config.png)

  2. 点击`添加`按钮，添加要通知的飞书机器人。
   
  ![飞书配置](https://docs.bt.cn/img/feishu-add.png)

  3. 输入飞书机器人相关信息。
   
  获取机器人Webhook URL可参考教程：
  
  [在群组中添加自定义机器人](https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot#399d949c)
   
  ![飞书配置](https://docs.bt.cn/img/feishu-send.png)
   
  4. 点击`确定`按钮，添加飞书机器人。
  
  ![飞书配置](https://docs.bt.cn/img/feishu-success.png)
  
  5. 返回到飞书配置页面，可以看到添加的飞书机器人。
   
  ![飞书配置](https://docs.bt.cn/img/feishu-list.png)

  ## 创建机器人

  可参考教程：

  [如何设置群机器人](https://open.work.weixin.qq.com/help2/pc/14931)

  ## 配置机器人

  1. 点击`配置`按钮，进入企业微信配置页面。
   
  ![企业微信配置](https://docs.bt.cn/img/wecom-config.png)

  2. 点击`添加`按钮，添加要通知的企业微信机器人。
   
  ![企业微信配置](https://docs.bt.cn/img/wecom-add.png)

  3. 输入企业微信机器人相关信息。
   
  获取机器人Webhook URL可参考教程：
  
  [群机器人Webhook地址](https://open.work.weixin.qq.com/help2/pc/14931#%E5%85%AD%E3%80%81%E7%BE%A4%E6%9C%BA%E5%99%A8%E4%BA%BAWebhook%E5%9C%B0%E5%9D%80)

  ![企业微信配置](https://docs.bt.cn/img/wecom-send.png)

  4. 点击`确定`按钮，添加企业微信机器人。

  ![企业微信配置](https://docs.bt.cn/img/wecom-success.png)

  5. 返回到企业微信配置页面，可以看到添加的企业微信机器人。

  ![企业微信配置](https://docs.bt.cn/img/wecom-list.png)
   

> **说明**
   - 本教程适用于宝塔Linux面板9.5.0及以上版本。
   - 若面板非此版本，需到面板首页右上角点击更新按钮，将面板更新到最新版本。
:::
## 功能说明

宝塔告警模块中的自定义消息通道允许用户根据自身需求配置信息，并通过网络请求的方式传递信息。支持通过自定义的Webhook URL发送告警信息，类似设置钉钉机器人、企业微信应用等第三方通知服务。

用户可指定一个HTTP/HTTPS请求地址，系统会自动向该地址发送包含告警详情的数据，从而将服务器状态变化即时同步到自己习惯使用的沟通平台，便于及时响应和处理问题。

## 配置步骤

### 获取请求的URL

1. **使用第三方服务**（如飞书机器人）：先在飞书中创建一个机器人，获取其Webhook URL。
2. **使用自建服务**：确保自建服务已启动，并提供可接收http/https请求的URL。

### 获取配置验证信息

若服务需要在请求头中添加验证信息（如API密钥或Token），需提前准备好这些信息。

### 填写信息并测试

1. **填写请求URL**
    - 确保URL包含所有必要的验证参数，格式示例：
    ```
    https://oapi.dingtalk.com/robot/...?access_token=your_access_token_here
    ```
2. **配置自定义请求内容**
    - 宝塔告警信息包含3个文本格式字段：`title`（告警标题）、`msg`（告警内容）、`type`（告警类型），可用`$title`、`$msg`、`$type`表示并填充到自定义模板中。
    - **默认格式**（不配置时使用）：
    ```json
    {
        "title": "$title",
        "msg": "$msg",
        "type": "$type"
    }
    ```
3. **配置请求头**
    - 若服务要求在HTTP请求头中添加验证信息（如Authorization），可在宝塔面板的自定义消息通道配置中指定请求头，示例：
    ```json
    {
        "Authorization": "JWT your_token_here"
    }
    ```
4. **保存配置并测试**
    - 保存配置时，系统会自动发送一条告警信息，用于测试是否能顺利发送。

## 常见问题

### 问题现象

在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
```

### 问题描述

部分用户在9.5.0版本中遇到保存配置时无响应且控制台报错的情况，多台设备测试均出现此问题。

### 建议处理

- 检查面板版本是否为最新（9.5.0及以上），可尝试重新安装或更新面板。
- 确认浏览器兼容性，建议使用Chrome、Firefox等主流浏览器并更新到最新版本。
- 若问题持续，可在宝塔论坛（原链接）反馈，附上详细环境信息和操作步骤，便于技术支持排查。