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

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 告警设置

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

## 配置告警消息通道



### 微信公众号

:::info\[说明]

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

1. 点击`配置`按钮，进入微信公众号配置页面。

![微信公众号配置](/img/user-guide/wechat-config.png)

2. 点击`添加`按钮，添加要通知的微信。

![微信公众号配置](/img/user-guide/wechat-add.png)

3. 扫描二维码，关注微信公众号并绑定账号。

![微信公众号配置](/img/user-guide/wechat-qrcode.png)

4. 扫码关注并绑定成功后，点击右上角的`×`关闭页面。

![微信公众号配置](/img/user-guide/wechat-success.png)

5. 返回到公众号配置页面，可以看到添加的微信。

![微信公众号配置](/img/user-guide/wechat-list.png)

### 邮箱

1. 点击`配置`按钮，进入邮箱配置页面。

![邮箱配置](/img/user-guide/email-config.png)

2. 点击`添加`按钮，添加要通知的邮箱。

![邮箱配置](/img/user-guide/email-add.png)

3. 输入邮箱相关信息。

![邮箱配置](/img/user-guide/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. 点击`确定`按钮，添加邮箱。

![邮箱配置](/img/user-guide/email-success.png)

5. 返回到邮箱配置页面，可以看到添加的邮箱。

![邮箱配置](/img/user-guide/email-list.png)

### 钉钉

## 创建机器人

可参考教程：

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

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

## 配置机器人

1. 点击`配置`按钮，进入钉钉配置页面。

![钉钉配置](/img/user-guide/dingtalk-config.png)

2. 点击`添加`按钮，添加要通知的钉钉机器人。

![钉钉配置](/img/user-guide/dingtalk-add.png)

3. 输入钉钉机器人相关信息。

获取机器人Webhook URL可参考教程：

[获取自定义机器人 Webhook 地址](https://open.dingtalk.com/document/orgapp/obtain-the-webhook-address-of-a-custom-robot)

![钉钉配置](/img/user-guide/dingtalk-send.png)

4. 点击`确定`按钮，添加钉钉机器人。

![钉钉配置](/img/user-guide/dingtalk-success.png)

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

![钉钉配置](/img/user-guide/dingtalk-list.png)

### 飞书

## 创建飞书机器人

可参考教程：

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

## 配置飞书机器人

1. 点击`配置`按钮，进入飞书配置页面。

![飞书配置](/img/user-guide/feishu-config.png)

2. 点击`添加`按钮，添加要通知的飞书机器人。

![飞书配置](/img/user-guide/feishu-add.png)

3. 输入飞书机器人相关信息。

获取机器人Webhook URL可参考教程：

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

![飞书配置](/img/user-guide/feishu-send.png)

4. 点击`确定`按钮，添加飞书机器人。

![飞书配置](/img/user-guide/feishu-success.png)

5. 返回到飞书配置页面，可以看到添加的飞书机器人。

![飞书配置](/img/user-guide/feishu-list.png)

### 企业微信

## 创建企业微信机器人

可参考教程：

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

## 配置企业微信机器人

1. 点击`配置`按钮，进入企业微信配置页面。

![企业微信配置](/img/user-guide/wecom-config.png)

2. 点击`添加`按钮，添加要通知的企业微信机器人。

![企业微信配置](/img/user-guide/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)

![企业微信配置](/img/user-guide/wecom-send.png)

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

![企业微信配置](/img/user-guide/wecom-success.png)

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

![企业微信配置](/img/user-guide/wecom-list.png)

### 短信

:::info\[说明]
短信告警通道需先在宝塔官网开通短信服务，请您联系客服购买咨询：[点击链接联系](https://www.bt.cn/new/wechat_customer)

- 企业版用户默认赠送1000条短信额度
- 其他用户请联系客服咨询购买事宜
- 短信告警默认发送到开通短信服务的手机号，即和宝塔账号绑定手机号相同，且目前不支持单独修改。
  :::

1. 查看短信服务开通情况。打开面板，在面板-设置-告警设置中查看短信额度。
   ![短信服务开通情况](/img/user-guide/sms-service-status.png)

2. 以 SSL 到期告警为例，配置短信通知，打开告警列表-添加任务。
   ![添加任务](/img/user-guide/sms-add-task.png)

3. 在添加任务页面，填写相关信息，并选择短信通知方式。
   ![配置短信通知](/img/user-guide/sms-configure-notification.png)

4. 点击`确定`按钮，保存短信通知配置。
   ![保存短信通知配置](/img/user-guide/sms-save-notification.png)

### 自定义消息通道

:::info\[说明]

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

## 功能说明

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

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

## 配置步骤

### 获取请求的URL

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

### 获取配置验证信息

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

### 填写信息并测试

1. **填写请求URL**
   - 确保URL包含所有必要的验证参数，格式示例：
   ```text
   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中配置好自定义消息通道后，点击“确定”无反应，控制台报错：

```text
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等主流浏览器并更新到最新版本。
- 若问题持续，可在宝塔论坛（原链接）反馈，附上详细环境信息和操作步骤，便于技术支持排查。

Source: https://docs.bt.cn/user-guide/config/alarm/alarm-settings/index.mdx