Heidi Labs
GitHub TrendingGitHub Trending 项目约 8 分钟3,012 字

Uptime Kuma：易用的自托管监控工具

本文目录

Uptime Kuma#

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

🥔 在线演示

试一试！

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

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

警告 当心——Google 搜索结果的第一名 uptimekuma.co 不是我们的官方网站，我们不控制该网站。我建议按照本 GitHub 仓库中的安装指南操作。

⭐ 功能#

  • 监控 HTTP(s) / TCP / HTTP(s) 关键字 / HTTP(s) JSON 查询 / WebSocket / Ping / DNS 记录 / Push / Steam 游戏服务器 / Docker 容器的可用性
  • 精美、响应式、快速的 UI/UX
  • 通过 Telegram、Discord、Gotify、Slack、Pushover、电子邮件（SMTP）以及 90 多种通知服务发送通知，完整列表点击此处
  • 20 秒间隔
  • 多语言
  • 多个状态页面
  • 将状态页面映射到特定域名
  • Ping 图表
  • 证书信息
  • 代理支持
  • 2FA 支持

🔧 如何安装#

🐳 Docker Compose#

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（Network File System）等文件系统。请映射到本地目录或卷。

🐳 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）。

如果只想暴露给 localhost：

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

💪🏻 非 Docker#

要求：

Platform

  • ✅ 主要 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

# 选项 1. 试一试
node server/server.js

# （推荐）选项 2. 使用 PM2 在后台运行
# 如果没有 PM2，请先安装：
npm install pm2 -g && pm2 install pm2-logrotate

# 启动服务器
pm2 start server/server.js --name uptime-kuma

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

更多有用的 PM2 命令

# 如果想查看当前控制台输出
pm2 monit

# 如果想将其加入开机启动
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

❤️ 赞助商#

非常感谢你支持这个项目！

特别赞助商

Atlas Cloud（https://www.atlascloud.ai）每月赞助本项目 400 美元，以使用他们的 AI 模型。

Open Collective 和 GitHub Sponsors

（该列表会由 GitHub 缓存，最多可能需要 24 小时更新）

🖼 更多截图#

浅色模式：

状态页面：

设置页面：

Telegram 通知示例：

动机#

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

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

🗣️ 讨论 / 寻求帮助#

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

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

  • GitHub Issues
  • Subreddit（r/UptimeKuma）

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

贡献#

创建 Pull Request

Pull request 很棒。 为了让审查保持快速有效，请确保你已阅读我们的 Pull Request 指南。

测试 Pull Request

目前有很多 Pull Request，但我没有时间全部测试。

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

测试 Beta 版本

在此查看最新的 beta 发布：https://github.com/louislam/uptime-kuma/releases

Bug 报告 / 功能请求

如果你想报告 bug 或请求新功能，欢迎开一个新 issue。

翻译

如果你想将 Uptime Kuma 翻译成你的语言，请访问 Weblate Readme。

拼写与语法

欢迎纠正文档或代码中的语法。 我的母语不是英语，语法也不是很好。

关于#

一个精美的自托管监控工具

uptime.kuma.pet

主题：docker、monitor、monitoring、responsive、self-hosted、selfhosted、single-page-app、socket-io、uptime、uptime-monitoring、webapp、websocket

资源#

Readme

MIT 许可证

行为准则

行为准则

贡献

贡献

安全策略

安全策略

活动

Stars

93.8k stars

Watchers

317 watching

Forks

8.7k forks

报告仓库

Releases

赞助此项目

Packages

Used by

Contributors

Languages