项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-19 · 当前星标 ★ 94536
使用教程
环境要求
- 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创建并进入目录
新建一个目录存放 compose 配置文件,并切换到该目录中,后续命令都在此目录执行。
mkdir uptime-kuma cd uptime-kuma -
2下载 compose 文件
从官方仓库下载 compose.yaml 到当前目录,不要手动改写文件名,保持默认即可。
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml -
3后台启动服务
用 docker compose 以守护进程方式启动 Uptime Kuma,首次会拉取镜像,稍等片刻。
docker compose up -d -
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限制仅本机访问
出于安全考虑只想让本机访问时,把端口映射改为绑定 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浏览器完成初始化
打开 http://localhost:3001(或 http://你的服务器IP:3001),按界面提示创建管理员账号并登录。
-
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 ···
matrixhub
开源
自建模型仓库,兼容 Hugging Face,推理加载更快
An Open-source, self-hosted AI model hub with Hugging Face compatibility, accelerati···
ChatMock
开源
用 Codex 引擎替换 OpenAI API,一行配置即享新能力
OpenAI & Ollama compatible API powered by Codex
ChatGPTReversed
开源
免费逆向 ChatGPT 网页版,一键转成标准 API 调用
Free ChatGPT API reversed and simplified
voyageai-python
开源
一行代码接入顶级文本嵌入和重排序,让语义搜索更准。
Voyage AI Official Python Library
open-relay
开源
关掉终端,AI 任务继续跑,随时回来接管。
oly runs coding agents and long-running commands in persistent, supervised terminal ···
vllm-playground
开源
浏览器里管 vLLM,调参对话不用敲命令
A modern web interface for managing and interacting with vLLM servers (www.github.co···
ai-api-aggregator
开源
一个 Key 一个地址,统一调用 300+ 模型
AI API aggregator companion: machine-readable catalog of 300+ models behind one key ···
opencode-multi-auth-codex
开源
多账户管理+会话控制,让 Codex 稳定高效
OpenCode account routing, session controls, dashboard, and reliability tooling for C···
