hargata/lubelogger

LubeLogger Docker镜像文档

概述

本Docker镜像为LubeLogger提供容器化部署方案。LubeLogger是一款开源、自托管、支持协作的车辆维护与燃油里程追踪工具，旨在帮助用户便捷管理车辆维护记录、跟踪燃油消耗及里程数据。项目源码托管于https://github.com/hargata/lubelog%E3%80%82

核心功能与特性

• 开源免费：基于开源许可协议发布，代码完全透明，支持自定义扩展
• 自托管部署：可部署在个人服务器或私有环境中，保障数据隐私与安全
• 协作管理：支持多用户协作，适合家庭共享车辆或小型车队管理
• 车辆维护记录：记录保养、维修、零件更换等维护信息，支持提醒功能
• 燃油里程追踪：自动计算燃油效率，记录加油记录，生成里程统计报表

使用场景

• 个人车主：管理私家车的保养周期、燃油消耗，优化用车成本
• 小型车队：跟踪多辆运营车辆的维护状态和燃油使用情况，降低管理成本
• 家庭共享车辆：家庭成员共同记录车辆使用及维护信息，避免信息遗漏

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 已安装Docker Compose（可选，用于多容器部署）

Docker快速启动

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

docker
docker run -d \
  --name lubelogger \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  --restart unless-stopped \
  hargata/lubelog:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口（可根据需要修改主机端口）
• -v /path/to/local/data:/app/data：挂载本地目录到容器内数据目录，持久化存储应用数据
• --restart unless-stopped：容器退出时自动重启（可选）

Docker Compose部署（推荐）

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  lubelogger:
    image: hargata/lubelog:latest
    container_name: lubelogger
    ports:
      - "8080:80"
    volumes:
      - ./lubelog-data:/app/data
    restart: unless-stopped

执行启动命令：

bash
docker-compose up -d

访问应用

容器启动后，通过浏览器访问 http://<主机IP>:8080 即可打开LubeLogger应用界面，首次使用需完成初始配置（创建管理员账户、添加车辆信息等）。

注意事项

• 数据卷挂载为必填项，否则容器重启后数据将丢失
• 生产环境建议配置反向代理（如Nginx）并启用HTTPS加密
• 详细配置及高级功能请参考项目https://github.com/hargata/lubelog