进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 3 阅读

第1章 Uptime Kuma 安装指南(第1章)

如何安装 🐳 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 镜像,并使用相同的卷创建另一个容器。

评论 (0)