英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Uptime Kuma

Uptime Kuma 是一个易于使用的自托管监控工具。

🥔 现场演示

试一试！

演示服务器（位置：德国法兰克福）：https://demo.kuma.pet/start-demo

这是一个临时的实时演示，所有数据将在10分钟后被删除。由 Uptime Kuma 赞助商 赞助。

⭐ 功能

• 监控 HTTP(s) / TCP / HTTP(s) 关键字 / HTTP(s) Json 查询 / Websocket / Ping / DNS 记录 / 推送 / Steam 游戏服务器 / Docker 容器的正常运行时间
• 华丽、响应快速、流畅的 UI/UX
• 通过 Telegram、Discord、Gotify、Slack、Pushover、电子邮件 (SMTP) 以及 90 个通知服务，点击此处查看完整列表 发送通知
• 20 秒间隔
• 多语言支持
• 多个状态页面
• 将状态页面映射到特定域名
• Ping 图表
• 证书信息
• 代理支持
• 支持双因素认证 (2FA)

🔧 如何安装

🐳 Docker 组合

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d

Uptime Kuma 现在正在所有网络接口上运行（例如 http://localhost:3001 或 http://your-ip:3001）。

[!警告]
像 NFS（网络文件系统）这样的文件系统 不被支持。请映射到本地目录或卷。

🐳 Docker 命令

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://your-ip:3001）。

如果您只想限制对本地主机的访问：

docker run ... -p 127.0.0.1:3001:3001 ...

💪🏻 非 Docker

要求：

• 平台
  • ✅ 主要的 Linux 发行版，如 Debian、Ubuntu、Fedora 和 ArchLinux 等。
  • ✅ Windows 10 (x64)、Windows Server 2012 R2 (x64) 或更高版本
  • ❌ FreeBSD / OpenBSD / NetBSD
  • ❌ Replit / Heroku
• Node.js >= 20.4
• Git
• pm2 - 用于在后台运行 Uptime Kuma

git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup

# Option 1. Try it
node server/server.js

# (Recommended) Option 2. Run in the background using PM2
# Install PM2 if you don't have it:
npm install pm2 -g && pm2 install pm2-logrotate

# Start Server
pm2 start server/server.js --name uptime-kuma

Uptime Kuma 现在正在所有网络接口上运行（例如：http://localhost:3001 或 http://your-ip:3001）。

更多有用的 PM2 命令

# If you want to see the current console output
pm2 monit

# If you want to add it to startup
pm2 startup && pm2 save

高级安装

如果您需要更多选项或需要通过反向代理浏览，请阅读：

https://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install

🆙 如何更新

请阅读：

https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update

🆕 接下来是什么？

我将把请求/问题分配到下一个里程碑。

https://github.com/louislam/uptime-kuma/milestones

🖼 更多截图

浅色模式：

状态页面：

设置页面：

Telegram 通知示例：

动机

• 我一直在寻找类似“Uptime Robot”的自托管监控工具，但很难找到合适的。最接近的一款是 statping。不幸的是，它不稳定且不再维护。
• 想要构建一个华丽的界面。
• 学习 Vue 3 和 vite.js。
• 展示 Bootstrap 5 的强大功能。
• 尝试在 SPA 中使用 WebSocket，而不是 REST API。
• 将我的第一个 Docker 镜像部署到 Docker Hub。

如果你喜欢这个项目，请考虑给它一个 ⭐。

🗣️ 讨论 / 请求帮助

⚠️ 对于任何一般性或技术性问题，请不要给我发送电子邮件，因为我无法通过这种方式提供支持。如果你在那儿提问，我将不会回复。

我建议使用 Google、GitHub Issues 或 Uptime Kuma 的 subreddit 来寻找你问题的答案。如果你找不到所需的信息，可以随时提问：

• GitHub 问题
• 子版块 (r/UptimeKuma)

我的 Reddit 账号：u/louislamlam 如果你在 subreddit 提问，可以提到我。

贡献

创建拉取请求

拉取请求非常棒。为了保持审查的快速和高效，请确保您已经阅读我们的拉取请求指南。

测试拉取请求

目前有很多拉取请求，但我没有时间全部测试。

如果您想帮忙，可以查看这个: https://github.com/louislam/uptime-kuma/wiki/Test-Pull-Requests

测试测试版

在这里查看最新的测试版发布: https://github.com/louislam/uptime-kuma/releases

错误报告 / 功能请求

如果您想报告错误或请求新功能，请随时打开一个新问题。

翻译

如果您想将 Uptime Kuma 翻译成您的语言，请访问 Weblate 说明。

拼写与语法

随时可以纠正文档或代码中的语法。我的母语不是英语，语法不太好。