宝塔面板对接企业微信钉钉实时推送故障告警
为什么需要对接企业微信或钉钉告警
服务器跑着业务，一旦磁盘爆满、进程挂掉或者CPU飙升，如果等到你手动登录宝塔面板检查，可能已经影响了用户。
宝塔面板自带的告警通知功能支持对接企业微信、钉钉等第三方机器人，故障消息能实时推送到团队群聊，运维人员第一时间就能看到并处理。
本文面向零基础用户，从创建机器人到配置告警通道，全程截图级说明，让你一次配通。
准备工作：获取Webhook地址
不管是用企业微信还是钉钉，原理都是通过群机器人提供一个Webhook地址，宝塔面板向这个地址发送POST请求，群聊就会弹出消息。
以下分别说明。
企业微信群机器人
- 打开企业微信，进入目标群聊的聊天窗口。
- 点击右上角“...”菜单，选择群机器人。
- 点击添加机器人，给机器人起个名字（例如“服务器告警”），然后点击添加。
- 复制生成的Webhook地址（形如
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxx）。
钉钉群机器人
- 打开钉钉，进入目标群聊的聊天窗口。
- 点击群设置 -> 智能群助手 -> 添加机器人。
- 选择自定义（通过Webhook接入），点击添加。
- 填写机器人名称和头像（可选），安全设置推荐勾选“加签”并保存密钥（后续宝塔配置需要填写），或者选择“自定义关键词”并输入“告警”等关键词（这样无需加签）。
- 复制Webhook地址（形如
https://oapi.dingtalk.com/robot/send?access_token=xxxx）。
要点：如果钉钉启用了“加签”安全方式，宝塔面板的告警通道需要额外填写“密钥”字段；如果只设关键词，则只需Webhook地址。建议新手先用关键词方式简单测试。
在宝塔面板添加告警通道
登录宝塔面板后台（建议使用最新稳定版），按以下路径操作：
- 左侧菜单栏点击 “通知”（或“系统” -> “通知”）。
- 在通知页面点击 “添加通知通道” 按钮。
- 通道类型选择 “企业微信” 或 “钉钉”（根据你的机器人）。
- 企业微信：填写名称（如“运维群”），粘贴上一步复制的Webhook地址。
- 钉钉：填写名称、Webhook地址；如果设置了加签，还需要填写生成的密钥。
- 点击 “测试” 按钮，如果群聊收到一条“宝塔面板通知测试”消息，说明通道配置成功。
- 点击 “保存” 完成通道添加。
! text=请替换为实际截图" target="_blank" rel="noopener noreferrer">宝塔通知通道配置示意图
配置故障告警规则
通道添加完成后，需要指定哪些事件触发推送。
同样在“通知”页面：
- 点击 “告警设置”（或“规则管理”）。
- 宝塔面板默认有多条监控规则（如磁盘使用率超过90%、CPU使用率超过90%、内存使用率超过90%、网站状态码异常等）。你可以开启需要的规则，或点击 “添加告警规则” 自定义。
- 编辑规则时，在“通知通道”下拉中选择刚才创建的企业微信/钉钉通道。
- 建议将 “触发间隔” 设为至少5分钟，避免频繁推送造成刷屏。
- 保存规则后，宝塔面板会按照设定周期检测，一旦满足条件，立即向群聊推送告警。
避坑指南与高频问题
- Webhook地址粘贴错误：地址必须完整，不能有空格或换行。企业微信地址含特殊字符，直接复制即可。
- 钉钉安全设置导致推送失败：如果启用了加签，宝塔面板的密钥字段必须输入正确，且注意密钥不包含
- 宝塔版本过低：部分旧版（如6.x）的“通知”功能入口不同，建议升级到7.x或8.x。升级前先备份面板数据和网站。
- 告警未触发：检查规则是否启用、通道是否选择正确、监控项是否真的超过了阈值。可手动模拟：临时降低磁盘阈值（如设成10%），看是否收到消息。
- 消息格式乱码或为空：宝塔默认推送纯文本，如果使用钉钉自定义关键词“告警”，确保消息正文包含“告警”二字。宝塔面板的默认模板基本都包含，无需改动。
验证效果：模拟一次告警
完成配置后，推荐做一次真实验证：
- 在宝塔面板“告警设置”中，新建一条临时规则：磁盘使用率 > 10%（正常情况下很容易触发）。
- 等待不到2分钟，企业微信或钉钉群聊应收到类似以下消息：
【宝塔面板】
告警级别：警告
告警对象：磁盘使用率
告警详情：当前值 35%，阈值 10%
服务器：your-server-ip
时间：2025-03-15 10:30:00- 确认收到后，删除这条临时规则，恢复你需要的正常阈值。
如果未收到，返回检查通道测试是否成功、规则是否启用、Webhook和密钥是否正确。
总结
宝塔面板对接企业微信或钉钉告警后，你再也不用每天登录面板查看状态。
故障一旦出现，群消息立刻推送，团队协作效率提升明显。
建议根据实际服务器配置合理设置阈值（例如磁盘80%、内存85%），避免误报或漏报。
遇到其他异常时，优先检查Webhook地址和密钥，这两步最容易出错。
如果你正在处理此类配置，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。
