# Uptime Kuma

在线监控服务运行状态系统

# 参考文档

# 使用

开源版仅有一个用户，不支持用户管理
可以通过创建状态页给特定组查看（这个不需要登录，链接可以公开访问）
默认使用 SQLite 数据库

# Uptime Kuma 安装配置

# Linux 安装

# Docker 安装

启动容器：

# -d 后台运行（detached mode）
docker run -d \
  --name uptime-kuma \
  # 容器随 Docker 启动自动运行，除非手动停止
  --restart=unless-stopped \
  # 宿主机：容器，3001 容器kuma服务默认端口
  -p 3001:3001 \
  # 宿主机：容器  
  -v /opt/uptime-kuma/data:/app/data \
  -e TZ=Asia/Shanghai \
  # 可选：是否在页面底部显示 “Powered by Uptime Kuma”（设为 true 可隐藏）   
  -e UPTIME_KUMA_DISABLE_LOGO=false \
  # 限制容器日志大小（最多 3 个文件，每个 10MB）   
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  --user "$(id -u):$(id -g)" \
  louislam/uptime-kuma:1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

docker compose：

# uptime-kuma/
# ├── docker-compose.yml      # ← 本文件
# └── data/                   # ← 自动创建，存放 kuma.db 等数据

# Uptime Kuma - 开源服务监控面板
# 项目地址: https://github.com/louislam/uptime-kuma
# 访问地址: http://你的服务器IP:3001

version: '3.8'

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1          # 使用 v1.x 最新稳定版（避免 latest）
    container_name: uptime-kuma            # 容器名称，便于管理
    restart: unless-stopped                # 崩溃或重启后自动恢复，但尊重手动停止
    ports:
      - "3001:3001"                        # 主机端口:容器端口（可按需修改左边）
    volumes:
      - ./data:/app/data                   # 持久化数据：监控配置、通知、状态页等
      # - /etc/localtime:/etc/localtime:ro # 可选：同步系统时间（Linux 专用）
    environment:
      - TZ=Asia/Shanghai                   # 设置时区（重要！影响日志和通知时间）
      # - UPTIME_KUMA_DISABLE_LOGO=true   # 可选：隐藏页面底部 "Powered by Uptime Kuma"
    logging:
      driver: json-file
      options:
        max-size: "10m"                    # 单个日志文件最大 10MB
        max-file: "3"                      # 最多保留 3 个日志文件（防磁盘爆满）
    # security_opt:
    #   - no-new-privileges:true           # 可选：增强安全（限制提权）
    healthcheck:
      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3001"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s                    # 给应用足够启动时间

# 注意：Uptime Kuma 是单服务应用，无需定义 networks 或其他 services
# 但未来若加 Nginx/HTTPS，只需在此文件追加 service 即可，如下：
  nginx:
    image: nginx:alpine
    ports:
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./certs:/certs
    depends_on:
      - uptime-kuma

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# 讨论区

由于评论过多会影响页面最下方的导航，故将评论区做默认折叠处理。

点击查看评论区内容，渴望您的宝贵建议~

← 监控系统总览