在当今数字化时代，服务的可用性至关重要，无论是个人网站、企业应用还是 API 接口，一旦出现故障，都可能带来不可估量的损失。而 Uptime Kuma 作为一款开源的自托管监控工具，为我们提供了监测 HTTP (s)、TCP、DNS、Docker 等服务的强大能力，本文将详细介绍这款工具及其贡献指南。

Uptime Kuma 简介

Uptime Kuma 是一个开源的自托管监控工具，具备以下特点：

  • ✅支持多种监控类型，包括 HTTP (s)、TCP、DNS 记录、Docker 容器等

  • ✨提供精美的、响应式的快速用户界面

  • 🔔支持通过 Telegram、Discord、邮件等 90 多种通知服务发送告警

  • 🌍支持 20 秒间隔监控、多语言、多个状态页面等功能

演示站点

如果你想先体验一下 Uptime Kuma 的功能，可以访问🎯演示站点：https://up.tibtob.cn。通过演示站点，你可以直观地了解 Uptime Kuma 的界面风格和主要功能。

官方也提供了一个临时演示服务器（位于德国法兰克福）：https://demo.kuma.pet/start-demo，不过该演示服务器的数据会每 10 分钟删除一次。

效果图

浅色模式：

2025-11-13 21.07.21.png

状态页面：

2025-11-13 21.06.46.png

🐳使用 Docker 部署 Uptime Kuma

使用以下 Docker 命令可以快速部署 Uptime Kuma：

docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

执行上述命令后，Uptime Kuma 将会在所有网络接口上运行，你可以通过 http://localhost:3001 或 http://你的IP地址:3001 访问。

🔒限制仅本地访问

docker run -d --restart=always -p 127.0.0.1:3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

🐳使用 Docker Compose 部署 Uptime Kuma

部署步骤

  1. 创建并进入 uptime-kuma 目录：

mkdir uptime-kuma
cd uptime-kuma

  1. 下载 compose.yaml 文件：

curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

  1. 启动服务：

docker compose up -d

启动后，同样可以通过 http://localhost:3001 或 http://你的IP地址:3001 访问 Uptime Kuma。

⚠️注意事项

  1. 🚫Uptime Kuma 不支持 NFS（网络文件系统），请将数据映射到本地目录或卷。

  2. 🔌服务器及面板开放端口：默认通过 3001 端口提供服务，需确保该端口在防火墙（如阿里云安全组）中开放；若修改映射端口（如 8080），则开放对应宿主机端口。同时，监控目标涉及的特定端口（如 TCP 8080、DNS 53 等）需允许 Uptime Kuma 服务器访问。

总结

通过 Docker 或 Docker Compose 部署 Uptime Kuma 非常简单快捷，几分钟内就可以完成部署并开始使用这个强大的监控工具。如果你还没有尝试过，不妨按照本文的步骤部署一个，或者先访问演示站点 https://up.tibtob.cn 体验一下它的功能。

Uptime Kuma 的出现为自托管监控提供了一个优秀的选择，无论是个人使用还是企业部署，都能满足基本的监控需求。