Uptime Kuma 监控通知全攻略：Telegram、飞书、企业微信、PagerDuty 深度配置

Uptime Kuma 监控通知全攻略Telegram、飞书、企业微信、PagerDuty 深度配置Uptime Kuma 是一款轻量好用的开源监控工具但很多用户在完成基础部署后便止步于此并未充分利用其强大的通知体系和状态页定制能力。本文在基础部署的基础上深入讲解如何配置多渠道告警通知、自定义状态页域名与 HTTPS、公开状态页嵌入以及通过监控组对服务进行分类管理帮助你将 Uptime Kuma 打造成一套真正生产可用的可观测平台。环境要求本教程推荐使用雨云服务器 rainyun-com作为部署环境。注册填优惠码2026off领 5 折优惠券让监控服务的运营成本降到最低。推荐配置1 核 2GB 内存机型。Uptime Kuma 极其轻量单实例监控 100 个以上节点仅需不到 200MB 内存1 核 2GB 完全胜任将余量留给未来拓展。参数推荐值CPU1 核内存2 GB磁盘20 GB SSD系统Ubuntu 22.04 LTS / Debian 12前置准备Docker 与 Docker Compose 已安装curl-fsSLhttps://get.docker.com|bashdocker--version域名已解析准备两个子域名分别用于 Uptime Kuma 管理后台和公开状态页如monitor.example.com和status.example.com。Nginx Proxy Manager 或 Traefik 已部署用于处理 HTTPS 证书自动申请与反向代理。Telegram Bot Token可选若使用 Telegram 通知渠道需提前通过 BotFather 创建 Bot。部署步骤第一步Docker Compose 部署 Uptime Kuma# /opt/uptime-kuma/docker-compose.ymlversion:3.8services:uptime-kuma:image:louislam/uptime-kuma:latestcontainer_name:uptime-kumarestart:unless-stoppedports:-3001:3001volumes:-./data:/app/dataenvironment:-UPTIME_KUMA_PORT3001启动服务mkdir-p/opt/uptime-kumacd/opt/uptime-kumadockercompose up-d浏览器访问http://服务器IP:3001完成初始账号注册。第二步配置反向代理与 HTTPS以 Nginx Proxy Manager 为例添加代理主机Domain Namesmonitor.example.comSchemehttpForward Hostnameuptime-kumaForward Port3001SSL勾选 “Request a new SSL Certificate”勾选 “Force SSL”状态页同理单独配置status.example.com代理到同一后端Uptime Kuma 内置状态页服务。核心功能通知渠道配置进入 Uptime Kuma 后台 →Settings→Notifications→Setup Notification。Telegram 通知配置在 Telegram 与 Bot 的对话中发送任意消息然后访问https://api.telegram.org/botYOUR_TOKEN/getUpdates获取chat_id。Uptime Kuma 中选择类型为Telegram填入Bot TokenBotFather 给的 TokenChat ID你的 chat_id群组 ID 为负数点击Test验证能收到测试消息后保存。飞书通知配置飞书使用 Webhook 机器人方式接入在飞书群中添加自定义机器人复制 Webhook URL格式https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx。Uptime Kuma 中选择类型为Feishu或Lark填入 Webhook URL。若飞书机器人开启了签名校验还需填入 Secret KeyUptime Kuma 会自动处理 HMAC-SHA256 签名。发送的告警消息格式示例[DOWN] 服务名称 - HTTP 502 持续时间: 3 分钟 URL: https://your-service.com 时间: 2026-05-23 14:32:10企业微信通知配置企业微信支持两种接入方式方式一企业微信群机器人推荐在企业微信群中 → 添加群机器人 → 复制 Webhook URL。Uptime Kuma 选择WeCom类型填入 Webhook URL类型选择群机器人。方式二企业微信应用推送需要企业微信管理员权限配置相对复杂适合需要推送到个人账号的场景企业 ID (CorpID): wx1234567890abcdef 应用密钥 (CorpSecret): your_corp_secret 应用 ID (AgentID): 1000001 接收成员: all 或指定用户名PagerDuty 通知配置PagerDuty 适合需要值班轮转和升级策略的企业场景在 PagerDuty 控制台创建Service→ 选择集成类型Uptime Kuma或通用 Events API v2→ 复制Integration Key。Uptime Kuma 选择PagerDuty类型填入Integration Key从 PagerDuty 复制的 KeyAuto Resolve建议开启服务恢复时自动关闭 PagerDuty 告警配置 PagerDuty 端的值班计划和升级策略实现告警 5 分钟未处理自动升级。进阶配置状态页自定义域名与 HTTPSUptime Kuma 内置多状态页支持每个状态页可配置独立域名后台 →Status Pages→New Status Page→ 填写页面名称和 Slug如public。在Custom Domain字段填入status.example.com。在 DNS 提供商处将status.example.com解析到服务器 IP。在 Nginx Proxy Manager 中为status.example.com配置反向代理指向uptime-kuma:3001并申请 SSL 证书。Uptime Kuma 会识别请求的Host头自动展示对应状态页。公开状态页嵌入状态页支持通过iframe嵌入到你的官网或文档站iframesrchttps://status.example.comwidth100%height600frameborder0scrollingauto/iframe若只需嵌入摘要徽章可使用 Uptime Kuma 提供的徽章 API 监控组分类管理Uptime Kuma 支持通过Tags标签对监控项进行分组并在状态页上按组展示后台 →Tags→ 创建标签如生产环境、数据库、API 服务、CDN。编辑每个监控项在Tags字段添加对应标签。在状态页配置中将监控项按标签分组展示用户可清晰看到各类服务的健康状态。告警静默策略在版本 1.22 中Uptime Kuma 支持维护窗口Maintenance后台 →Maintenance→New Maintenance。配置维护时间段支持一次性和循环计划。将需要静默的监控项关联到该维护窗口维护期间不发送告警通知。心跳监控Push 模式除 HTTP/TCP/Ping 等主动探测模式外Uptime Kuma 还支持心跳Heartbeat模式适合监控定时任务新建监控 → 类型选Push。复制生成的 Push URL格式https://monitor.example.com/api/push/xxxxxx?statusupmsgOK。在 Cron 任务末尾添加 curl 调用02* * * /path/to/backup.shcurl-fsShttps://monitor.example.com/api/push/xxxxxx?statusupmsgOKping/dev/null若任务失败curl 未被调用Uptime Kuma 在超时后自动标记为 DOWN 并触发告警。常见问题Q配置了通知渠道但收不到告警如何排查A先点击通知配置页的Test按钮确认通知渠道本身可用。若测试成功但真实告警不发送检查监控项的Notification字段是否关联了对应渠道。同时确认Heartbeat Interval和Retries配置避免因重试机制导致的延迟。Q飞书机器人 Webhook 提示sign error。A飞书机器人开启签名校验后Webhook 请求需携带时间戳和签名。确认 Uptime Kuma 版本 ≥ 1.20旧版本可能不支持飞书签名。升级命令dockerpull louislam/uptime-kuma:latestdockercompose up-dQ状态页自定义域名配置后显示 404。A确认以下三点① DNS 已正确解析② Nginx Proxy Manager 代理指向正确端口③ Uptime Kuma 状态页的Custom Domain字段填写的是不带协议头的纯域名status.example.com非https://status.example.com。Q监控数量超过 50 个后页面响应变慢。A可通过限制 SQLite 的 WAL 模式优化dockerexec-ituptime-kuma sqlite3 /app/data/kuma.dbPRAGMA journal_modeWAL;若监控量持续增长建议升级到 2 核 4GB 机型。Uptime Kuma 的价值不仅在于监控本身更在于及时、精准的告警通知和专业的状态页展示。选用雨云服务器 rainyun-com1 核 2GB 机型即可流畅运行完整监控栈优惠码2026off助你以最低成本搭建起生产级可观测体系让团队在故障发生的第一时间收到通知、快速响应。