Uptime Kuma 简介

Uptime Kuma 是一款开源、界面美观的自托管服务监控平台，支持多种监控类型（HTTP(s)、TCP、Ping等），并可通过多种方式推送告警通知。适合个人和团队实时掌握网站、API、服务器等服务的运行状态。

官方演示站：https://demo.kuma.pet

主要特点

• 多协议监控：支持 HTTP(s)、TCP、Ping、DNS 等多种监控方式
• 多渠道告警：支持微信、邮件、Telegram、钉钉等多种通知
• 可视化报表：美观的仪表盘和历史数据统计
• 自定义监控频率：灵活设置检测间隔
• 自托管：数据完全掌控
• 轻量易用：一条命令即可部署

准备工作

在开始部署之前，请确保您已经具备以下条件：

1. 已安装 Docker 和 Docker Compose（参考本站 Linux Docker 安装教程）
2. 服务器配置建议：
   • CPU: 1核以上
   • 内存: 512MB 以上
   • 存储: 1GB 可用空间

使用 Docker Compose 部署 Uptime Kuma

1. 创建并进入项目目录

mkdir -p ~/uptime-kuma
cd ~/uptime-kuma

2. 创建 docker-compose.yml 文件

cat > docker-compose.yml << 'EOF'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
EOF

参数说明

• ports：默认 3001:3001，冒号前可修改为宿主机端口
• volumes：必须挂载 /app/data 目录以持久化监控数据
• TZ：时区设置，建议保持 Asia/Shanghai

3. 启动 Uptime Kuma 服务

docker compose up -d

4. 验证部署

docker ps | grep uptime-kuma

如果看到容器状态为 Up，说明服务已成功启动。

基本配置

1. 访问 Uptime Kuma

在浏览器中访问：

http://你的服务器IP:3001

首次访问需注册管理员账户。

2. 域名与HTTPS访问（推荐）

如需通过自定义域名和HTTPS访问，推荐搭配 Nginx Proxy Manager 进行反向代理与SSL证书配置。

详细教程请参考：使用Docker快速部署Nginx Proxy Manager实现多域名反向代理

数据备份与恢复

1. 备份数据

Uptime Kuma 的所有数据都存储在 ./data 目录下，可以通过以下命令进行备份：

# 创建备份文件
tar -czvf uptime-kuma-backup-$(date +%Y%m%d).tar.gz -C ~/uptime-kuma/data .

2. 恢复数据

# 停止服务
cd ~/uptime-kuma
docker compose down

# 恢复备份（请将 YYYYMMDD 替换为实际备份日期）
tar -xzvf uptime-kuma-backup-YYYYMMDD.tar.gz -C ~/uptime-kuma/data

# 重新启动服务
docker compose up -d

常见问题（FAQ）

问题	解决方案
如何更新 Uptime Kuma？	在项目目录执行 docker compose pull && docker compose up -d --force-recreate
如何查看日志？	docker logs uptime-kuma
如何修改访问端口？	修改 docker-compose.yml 的 ports 映射并运行 docker compose restart
如何配置告警通知？	登录后台“设置 → 通知”，选择通知方式（微信/邮件/钉钉等）并填写参数

总结

通过本教程，您已成功使用 Docker 部署了 Uptime Kuma 服务监控系统。Uptime Kuma 提供了高颜值、易用的服务监控和告警平台，是自托管和团队监控的理想选择。

---

如果在使用过程中遇到任何问题，欢迎在评论区留言，我会尽快为您解答。