Uptime Kuma

Uptime Kuma — 一款自托管的轻量级服务监控工具，帮你实时盯住网站、API和服务的在线状态，并在宕机时第一时间通知你。

作为一个经常折腾自建服务的人，我最怕的就是半夜收到“网站打不开”的消息。以前用过一些商业监控服务，要么贵，要么数据隐私不放心，要么功能太复杂杀鸡用牛刀。后来在 GitHub 上翻到一个叫 Uptime Kuma 的项目，第一眼就被它的颜值和极简设计吸引了——用了一周后，我直接把之前用的 Pingdom 和 UptimeRobot 全换掉了。

这个工具到底能干什么？

简单说，Uptime Kuma 就是一个自己搭在自己服务器上的“网站存活检测器”。你添加一个要监控的网址（比如你的博客、API接口、甚至某个TCP端口），它就会每隔几秒或几分钟去访问一次，如果发现访问失败，就通过 Telegram、邮件、钉钉、企业微信、Slack 等各种渠道给你发警报。

它解决的核心痛点其实就两个：

1. 不想把服务数据交给第三方 —— 所有监控数据、日志都留在你自己的服务器上。
2. 配置简单到离谱 —— 不需要写 YAML、不需要调告警规则，点几下鼠标就能搞定。

而且它不止监控 HTTP/HTTPS，还支持 Ping、TCP 端口、DNS 解析、SSL 证书有效期检测、甚至游戏服务器（Minecraft、Valheim 等）的状态监控。对于我这种同时运行着博客、图床、API 和几台 NAS 的人来说，一个仪表盘就能看到所有服务的健康状态，非常治愈。

下载方式

Uptime Kuma 的安装方式非常灵活，官方推荐用 Docker，但也支持直接 Node.js 部署。如果你像我一样懒，直接走 Docker 最省心。

Uptime Kuma 官网
GitHub 仓库

安装方法

方法一：Docker 部署（推荐，5分钟搞定）

确保你的服务器已经装了 Docker 和 Docker Compose，然后执行：

docker run -d --restart=always -p 3001:3001 -v /path/to/your/data:/app/data --name uptime-kuma louislam/uptime-kuma:latest

解释一下参数：

• -d：后台运行
• --restart=always：服务器重启后自动启动容器
• -p 3001:3001：把容器的 3001 端口映射到宿主机的 3001 端口（你可以改成其他端口，比如 8080）
• -v /path/to/your/data:/app/data：持久化存储数据，防止升级容器时丢失配置

跑完这条命令后，打开 http://你的服务器IP:3001，就能看到设置页面了。

如果你用 Docker Compose，可以写一个 docker-compose.yml：

version: '3.8'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - ./uptime-kuma-data:/app/data

然后 docker-compose up -d 就启动了。

方法二：Node.js 直接部署

如果你不想用 Docker，或者服务器资源很紧张（比如树莓派），也可以直接跑 Node.js：

# 安装 Node.js 18+ 和 npm
# 克隆仓库
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma

# 安装依赖
npm run setup

# 启动
node server/server.js

默认也是 3001 端口。不过我建议还是用 Docker，升级方便，而且不会污染宿主机环境。

基础使用教程

第一步：创建管理员账号

第一次打开页面，会让你设置用户名和密码。这个账号是管理员，可以添加监控项、配置通知、邀请其他用户（如果需要）。

第二步：添加第一个监控项

点击右上角的“添加监控项”，你会看到这样一个表单：

• 名称：随便起，比如“我的博客”
• 监控类型：选 HTTP(s) 或者 Ping。如果是网站，选 HTTP(s)
• URL：填入完整地址，比如 https://yourblog.com
• 间隔：默认 60 秒检测一次。如果你的服务很重要，可以改成 30 秒；如果只是图个安心，5 分钟也行
• 超时时间：默认 30 秒，一般不用改
• 重试次数：比如设置 2 次，表示连续失败 2 次才算宕机，避免网络抖动误报
• 通知：先不选，后面配置通知方式

点击“保存”，监控就开始了。几秒后你就能看到仪表盘上出现一个绿色的“UP”状态。

第三步：配置通知

通知是 Uptime Kuma 的灵魂。点击左侧菜单的“通知”，然后“添加通知”。

支持的渠道非常多，我列几个常用的：

• Telegram：需要创建一个 Bot，获取 Token 和 Chat ID
• 钉钉机器人：自定义关键词，把 Webhook 地址填进去
• 企业微信：群机器人，同样填 Webhook
• 邮件：需要 SMTP 服务器（可以用 QQ 邮箱、Gmail 等）
• Server酱：微信推送，适合国内用户
• Webhook：可以对接自己的自动化流程

配置好后，回到监控项编辑页面，在“通知”下拉框里勾选你刚创建的渠道。这样一旦服务挂了，你立刻就能收到消息。

第四步：看仪表盘和数据

仪表盘默认显示所有监控项的状态（绿色/红色），还有响应时间折线图。点击某个监控项，可以看到更详细的历史记录：每次检测的响应时间、状态码、失败原因等。对于排查问题很有帮助。

进阶技巧

1. 配置 SSL 证书监控

很多人不知道 Uptime Kuma 还能监控 SSL 证书的有效期。在添加监控项时，监控类型选 “SSL 证书”，填入域名，它会自动帮你检查证书剩余天数，并在证书快过期时发通知。这个功能对站长来说简直救命——再也不用担心证书过期导致网站打不开。

2. 用反向代理加域名访问

默认是通过 IP:端口 访问，但为了美观和安全，你可以用 Nginx 或 Caddy 反代，绑定一个子域名，比如 status.yourdomain.com。

Nginx 配置示例：

server {
    listen 80;
    server_name status.yourdomain.com;
    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

别忘了申请 SSL 证书（可以用 Certbot），这样就能 HTTPS 访问了。

3. 多用户和权限管理

如果你和朋友一起维护服务，可以在“设置”里开启用户注册，然后分配不同角色（管理员、普通用户）。普通用户只能看到自己添加的监控项，不能修改系统设置。

4. 使用状态页（Status Page）

Uptime Kuma 自带一个状态页功能，可以生成一个公开的网页，展示所有服务的当前状态和历史可用性。非常适合给客户或团队成员看。在“状态页”里创建一个新页面，选择要公开的监控项，然后得到一个链接，比如 https://yourdomain.com/status。

5. 备份数据

数据都存储在 /app/data 目录下（Docker 方式），定期备份这个文件夹就行。恢复时，只要把备份数据放回原路径，重新启动容器即可。

总结

Uptime Kuma 是我用过最顺手的自托管监控工具，没有之一。它不像 Nagios 或 Zabbix 那样需要学习复杂的配置语法，也不像商业服务那样限制监控数量。如果你手头有几台服务器或者几个网站，花 10 分钟搭一个 Uptime Kuma，相当于给自己请了一个 24 小时不睡觉的运维助理。

最后提醒一句：注意不要把监控页面暴露在公网上（除非加了认证），不然可能会被恶意刷请求。用反向代理加域名访问时，记得加个密码或 IP 白名单。

好了，去折腾吧。