chipsman/uptime-kuma Docker 镜像 - 轩辕镜像

uptime-kuma Docker镜像文档

镜像概述

本镜像基于uptime-kuma项目构建，提供简单易用的服务监控解决方案。镜像标签格式为"仓库更新日期+短SHA"，默认指向最新的latest标签。构建镜像的代码可参考此处。

核心功能与特性

• 数据持久化支持：通过环境变量配置外部数据库（MariaDB/MySQL），避免监视项目数据丢失
• 灵活的变量命名：环境变量名支持下划线（如UPTIME_KUMA_DB_TYPE）或中划线（如UPTIME-KUMA-DB-TYPE）格式
• 数据库兼容性：MariaDB和MySQL在大多数情况下可互换使用

使用场景

适用于需要对服务进行持续监控且要求数据持久化的场景，如个人服务器监控、小型企业服务状态跟踪等，尤其适合希望通过外部数据库保存监控配置和历史数据的用户。

使用方法与配置说明

环境变量配置

通过以下环境变量配置数据库连接，确保监视项目数据持久化：

注：变量名可使用下划线（如UPTIME_KUMA_DB_TYPE）或中划线（如UPTIME-KUMA-DB-TYPE）格式

Docker部署示例

基本运行命令

bash
docker run -d \
  --name uptime-kuma \
  -p 3001:3001 \
  -e UPTIME_KUMA_DB_TYPE=mariadb \
  -e UPTIME_KUMA_DB_PASSWORD=yourpassword \
  -e UPTIME_KUMA_DB_USERNAME=kumauser \
  -e UPTIME_KUMA_DB_NAME=kuma_db \
  -e UPTIME_KUMA_DB_HOSTNAME=db-host \
  louislam/uptime-kuma:latest

Docker Compose配置示例

yaml
version: '3'
services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    ports:
      - "3001:3001"
    environment:
      - UPTIME_KUMA_DB_TYPE=mariadb
      - UPTIME_KUMA_DB_PASSWORD=yourpassword
      - UPTIME_KUMA_DB_USERNAME=kumauser
      - UPTIME_KUMA_DB_NAME=kuma_db
      - UPTIME_KUMA_DB_HOSTNAME=db-host
      - UPTIME_KUMA_DB_PORT=3306
    restart: unless-stopped

替换上述示例中的数据库连接信息（如密码、用户名、主机地址等）为实际环境配置。