alfhou/hammond

自托管车辆和费用管理系统镜像文档

镜像概述

本镜像是一个自托管的车辆和费用管理系统，旨在帮助用户自主掌控车辆信息及相关费用数据。通过本地部署，用户可实现对车辆档案、费用记录、统计分析等功能的集中管理，适用于个人、家庭或小型组织的车辆管理需求。

核心功能和特性

• 车辆信息管理：支持录入和维护多辆车辆的基本信息，包括车型、车牌号、购买日期、保险信息等
• 费用记录跟踪：可记录车辆相关各类费用，如加油、维修、保养、保险、过路费等，并支持按时间、类型等维度筛选
• 数据自主掌控：采用自托管模式，所有数据存储在本地，保障数据隐私与安全
• 轻量化部署：基于Docker容器化部署，简化安装流程，易于维护和升级

使用场景和适用范围

• 个人车主：管理个人名下多辆汽车的日常费用及维护记录
• 家庭用户：共享管理家庭车辆，记录共同使用产生的费用
• 小型车队/组织：小型企业或团体管理少量车辆的运营成本和维护情况

使用方法和配置说明

基本部署（Docker Run）

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

bash
docker run -d \
  --name vehicle-expense-manager \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  docker.xuanyuan.run/vehicle-expense-manager:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口，可根据需要调整主机端口
• -v /path/to/local/data:/app/data：挂载本地目录到容器内数据目录，实现数据持久化，需将/path/to/local/data替换为实际本地路径

访问系统

部署完成后，通过浏览器访问 http://主机IP:8080 即可进入系统界面，首次使用需根据引导完成初始设置（如管理员账号创建等）。

数据备份

由于数据存储在挂载的本地目录，建议定期备份 /path/to/local/data 目录下的文件，以防数据丢失。

注意事项

• 确保主机已安装Docker环境
• 首次启动时，系统可能需要几分钟时间完成初始化
• 如需自定义端口或其他高级配置，请参考官方完整文档（如有）进行调整