serotonie/ovms-admin_mosquitto

OVMS Admin Docker镜像文档

镜像概述

OVMS Admin是针对开放车辆管理系统(Open Vehicle Management System, OVMS)设计的管理端Docker镜像，旨在提供便捷、高效的车辆系统管理能力。通过该镜像，管理员可实现对车辆数据的集中管理、实时状态监控及系统参数配置，简化OVMS的部署与运维流程。

核心功能与特性

• 车辆数据管理：支持车辆信息录入、编辑、查询及删除，维护车辆基础数据（如型号、VIN码、所属用户等）。
• 实时状态监控：实时显示车辆位置、行驶状态、电池电量（电动车）、油耗（燃油车）等关键指标，支持异常状态告警。
• 系统配置：提供OVMS服务参数配置界面，包括数据上报频率、告警阈值、通信协议等，支持配置持久化。
• 用户权限管理：支持多角色用户管理，可配置管理员、操作员等不同权限，保障系统安全。
• 数据可视化：通过图表展示车辆运行数据趋势，如行驶里程统计、能耗分析等，辅助决策。

使用场景与适用范围

• 车队管理：企业或组织用于管理多辆运营车辆，监控行驶路线、油耗/电耗，优化车队调度。
• 车辆监控中心：作为车辆监控中心的核心管理工具，实时掌握车辆动态，快速响应异常情况。
• 个人车辆管理：个人用户通过管理端配置个人车辆参数，查看历史行驶数据及车辆健康状态。
• OVMS二次开发：开发者可基于该镜像快速部署管理端，专注于功能扩展与定制化开发。

使用方法与配置说明

快速启动

通过以下命令快速启动OVMS Admin容器：

bash
docker run -d \
  --name ovms-admin \
  -p 8080:80 \
  -e OVMS_SERVER_URL=http://ovms-server:8000 \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=securepassword \
  ovms/admin:latest

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问管理界面。
• -e OVMS_SERVER_URL：指定OVMS服务端地址，用于连接车辆数据服务。
• -e ADMIN_USER：初始管理员用户名，默认值为admin。
• -e ADMIN_PASSWORD：初始管理员密码，建议部署时修改为强密码。

环境变量配置

持久化配置

为避免容器重启后配置丢失，可挂载本地目录持久化配置文件：

bash
docker run -d \
  --name ovms-admin \
  -p 8080:80 \
  -v /path/to/local/config:/app/config \
  -e OVMS_SERVER_URL=http://ovms-server:8000 \
  ovms/admin:latest

其中/path/to/local/config为本地目录，用于存储系统配置、用户数据等。

访问管理界面

容器启动后，通过浏览器访问 http://<主机IP>:8080，使用配置的管理员账号密码登录，即可进入管理界面进行车辆管理操作。

注意事项

• 生产环境中需修改默认管理员密码，避免安全风险。
• 确保OVMS服务端与管理端网络连通，OVMS_SERVER_URL配置正确。
• 如需高可用性，建议结合Docker Compose或Kubernetes进行部署，配置健康检查与自动重启。