variantconst/openwebui-monitor

OpenWebUI 用户跟踪与配额管理镜像

镜像概述

该Docker镜像提供基于OpenWebUI的可视化仪表板，专注于用户跟踪与配额管理功能。通过直观的Web界面，帮助管理员实时监控用户活动、配置资源配额规则，从而优化系统资源分配效率，适用于需要精细化用户行为管理的场景。

核心功能特性

• 用户跟踪：实时记录用户操作行为、访问频率及资源使用数据，支持多维度筛选与分析
• 配额管理：灵活配置用户/用户组的资源配额（如存储容量、API调用次数、并发会话数等），支持配额预警与超限限制
• 高效仪表板：采用轻量化前端框架构建，响应迅速，支持自定义数据可视化图表（柱状图、折线图、饼图等）
• 数据持久化：支持对接主流数据库（MySQL/PostgreSQL/SQLite），确保跟踪数据与配额配置持久化存储
• 权限控制：内置角色管理功能，支持管理员、操作员等多角色权限隔离，保障配置安全性

适用场景

• 企业内部系统：监控员工系统使用行为，防止资源滥用
• SaaS服务平台：对租户实施差异化配额管理，控制服务成本
• 开发测试环境：快速搭建用户行为分析与资源管控原型
• 多租户应用：为不同级别用户提供定制化资源配额方案

使用方法

快速启动

通过以下命令启动基础服务（默认使用SQLite数据库，适合测试环境）：

bash
docker run -d \
  -p 8080:8080 \
  -v ./data:/app/data \
  --name openwebui-tracking \
  openwebui/tracking:latest

说明：-v ./data:/app/data 用于挂载本地目录持久化存储数据，首次启动后可通过 http://localhost:8080 访问仪表板（默认账号：admin/admin123）

环境变量配置

生产环境中可通过环境变量自定义配置，常用参数如下：

生产环境部署示例（Docker Compose）

yaml
version: '3.8'

services:
  openwebui-tracking:
    image: openwebui/tracking:latest
    container_name: openwebui-tracking
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - DB_TYPE=mysql
      - DB_CONNECTION=mysql://user:password@mysql:3306/tracking_db?charset=utf8mb4
      - ADMIN_USER=sysadmin
      - ADMIN_PASSWORD=SecurePass2024!
      - TRACKING_RETENTION_DAYS=90
      - QUOTA_CHECK_INTERVAL=30
    volumes:
      - ./logs:/app/logs  # 日志持久化
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    container_name: tracking-mysql
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=tracking_db
      - MYSQL_USER=user
      - MYSQL_PASSWORD=password
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"

volumes:
  mysql-data:

注意事项

• 首次登录后需立即修改默认管理员密码（路径：设置 > 账号管理）
• 生产环境建议使用外部数据库（MySQL/PostgreSQL），并配置定期备份策略
• 高并发场景下可调整 QUOTA_CHECK_INTERVAL 参数（建议30-120秒）平衡性能与实时性
• 持久化目录权限需确保容器内进程可读写（推荐设置目录权限为 755）