aceberg/miniboard

miniboard

镜像概述和主要用途

miniboard 是一款轻量级仪表板工具，提供标签页管理、服务正常运行时间监控及通知功能。支持通过图形界面（GUI）或 YAML 配置文件进行设置，适用于个人或小型团队监控服务状态、管理多个服务面板的场景。

!https://raw.githubusercontent.com/aceberg/miniboard/main/assets/Screenshot%202023-06-25%20at%2022-55-05%20MiniBoard%20-%20Docker.png

更多主题

核心功能和特性

• 轻量级设计：资源占用低，部署简单
• 标签页管理：支持创建多个标签页，分类管理不同服务
• 运行时间监控：实时监控主机/服务的在线状态
• 通知功能：支持服务状态变更通知
• 多配置方式：可通过 GUI 或 YAML 文件进行配置
• 主题支持：集成 Bootswatch 主题（如 flatly、darkly 等）
• 颜色自定义：可自定义在线/离线状态颜色
• 本地网络支持：可部署为完全离线模式，不依赖外部网络资源

使用场景和适用范围

• 个人或小型团队监控多个服务/主机的运行状态
• 需要简单直观的仪表板展示服务状态
• 希望通过 GUI 或配置文件灵活配置监控项
• 需在无互联网环境下部署监控工具

使用方法和配置说明

快速启动

通过 Docker 直接运行：

sh
docker run --name miniboard \
-e "TZ=$YOURTIMEZONE" \
-v ~/.dockerdata/miniboard:/data/miniboard \
-v /var/run/docker.sock:/var/run/docker.sock \ # 仅在需要从 Docker 容器创建面板时需要（编辑面板页面）
-p 8849:8849 \
aceberg/miniboard

Docker Compose 配置

可使用 https://github.com/aceberg/miniboard/blob/main/docker-compose.yml 进行部署：

yaml
version: '3'
services:
  miniboard:
    image: aceberg/miniboard
    container_name: miniboard
    environment:
      - TZ=Asia/Shanghai  # 替换为你的时区
    volumes:
      - ~/.dockerdata/miniboard:/data/miniboard
      - /var/run/docker.sock:/var/run/docker.sock  # 可选
    ports:
      - "8849:8849"
    restart: unless-stopped

配置参数

配置可通过环境变量或配置文件设置，环境变量说明如下：

命令行选项

运行容器时可通过命令行参数指定路径：

本地网络部署（无互联网环境）

默认情况下，应用会从互联网拉取主题、图标和字体。若需完全离线部署，可使用 aceberg/node-bootstrap 镜像提供本地资源：

1. 启动 node-bootstrap 容器（提供本地模块和字体）：

sh
docker run --name node-bootstrap \
    -v ~/.dockerdata/icons:/app/icons  \ # 用于本地图标（可选）
    -p 8850:8850                       \
    aceberg/node-bootstrap

2. 启动 miniboard 并指定本地模块路径：

sh
docker run --name miniboard \
    -v ~/.dockerdata/miniboard:/data/miniboard \
    -p 8849:8849 \
    aceberg/miniboard -n "http://$YOUR_IP:8850"

也可使用 https://github.com/aceberg/miniboard/blob/main/docker-compose-local.yml 配置文件进行部署。