服务器企业微信告警搭建：从零配置到收到第一条消息

知识分享

2026-10-14 22:00

9 阅读

服务器企业微信告警的核心思路只有一句话：在企业微信群里创建一个机器人，拿到它的 Webhook 地址，然后让服务器上的脚本或监控系统往这个地址发一条 HTTP 请求。
整个过程不需要企业微信管理员后台的复杂审批，普通群成员就能完成。
下面按顺序讲清楚准备、操作、避坑和验证。

先确认你的环境能发出去请求

动手前先满足三个条件，否则后面会卡住：

服务器能访问公网，企业微信 Webhook 走的是 HTTPS。可以用 curl -I https://qyapi.weixin.qq.com 测试，能返回状态码就说明网络通。
服务器上要有 curl，绝大多数 Linux 发行版自带；没有的话用 yum install curl 或 apt install curl 安装。
你有一个企业微信内部群，能添加群机器人。外部群、微信用户群不支持这个功能。

如果服务器在公司内网且不能直连公网，需要先配置代理，否则 Webhook 请求会超时。

拿到群机器人的 Webhook 地址

这一步在企业微信客户端里完成，不在服务器上：

打开目标企业微信群，点右上角群设置。
找到“群机器人”，点“添加机器人”。
给机器人起个名字，比如“服务器告警”，确认后会出现一个 Webhook 地址。
复制这个地址，格式类似 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx。

这个 key 就是身份凭证，谁拿到都能往群里发消息，所以不要把它提交到公开的 Git 仓库，也不要发在聊天记录里。

用一条命令验证告警能不能通

先别急着写脚本，用最简单的 curl 确认链路可用。
把下面的 URL 换成你自己的 Webhook 地址：

curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "msgtype": "text",
    "text": {
      "content": "服务器测试告警：链路正常"
    }
  }'

执行后如果群里立刻出现这条消息，说明服务器到企业微信的通道没问题。
返回内容里 errcode 为 0 表示成功，其他值代表失败，常见的有：

93000：Webhook 地址无效，检查 key 是否复制完整。
45009：发送频率超限，企业微信机器人有每分钟消息条数限制，告警太频繁会被限流。
40001：请求体格式不对，多半是 JSON 写错了。

封装成可复用的告警脚本

每次都手写 curl 不现实，把它做成脚本，其他监控程序直接调用。
在服务器上建一个文件，比如 /usr/local/bin/wechat-alert.sh：

#!/bin/bash
WEBHOOK='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的KEY'
MESSAGE="$1"
curl -s "$WEBHOOK" \
  -H 'Content-Type: application/json' \
  -d "{\"msgtype\":\"text\",\"text\":{\"content\":\"$MESSAGE\"}}"

保存后赋予执行权限：

chmod +x /usr/local/bin/wechat-alert.sh

之后任何脚本只要执行 wechat-alert.sh "磁盘使用率超过90%" 就能发消息。
做定时任务时，把这条命令写进 crontab 即可。

接入常见监控系统

如果你已经在用 Zabbix、Prometheus 或宝塔面板，不用自己从零写脚本，它们都支持 Webhook 类型的告警媒介：

Zabbix：在“管理—媒介类型”里新建 Webhook，把发送逻辑替换成对企业微信 Webhook 的调用，再在“用户—报警媒介”里绑定。
Prometheus + Alertmanager：在 alertmanager.yml 的 receivers 里配置 webhook_configs，指向一个能转发到企业微信的中间服务，或者直接用支持企业微信的告警网关。
宝塔面板：在“监控—告警设置”里选择企业微信，粘贴 Webhook 地址，按需勾选 CPU、内存、磁盘等触发项。

不同版本的面板路径可能略有差异，找不到时优先看对应面板的告警或通知设置菜单。

容易踩的几个坑

消息发出去了但群里没显示：先看 curl 的返回内容，errcode 不为 0 就是被拒了，别只看命令有没有报错。

告警刷屏被限流：企业微信机器人对发送频率有限制，磁盘、CPU 这类抖动指标要加持续时长判断，比如连续 5 分钟超过阈值才发，避免一分钟几十条。

脚本里变量带空格或特殊字符：上面示例的 JSON 拼接方式在消息含引号时会出错，正式使用建议用 jq 或 Python 构造 JSON，比字符串拼接稳。

Webhook key 泄露：一旦发现 key 外泄，在群机器人设置里删除重建，旧地址立即失效。

怎么确认告警真的生效

配完之后不要只测一次就结束。
建议做两件事：一是手动触发一次真实告警，比如临时把磁盘阈值调低，确认能收到；
二是等一天，观察是否出现重复刷屏或该报不报。
日志方面，Zabbix 可以在“报表—动作日志”里看发送记录，自定义脚本可以在 curl 后面加 >> /var/log/wechat-alert.log 记录每次调用结果。

只要 Webhook 地址正确、服务器能访问公网、消息频率控制在限制内，服务器企业微信告警就是一个上午能跑通的事情。
遇到不生效时，按“curl 手动测试 → 看 errcode → 检查网络和 key”这个顺序排查，基本都能定位。

服务器钉钉机器人告警配置：从创建群机器人到脚本触发

服务器飞书告警配置：零基础对接自定义机器人