车辆维护和燃油里程跟踪器LubeLogger

什么是 LubeLogger ?

LubeLogger 是一个自托管、开源、基于网络的车辆维护和燃油里程跟踪器。

LubeLogger 比较适合用来跟踪管理您的汽车的维修、保养、加油的历史记录,比用 Excel 强多了

官方提供了在线试用,可以使用用户名 test 和密码 1234 登录

试用地址:https://demo.lubelogger.com/Login/Index

镜像下载

镜像同时发布在 docker hubghcr.io 上,现在反正都是需要科学上网的,下面以 ghcr.io 为例进行说明

ghcr.io 上镜像发布的地址在 https://github.com/hargata/lubelog/pkgs/container/lubelogger

SSH 客户端登录到群晖后,依次执行下面的命令

1
2
3
4
5
6
7
8
9
10
11
# 新建文件夹 lubelogger 及子目录
mkdir -p /volume1/docker/lubelogger/{config,data,translations,documents,images,temp,log,keys}

# 进入 lubelogger 目录
cd /volume1/docker/lubelogger

# 拉取镜像
docker pull hargata/lubelogger:latest

# 拉取镜像(ghcr.io)
docker pull ghcr.io/hargata/lubelogger:latest

如果没有科学上网,很可能会拉不动,不管是 docker hub 还是 ghcr.io,都可以试试 docker 代理网站:https://dockerproxy.com/,但是会多几个步骤

1
2
3
4
5
6
7
8
# 如果拉不动的话加个代理
docker pull ghcr.dockerproxy.com/hargata/lubelogger:latest

# 重命名镜像(如果是通过代理下载的)
docker tag ghcr.dockerproxy.com/hargata/lubelogger:latest ghcr.io/hargata/lubelogger:latest

# 删除代理镜像(如果是通过代理下载的)
docker rmi ghcr.dockerproxy.com/hargata/lubelogger:latest

下载完成后,可以在 映像 中找到

命令行安装

采用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

如果你的镜像是从docker hub 下载的,请将 image: ghcr.io/hargata/lubelogger:latest 改为 image: hargata/lubelogger:latest

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
version: "3.4"

services:
app:
image: ghcr.io/hargata/lubelogger:latest
container_name: lubelogger
restart: unless-stopped
volumes:
- ./config:/App/config
- ./data:/App/data
- ./translations:/App/wwwroot/translations
- ./documents:/App/wwwroot/documents
- ./images:/App/wwwroot/images
- ./temp:/App/wwwroot/temp
- ./log:/App/log
- ./keys:/root/.aspnet/DataProtection-Keys
ports:
- 8570:8080
env_file:
- env.txt

将下面的内容保存为 env.txt

1
2
3
4
5
6
7
8
9
LC_ALL=zh_CN.UTF-8
LANG=zh_CN.UTF-8
MailConfig__EmailServer=""
MailConfig__EmailFrom=""
MailConfig__UseSSL="false"
MailConfig__Port=587
MailConfig__Username=""
MailConfig__Password=""
LOGGING__LOGLEVEL__DEFAULT=Error

环境变量的简单说明

可变
LC_ALL 区域设置和语言设置,这将影响数字、货币和日期的格式
LANG 同上。请注意,有些语言没有 UTF-8 编码
MailConfig__EmailServer 默认值为空,仅用于配置多个用户的电子邮件 SMTP 设置(发送他们的注册令牌和忘记的密码令牌)
MailConfig__EmailFrom 默认值为空,发送邮箱
MailConfig__UseSSL 是否启用 SSL,默认值为 false
MailConfig__Port 邮件服务器端口,默认值为 587
MailConfig__Username 邮件用户,默认值为空
MailConfig__Password 邮件密码,默认值为空
LOGGING__LOGLEVEL__DEFAULT 日志级别, 默认值为 Error

然后执行下面的命令

1
2
3
4
# 将 docker-compose.yml 和 env.txt 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:8570 就能看到注册界面

中文

从右上角 Setting 找到 Language 发现只有英文

https://github.com/hargata/lubelog/blob/main/wwwroot/defaults/en_US.json 可以下载到最新的英文版本,老苏通过 ChatGPT 的协助,制作了对应的 zh_CN.json

zh_CN.json 的下载地址:https://raw.githubusercontent.com/wbsu2003/synology/main/LubeLogger/zh_CN.json

Upload 上传你刚才下载的 zh_CN.json 文件,上传成功后,从 Language 中选择 zh_CN

还需要重启一次容器,才会变成中文

这个文件会在 translations 目录中找到

现在回到首页开始添加车辆

随便瞎填的

点击车辆,即可进入该车辆的 Dashboard

接下来你就填写和记录相关的信息,系统会做相应的统计

再也不用处理自制的电子表格或装满收据的鞋盒了 😂

参考文档

hargata/lubelog: LubeLogger is a web-based vehicle maintenance and fuel mileage tracker
地址:https://github.com/hargata/lubelog

LubeLogger
地址:https://lubelogger.com/

Home – LubeLogger Wiki
地址:https://docs.lubelogger.com/

LubeLogger Promotional Brochure
地址:https://lubelogger.com/brochure.pdf

hargata/lubelog_translations: Translation Files for LubeLogger
地址:https://github.com/hargata/lubelog_translations/