akhilrex/hammond

Hammond Docker镜像文档

概述

Hammond是一个自托管的车辆管理系统，用于跟踪所有车辆的燃油及其他相关费用，支持多用户共享多车辆。它是久未更新的Clarkson系统的继任者，采用更现代的技术栈构建，旨在提供更优的性能和用户体验。

核心功能和特性

主要功能

• 从Clarkson系统迁移数据
• 添加和管理多辆车辆
• 支持多用户账户管理
• 跟踪燃油消耗和其他车辆费用
• 实现车辆在多用户间的共享
• 为车辆保存附件（如收据、照片等）
• 快速记录功能（拍摄收据或加油屏幕照片，稍后补录）
• 车辆级别和整体费用报告

技术栈

• 后端：Go、Go-Gin、GORM
• 数据库：SQLite
• 前端：VueJS、Vuex、Buefy

使用场景和适用范围

适用于需要管理多辆车辆费用的个人或小型团队，尤其是：

• 家庭多车辆费用跟踪
• 小型车队管理
• 希望自托管数据、保护隐私的用户
• 原Clarkson用户寻求升级方案

安装与使用方法

Docker快速部署

测试/评估部署（无数据持久化）

bash
docker run -d -p 8080:8080 --name=hammond docker.xuanyuan.run/akhilrex/hammond

生产环境部署（数据持久化）

bash
docker run -d -p 8080:8080 --name=hammond \
  -v "/host/path/to/assets:/assets" \
  -v "/host/path/to/config:/config" \
  docker.xuanyuan.run/akhilrex/hammond

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '2.1'
services:
  hammond:
    image: docker.xuanyuan.run/akhilrex/hammond
    container_name: hammond
    volumes:
      - /path/to/config:/config  # 配置文件目录
      - /path/to/data:/assets   # 数据和附件存储目录
    ports:
      - 8080:8080  # 端口映射，左侧为宿主机端口
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

首次设置指南

系统初始化

首次访问部署后的Hammond（默认地址http://localhost:8080），将显示两个选项：

1. 从Clarkson迁移数据
2. 全新设置

从Clarkson迁移数据

• 确保Clarkson数据库可被Hammond访问（可通过临时容器托管备份数据库）
• 输入Clarkson数据库连接字符串，格式如下：

  user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
  

• 验证连接后完成迁移，迁移的用户密码将统一重置为hammond

全新设置

• 输入管理员姓名、***和密码
• 完成后跳转至登录页面
• 建议先进入设置页面配置系统参数，再添加车辆和费用记录

许可证

采用GPL-3.0许可证，详见项目https://github.com/akhilrex/hammond/blob/master/LICENSE.txt%E6%96%87%E4%BB%B6%E3%80%82

开发路线图

• 更多报告类型
• 车辆维护提醒功能（如保养周期）
• 多平台原生安装程序（Windows/Linux/MacOS）

项目信息

• 项目地址：https://github.com/akhilrex/hammond
• 开发者：Akhil Gupta (@akhilrex)

注意：项目处于活跃开发中，建议使用https://github.com/containrrr/watchtower%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E5%AE%B9%E5%99%A8%EF%BC%8C%E6%88%96%E5%AE%9A%E6%9C%9F%E6%89%8B%E5%8A%A8%E6%9B%B4%E6%96%B0%E9%95%9C%E5%83%8F%E3%80%82