首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Uptime Kuma 部署教程:用腾讯云Lighthouse搭建免费网站监控系统

Uptime Kuma 部署教程:用腾讯云Lighthouse搭建免费网站监控系统

原创
作者头像
hollyx
发布于 2026-09-24 10:39:19
发布于 2026-09-24 10:39:19
1850
举报

上线了一个网站或服务后,如何第一时间知道它是否在线?等用户来投诉才去排查,显然不是好办法。Uptime Kuma 是一款开源的自托管监控工具,可以持续探测你的服务状态,一旦出问题立即通过多种渠道通知你。本文将教你如何在腾讯云 Lighthouse 上一键部署 Uptime Kuma。

一、Uptime Kuma 是什么?

Uptime Kuma 是一款开源的、自托管的服务监控工具,在 GitHub 上已获得超过 9 万 Star。它能够代替商业监控服务(如 Pingdom、Better Uptime),让你的监控数据完全掌握在自己手中。

核心功能包括:

  • 多种监控类型:支持 HTTP/HTTPS、TCP、Ping、DNS、Docker 容器、数据库等多种监控协议
  • 丰富的告警渠道:支持企业微信、钉钉、飞书、Telegram、Discord、邮件、Slack 等 70 多种通知方式
  • 状态页面:自动生成公开的状态页面,让用户实时了解服务运行状况
  • SSL 证书监控:自动检测 SSL 证书过期时间,提前预警
  • 响应时间记录:记录每次探测的响应时间,可查看历史趋势

二、部署 Uptime Kuma

前提条件

  • 一台腾讯云 Lighthouse 或 CVM 云服务器(最低 1 核 1G 即可运行)
  • 已安装 Docker 环境(使用 Docker CE 应用镜像或手动安装)

方式一:Docker 一键部署(推荐)

在服务器终端中执行以下命令:

代码语言:txt
复制
docker run -d --restart=always \
  -p 3001:3001 \
  -v uptime-kuma:/app/data \
  --name uptime-kuma \
  louislam/uptime-kuma:1

部署完成后,在浏览器访问 http://你的服务器IP:3001。

方式二:Docker Compose 部署

创建 docker-compose.yml 文件:

代码语言:yaml
复制
version: '3.8'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./uptime-data:/app/data

执行 docker compose up -d 启动。

三、初次配置

创建管理员账号

首次访问会进入安装引导页面,设置管理员用户名和密码后即可进入仪表盘。

添加监控项

点击"添加监控项",配置以下信息:

  1. 监控类型:选择 HTTP(s) 来监控网站,或选择 TCP/Ping 监控服务器
  2. 目标 URL/地址:输入你要监控的服务地址
  3. 检查间隔:默认 60 秒检查一次,可根据需要调整
  4. 超时时间:默认 30 秒,超时即视为异常

创建完成后,仪表盘会显示该服务的实时状态。

配置通知

Uptime Kuma 支持 70 多种通知方式,以下是国内常用的几种:

通知方式

配置要点

企业微信机器人

获取 Webhook URL 填入即可

飞书机器人

获取 Webhook URL 填入即可

钉钉机器人

获取 Webhook + 密钥

Server 酱

获取 SendKey

邮件

配置 SMTP 服务器

以企业微信为例:在企业微信群中添加机器人,复制 Webhook 地址,在 Uptime Kuma 的通知设置中选择"企业微信机器人",填入 URL 即可。

四、创建状态页面

Uptime Kuma 可以自动生成公开的状态页面,让用户了解服务运行状况:

  1. 在左侧菜单点击"状态页面"
  2. 点击"创建状态页面"
  3. 设置页面标题、选择要展示的监控项
  4. 保存后获取公开状态页面的链接

状态页面会以绿色/红色标识每个服务的运行状态,并显示历史可用率。

五、安全建议

  1. 防火墙:在 Lighthouse 控制台放行 3001 端口后,其他端口保持关闭
  2. 反向代理 + HTTPS:如果有自己的域名,可以通过 Nginx 反向代理为监控页面配置 HTTPS
  3. 限制访问:Uptime Kuma 的管理页面本身需要登录,确保使用强密码

六、常见问题

Q1:1 核 1G 够用吗?

A:完全够用。Uptime Kuma 非常轻量,运行多个监控项和通知方式的情况下,资源占用极低。

Q2:可以监控内网服务吗?

A:可以。如果监控目标和 Uptime Kuma 在同一内网,可以直接填写内网地址;如果跨网络需要确保网络可达。

Q3:历史数据会丢失吗?

A:数据存储在容器的 /app/data 目录中,挂载本地卷后数据持久化,容器重启或升级均不丢失。

👉 前往腾讯云 Lighthouse 选购云服务器

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、Uptime Kuma 是什么?
  • 二、部署 Uptime Kuma
    • 前提条件
    • 方式一:Docker 一键部署(推荐)
    • 方式二:Docker Compose 部署
  • 三、初次配置
    • 创建管理员账号
    • 添加监控项
    • 配置通知
  • 四、创建状态页面
  • 五、安全建议
  • 六、常见问题
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档