如何安装 🐳 Docker
docker run -d --restart=unless-stopped -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2
Uptime Kuma 现已在 http://localhost:3001 上运行
警告
为避免 SQLite 数据库损坏,文件系统必须支持 POSIX 文件锁。请注意可能遇到的文件锁定问题,例如在 NFS 中常见的问题。请将 /app/data 目录映射到本地目录或卷。
启动后,请访问 http://localhost:3001。
更改端口或卷
docker run -d --restart=unless-stopped -p <YOUR_PORT>:3001 -v <YOUR_DIR OR VOLUME>:/app/data --name uptime-kuma louislam/uptime-kuma:2
Docker 标签说明
请参阅:https://github.com/louislam/uptime-kuma/wiki/Migration-From-v1-To-v2#docker-tags
🐳 Docker Compose
Docker Compose 示例模板:https://github.com/louislam/uptime-kuma/blob/master/compose.yaml
docker compose up -d
💪🏻 非 Docker 安装
依赖项:
-
平台
- ✅ 主要 Linux 发行版,如 Debian、Ubuntu、CentOS、Fedora 和 ArchLinux 等
- ✅ Windows 10 (x64)、Windows Server 2012 R2 (x64) 或更高版本
- ❌ 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 上运行
更多有用的 PM2 命令
# 查看当前控制台输出
pm2 monit
# 添加到开机自启
pm2 save && pm2 startup
(可选) 反向代理的额外步骤
对于希望使用反向代理的用户,此步骤是可选的。
与其他 Web 应用不同,Uptime Kuma 基于 WebSocket。反向代理 WebSocket 时需要额外传递 “Upgrade” 和 “Connection” 两个请求头。
更多信息请参阅维基:/docs/Reverse-Proxy
视频
-
5 分钟学会 Uptime Kuma,由 DEVOPS UNLOCKED 制作(使用 docker run 命令安装)
-
认识 Uptime Kuma,一个精美的开源状态监控工具,由 Techno Tim 制作(使用 docker-compose 安装)
-
使用 Uptime Kuma 监控状态 - 让我们用 Docker 安装 Uptime Kuma,由 Geeked 制作(使用 Portainer 安装)
非官方渠道
警告
以下安装方法由社区提供。它们未经官方测试,在未来版本中可能会失效。使用风险自负。
部署工具
Kubernetes Helm Chart (HelmForge)(非官方)
Chart 来源:https://github.com/helmforgedev/charts/tree/main/charts/uptime-kuma
Artifact Hub:https://artifacthub.io/packages/helm/helmforge/uptime-kuma
使用 Helm 仓库安装:
helm repo add helmforge https://repo.helmforge.dev
helm install uptime-kuma helmforge/uptime-kuma
或通过 OCI 安装:
helm install uptime-kuma oci://ghcr.io/helmforgedev/helm/uptime-kuma
功能:
- 支持 SQLite 和 MariaDB 后端
- 内置 S3 兼容的备份工作流
AWS Terraform 模块(非官方)
使用 Terraform 在 AWS 上部署 uptime-kuma 的模板:https://github.com/paliwalvimal/uptime-kuma-aws
Home Assistant 附加组件
https://github.com/hassio-addons/addon-uptime-kuma
另请参见对应的自定义集成:https://github.com/meichthys/uptime_kuma (开发中)。
在群晖 NAS 上安装
Marius Bogdan Lixandru 编写的非官方教程:
https://mariushosting.com/how-to-install-uptime-kuma-on-your-synology-nas/
Replicator Kuma
Replicator Kuma 扩展了 uptime-kuma 项目,支持在 uptime-kuma 实例之间同步监控器、状态页、事件及其他实体。
https://github.com/Sid-Sun/replicator-kuma
原生 Debian 包
适用于 Debian 13 系统的原生包 / apt 仓库,将 Uptime Kuma 作为加固的 systemd 服务运行:
https://codeberg.org/c8h4/uptime-kuma-deb
服务器托管平台
在各大平台上一键部署。
PikaPods
在 PikaPods.com 上一键运行。使用赠送额度可免费使用约 3 个月。PikaPods 制作了一部入门视频,供喜欢以此形式获取信息的用户参考。
Koyeb
在 Koyeb 上一键运行。永久免费。
Azure Container Instance(带 TLS 端点)
Stefan 编写的非官方教程:https://haci.io/posts/uptime-kuma-azure-container-instance/
Azure AppService Container
Leandro 编写的非官方教程:https://www.leandroscardua.com/blog/deploy-uptime-kuma-on-azure/
或使用持久存储:Yannick Zwijsen 提供的 bicep 部署脚本:https://github.com/yzwijsen/deploy-uptime-kuma-azure
FreeBSD
Victor Tschetter 提供的非官方 FreeBSD 安装脚本,包含 rc 服务脚本:https://github.com/tschettervictor/bsd-apps/tree/main/uptime-kuma
Railway
通过 Litestream.io 实现 SQLite S3 持久存储
使用 S3 持久化 SQLite 数据库运行 uptime-kuma:https://github.com/fluential/litestream-uptime-kuma/
阿里云
遵循部署指南将 Uptime Kuma 部署到阿里云。同时支持国内站和国际站。
英文部署指南
中文部署文档
Zeabur
在 Zeabur 上一键运行。
https://docs.zeabur.com/marketplace/uptime-kuma
Sealos
在 Sealos 上一键运行。
Fly.io
您可以在 Fly.io 上用一条命令托管 uptime-kuma,并运行其包含在 Hobby Plan 中的用量。
FlashPanel
您可以使用 FlashPanel(一种服务器管理控制面板)免费托管 uptime-kuma,支持在一台服务器上运行多达 10 个网站。
server.camp
server.camp 提供付费的、基于欧盟且符合 GDPR 的 uptime-kuma 及其他开源软件托管服务,面向初创企业、中小型及大型企业。您可以免费试用 7 天。
Cloudron.io
一键安装,支持:自动 DNS 配置 - 自动备份 - 预检更新等功能。
Zenith Hosting
Uptime Kuma 的一键部署。
Pethost
在 Pethost 上一键运行:欧盟托管 Docker 服务,支持夜间备份。
Hostim
在 Hostim 上一键运行:欧盟托管 Docker 服务,支持托管 MySQL 数据库、持久卷及 HTTPS。
设置指南
Varity
在 Varity 上一键运行:Uptime Kuma 运行在专属 HTTPS 地址上,配备 2 GB 持久卷以存储监控历史和设置,并在重启和重新部署后保留数据。部署前显示月度最高用量,不收取流量费。
在 Varity 上部署 Uptime Kuma
Simafri
在 Simafri 托管 VPS 上自托管 Uptime Kuma:Simafri 团队负责保持服务器最新、24/7 监控并每晚进行加密备份(数据备份至机器外部)。指南使用 Docker Compose 在 HTTPS 反向代理后运行官方镜像,该反向代理支持 WebSocket,具体请遵循此维基。Uptime Kuma、其设置和数据均归您所有。
xCloud
在 xCloud 上一键运行:Uptime Kuma 在您的专属服务器或 xCloud 云 VPS 上的 Docker 中运行,支持域名免费 SSL 及通过控制面板计划备份。
在 xCloud 上部署 Uptime Kuma
Zenavo
在 Zenavo 上一键运行:在您连接的 Linux 服务器上运行官方 louislam/uptime-kuma:2 镜像,配备 /app/data 持久卷,支持域名自动 HTTPS 及通过控制面板进行卷备份。首次打开时,选择 SQLite,然后创建管理员账户。
Spring Winter
将 Uptime Kuma 部署到您自己的 AWS 账户中:使用 Spring Winter,官方 louislam/uptime-kuma 镜像在 AWS 上运行于 HTTPS 地址之后,并配备 Amazon RDS MySQL 数据库(通过经过验证的 TLS 传输)以存储监控历史和设置,且在重启和重新部署后保留数据。平台对开源应用免费;AWS 直接向您账户收取资源费用。首次打开时,创建管理员账户。
在 Spring Winter 上部署 Uptime Kuma
其他
uptime-kuma-helper
@mkgeeky 创建了 uptime-kuma-helper,一个便于安装和更新的 bash 脚本。
在树莓派上部署 Android Uptime Kuma
查看此指南,了解如何将 root 过的 Android 智能手机转换为 uptime kuma 实例。
家庭环境
一只小熊正在监视您的网站。🐻🐻🐻
如何更新
重新拉取最新的 docker 镜像,并使用相同的卷创建另一个容器。