mookid8000/fleetmanager

官方Fleet Manager镜像文档

1. 镜像概述和主要用途

官方Fleet Manager镜像是用于集中管理车队、设备或服务集群的工具镜像，提供统一的监控、调度、配置管理及数据统计功能。该镜像旨在简化分布式资源的管理流程，帮助用户实现对车队、物联网设备或服务集群的高效协调与控制。

2. 核心功能和特性

• 集中化监控：实时采集并展示车队/设备/服务的运行状态、性能指标及连接状态，支持可视化仪表盘查看。
• 资源调度管理：基于预设规则或实时数据自动调度设备/服务资源，优化负载分配和资源利用率。
• 配置管理：提供统一的配置中心，支持批量更新设备/服务参数，支持配置版本控制和回滚。
• 数据统计与分析：自动收集运行数据，生成运营报表、趋势分析及效率评估报告。
• 告警通知机制：异常状态（如设备离线、性能阈值超标）自动触发告警，支持邮件、短信、API等多渠道通知。
• 官方支持：提供持续的版本更新、安全补丁及技术支持服务。

3. 使用场景和适用范围

• 车队运营管理：适用于物流、公交、出租车等车队的车辆监控、路线规划、油耗统计及司机行为分析。
• 物联网设备集群：管理大规模物联网（IoT）设备，监控设备在线状态、数据传输情况及远程控制。
• 分布式服务集群：协调分布式环境中的服务实例（如微服务节点），确保服务高可用性和负载均衡。
• 企业设备管理：集中管理企业内部办公设备、生产设备等，提升运维效率和故障响应速度。

4. 使用方法和配置说明

4.1 基本启动命令（docker run）

bash
docker run -d --name fleet-manager \
  -p 8080:8080 \  # 映射服务端口
  -v /host/path/config:/app/config \  # 挂载配置文件目录
  -v /host/path/data:/app/data \  # 挂载数据持久化目录
  -e DATABASE_URL="mysql://user:password@db-host:3306/fleet_db" \  # 数据库连接地址（必填）
  official-fleet-manager:latest

4.2 环境变量配置参数

4.3 Docker Compose配置示例

yaml
version: '3.8'
services:
  fleet-manager:
    image: docker.xuanyuan.run/official-fleet-manager:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    environment:
      - DATABASE_URL=mysql://fleet_user:fleet_pass@mysql:3306/fleet_db
      - LOG_LEVEL=INFO
      - AUTH_ENABLED=true
    depends_on:
      - mysql  # 依赖数据库服务
    restart: unless-stopped

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=fleet_db
      - MYSQL_USER=fleet_user
      - MYSQL_PASSWORD=fleet_pass
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:  # 数据库数据持久化卷

4.4 访问与初始化

1. 容器启动后，通过 http://<host-ip>:8080 访问Fleet Manager管理界面。
2. 首次登录使用默认账号密码（通常为 admin/admin），登录后需立即修改密码。
3. 进入系统后，根据实际场景配置数据源（如车队车辆列表、设备IP列表等）及监控规则。

5. 注意事项

• 数据持久化：生产环境中必须挂载/app/data目录，避免容器重启导致数据丢失。
• 数据库依赖：需提前部署MySQL或PostgreSQL数据库，并确保DATABASE_URL配置正确。
• 安全配置：启用身份认证（AUTH_ENABLED=true）并定期更新密码，避免未授权访问。
• 版本更新：建议定期拉取最新镜像（docker pull docker.xuanyuan.run/official-fleet-manager:latest）以获取新功能和安全修复。