Uptime Kuma

自托管开源监控工具,界面友好

开源 🏷️完全免费 ✅ 目前可打开 基础设施 🍴 复刻 8860 🐛 待处理 852 👀 关注 319
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 94536
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 免费开源

项目预览

Uptime Kuma 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类基础设施
开发团队louislam
定价模式🏷️完全免费
价格说明免费开源
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言JavaScript
技术栈/模型docker,monitor,monitoring,responsive,self-hosted,selfhosted,single-page-app,socket-io,uptime,uptime-monitoring,webapp,websocket
GitHub 星标★ 94536
上线时间2021-07-03 00:00:00
代码更新2026-11-17
仓库体积39.2 MB
本站数据更新2026-11-17
维护状态活跃
收录时间2026-08-19
浏览次数21

项目介绍

Uptime Kuma 是开源自托管监控工具,监控网站、服务、端口与证书状态,支持 90 多种通知渠道。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-19 · 当前星标 ★ 94536

使用教程

难度:入门 约 10 分钟 部署方式:Docker 7 步

环境要求

  • Docker 与 Docker Compose(Docker Compose 方式)或 Docker 引擎(docker run 方式)
  • 选择非 Docker 安装时需要:Node.js >= 20.4、Git、pm2(后台运行)
  • 支持的平台:主流 Linux 发行版(Debian/Ubuntu/Fedora/ArchLinux 等)、Windows 10 (x64) 或 Windows
  • 数据目录必须位于本地目录或卷上,不支持 NFS 等网络文件系统

安装与启动步骤

  1. 1创建并进入目录

    新建一个目录存放 compose 配置文件,并切换到该目录中,后续命令都在此目录执行。

    mkdir uptime-kuma
    cd uptime-kuma
  2. 2下载 compose 文件

    从官方仓库下载 compose.yaml 到当前目录,不要手动改写文件名,保持默认即可。

    curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
  3. 3后台启动服务

    用 docker compose 以守护进程方式启动 Uptime Kuma,首次会拉取镜像,稍等片刻。

    docker compose up -d
  4. 4或用单条 docker 命令

    如果不想用 compose,可直接运行官方镜像:映射 3001 端口、挂载数据卷、容器名 uptime-kuma。

    docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
  5. 5限制仅本机访问

    出于安全考虑只想让本机访问时,把端口映射改为绑定 127.0.0.1 即可,其余参数保持不变。

    docker run -d --restart=always -p 127.0.0.1:3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
  6. 6浏览器完成初始化

    打开 http://localhost:3001(或 http://你的服务器IP:3001),按界面提示创建管理员账号并登录。

  7. 7非 Docker 方式安装

    克隆仓库并执行 npm run setup 安装依赖;README 仅给出到 setup 与 pm2 安装这一步,完整后台启动命令请参考官方 How-to-Install 文档。

    git clone https://github.com/louislam/uptime-kuma.git
    cd uptime-kuma
    npm run setup
    npm install pm2 -g && pm2 install pm2-logrotate

关键配置

配置项必填说明示例
-p 3001:3001是把容器的 3001 端口映射到宿主机,默认对所有网卡开放-p 3001:3001
-p 127.0.0.1:3001:3001否仅绑定本机回环地址,只允许本机浏览器访问服务-p 127.0.0.1:3001:3001
-v uptime-kuma:/app/data是数据持久化挂载,容器内数据目录为 /app/data,须映射到本地目录或卷-v uptime-kuma:/app/data
--restart=always否容器自动重启策略,宿主机重启后自动拉起监控服务--restart=always

如何确认成功

执行 docker ps 能看到 uptime-kuma 容器处于运行状态,浏览器访问 http://localhost:3001 能正常打开界面并进入初始化页面。

常见问题

Q:可以把数据目录挂载到 NFS 网络文件系统吗?

A:不可以。README 明确警告不支持 NFS 等网络文件系统,请把数据映射到本地目录或 Docker 卷,否则数据可能异常。

Q:装完不想让公网访问怎么办?

A:把端口映射从 -p 3001:3001 改成 -p 127.0.0.1:3001:3001,服务就只监听本机,再配合反向代理对外发布。

Q:非 Docker 安装支持哪些系统?

A:支持主流 Linux 发行版以及 Windows 10 (x64)、Windows Server 2012 R2 (x64) 及以上;不支持 FreeBSD、OpenBSD、NetBSD 以及 Replit、Heroku。

Q:想在安装前先看看界面?

A:可访问官方演示 https://demo.kuma.pet/start-demo,这是 10 分钟后数据全部删除的临时演示环境,不要放入真实数据。

注意事项

  • 数据目录务必挂载到本地目录或卷,NFS 不受支持,删容器不等于删数据,但漏挂卷会丢数据。
  • 默认监听所有网络接口(3001 端口),暴露公网前建议改用 127.0.0.1 绑定或加反向代理与鉴权。
  • 非 Docker 方式依赖 Node.js >= 20.4、Git 和 pm2;README 只给出到 npm run setup 与安装 pm2 的步骤,完整后台启动命令以官方 How-to-Install Wiki 为准。
  • 更多安装选项与反向代理配置请查阅 https://github.com/louislam/uptime-kuma/wiki 中的 How-to-Install 页面。

核心亮点

  • GitHub 获得 90K 星标,社区活跃、持续更新维护
  • 基于 JavaScript 开发,技术栈成熟,Docker 一键部署
  • 开源免费、支持自托管,数据掌握在自己手中,无厂商锁定

不足之处

  • 需要自行部署与日常维护,对非技术用户有一定门槛
  • 功能与稳定性依赖社区迭代,官方技术支持有限

适用场景

  • 网站与服务可用性监控告警
  • 个人/团队自建轻量监控体系
  • 需要私有化监控数据的场景

替代项目

Grafana、Prometheus、Zabbix

上一篇:harnessrouter

下一篇:freebuff-proxy

同类项目推荐

Axon 开源

终端里实时看穿 LLM 调用链,调试智能体快人一步

OpenTelemetry-native LLM observability CLI. Point any OTEL exporter at it and watch ···

★ 96 2026-08-09
matrixhub 开源

自建模型仓库,兼容 Hugging Face,推理加载更快

An Open-source, self-hosted AI model hub with Hugging Face compatibility, accelerati···

★ 367 2026-11-11
ChatMock 开源

用 Codex 引擎替换 OpenAI API,一行配置即享新能力

OpenAI & Ollama compatible API powered by Codex

★ 1567 2026-08-09
ChatGPTReversed 开源

免费逆向 ChatGPT 网页版,一键转成标准 API 调用

Free ChatGPT API reversed and simplified

★ 86 2026-08-09
voyageai-python 开源

一行代码接入顶级文本嵌入和重排序,让语义搜索更准。

Voyage AI Official Python Library

★ 114 2026-08-09
open-relay 开源

关掉终端,AI 任务继续跑,随时回来接管。

oly runs coding agents and long-running commands in persistent, supervised terminal ···

★ 110 2026-08-09
vllm-playground 开源

浏览器里管 vLLM,调参对话不用敲命令

A modern web interface for managing and interacting with vLLM servers (www.github.co···

★ 547 2026-10-14
ai-api-aggregator 开源

一个 Key 一个地址,统一调用 300+ 模型

AI API aggregator companion: machine-readable catalog of 300+ models behind one key ···

★ 150 2026-11-05
opencode-multi-auth-codex 开源

多账户管理+会话控制,让 Codex 稳定高效

OpenCode account routing, session controls, dashboard, and reliability tooling for C···

★ 185 2026-08-09