### [Uptime Kuma 自建监控神兵利器，守护网站永不断线](https://www.qiqiwa.com/article/275)

**Published:** 2026-02-19T09:41:15

**Author:** Hello

**Excerpt:** 如果你正在寻找一款既有大厂风范，又完全免费开源的网站监控工具，那么 Uptime Kuma 绝对是你的最终站。它不仅能实时监测网站的在线状态，还能在服务异常时第一时间通过微信、电报或邮件通知你，让你在用户发现之前解决问题。 ✨ 为什么选择 

如果你正在寻找一款既有大厂风范，又完全免费开源的网站监控工具，那么 **Uptime Kuma** 绝对是你的最终站。它不仅能实时监测网站的在线状态，还能在服务异常时第一时间通过微信、电报或邮件通知你，让你在用户发现之前解决问题。

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260219173840.png)

## ✨ 为什么选择 Uptime Kuma？

### 1\. 极致的视觉体验

Uptime Kuma 的 UI 设计非常现代，支持暗黑模式。它不仅提供动态的响应时间折线图，还能为你生成一个精美的**公开状态页**（Status Page），你可以直接挂载到博客导航栏，向读者展示服务器的稳定性。

### 2\. 多维度的监测类型

它不只是能 Ping 你的服务器：

-   **HTTP(s)**：监测网页、API 接口。
-   **TCP / UDP / Ping**：监测服务器端口及网络通畅度。
-   **DNS**：监测域名解析记录是否正常。
-   **Docker 容器**：实时观察容器运行状态。
-   **Game Servers**：支持 Minecraft 等游戏服务器监控。

### 3\. “轰炸式”的告警通知

内置支持 **90+** 种通知渠道，包括但不限于：

-   **国内友好**：企业微信、钉钉、飞书、Bark、Server 酱。
-   **国际主流**：Telegram、Discord、Slack、Email (SMTP)。

* * *

## 🏗️ 部署指南：两种主流安装方式

### 方案一：Docker 部署（强烈推荐）

这是最简单、最稳健的方式，仅需一行命令。

```
docker run -d \
  --name uptime-kuma \
  -p 3001:3001 \
  -v uptime-kuma:/app/data \
  --restart always \
  louislam/uptime-kuma:1
```

-   **访问地址**：`http://服务器IP:3001`
-   **数据持久化**：配置信息将保存在 Docker 卷 `uptime-kuma` 中，即使升级版本也不会丢失数据。

#### 版本更新

重新拉取最新的 Docker 镜像，并创建一个包含相同卷的另一个容器。

对于用我的“如何使用”命令安装Uptime Kuma的人来说，你可以用以下方式更新：

```
docker pull louislam/uptime-kuma:2
docker stop uptime-kuma
docker rm uptime-kuma

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

# If you are not using default value
# docker run -d --restart=always -p <YOUR PORT>:3001 -v <YOUR VOLUME>:/app/data --name uptime-kuma louislam/uptime-kuma:2
```

附注：每次新版本都会需要一些时间来构建docker镜像，如果还没发布，请耐心等待。

## Docker-Compose

[](https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update#docker-compose)

```
cd "<YOUR docker-compose.yml DIRECTORY>"
docker compose pull
docker compose up -d --force-recreate
```

### 方案二：宝塔面板部署（新手友好）

如果你使用的是宝塔面板：

1.  进入 **\[软件商店\]**，搜索并安装 **Docker**。
2.  在 Docker 管理器的 **\[项目模板\]** 或 **\[应用商店\]** 中搜索 `Uptime Kuma` 一键部署。
3.  或者直接在 **\[终端\]** 输入上方的 Docker 命令。

* * *

## 🛠️ 初始化与进阶配置

### 1\. 创建管理员

首次进入页面，系统会提示你创建第一个管理员账号。

### 2\. 配置反向代理（启用域名访问）

为了安全和专业性，建议为监控面板配置域名。在 Nginx 配置文件中加入：

```
location / {
    proxy_set_header   X-Real-IP $remote_addr;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass         http://localhost:3001/;
    proxy_http_version 1.1;
    proxy_set_header   Upgrade $http_upgrade;
    proxy_set_header   Connection "upgrade";
}
```

> **注意**：必须配置 `Upgrade` 和 `Connection` 请求头，否则 WebSocket 无法连接，页面将无法实时更新。

### 3\. 建立状态页

在后台点击 **\[状态页\]** -> **\[添加新状态页\]**。你可以自定义 Slug（如 `/status`），并挑选要公开展示的监控项。

* * *

## ⚖️ 优缺点总结

-   **✅ 优点**：
    -   **零配置压力**：全图形化界面，鼠标点点就能用。
    -   **低资源占用**：Node.js 编写，即便是 1 核 512M 的 VPS 也能流畅运行。
    -   **功能丰富**：支持代理访问、证书过期预警、多因子认证 (2FA)。
-   **⚠️ 缺点**：
    -   **单点局限**：如果 Uptime Kuma 所在的服务器挂了，它就无法发出告警。建议部署在与主业务不同的机房。

* * *

## 🎯 总结：谁最需要 Uptime Kuma？

-   **多机站长**：手里有几台服务器，想一眼看全所有服务的健康度。
-   **API 开发者**：需要监控接口延迟和可用性。
-   **完美主义者**：需要一个漂亮的界面来提升自己运维工作的“仪式感”。

| 项目地址 | 演示地址 |
| --- | --- |
| [Uptime-kuma](https://github.com/louislam/uptime-kuma) | [Demo.kuma.pet/start-demo](https://demo.kuma.pet/start-demo) |

**Tags:** 开源项目, 网站监控

**Categories:** 项目笔记

---