LubeLogger 车辆档案部署:保养、加油票据与双目录恢复
固定官方版本,先启用私人登录,再核对里程单位、保养与附件,保存 data 和数据保护密钥并演练副本恢复。
保养票据保存在相册里,里程写在另一份表格里,到下次换机油时,往往又要找上次的日期和项目。LubeLogger 可以把车辆、维修、加油与附件放到同一份档案里。先录一辆车的几条可核对记录,走完保存、下载与恢复,再迁移多年资料。
本文固定官方 v1.7.4,以默认 LiteDB 保存数据,先通过 SSH 设置认证。本例按单人私人档案用途配置,不接 SMTP、OIDC、地图、Webhook 或外部通知,也不启用自动事件。里程、费用和维修内容来自自己的凭据,缺项保留为空;记录软件不替代车辆手册和维修判断。
数据目录之外,还有一份需要保留的密钥
本例持久保存 /App/data 与 /root/.aspnet/DataProtection-Keys。前者包含 cartracker.db、配置、图片和票据文件,后者是框架数据保护密钥。该版本用这些密钥保护登录 cookie,不意味着整份车辆数据库或附件都已加密;丢失密钥不能直接等同于丢失全部车辆记录,但会影响既有登录状态。
先复用还有余量的 Linux VPS。示例给应用设置 512 MiB 上限,这不是最低配置或性能保证;系统、已有服务、票据原件和一次恢复副本另需空间。车辆照片通常比文字条目更占磁盘,先看实际附件大小。个人档案不需要住宅 IP,也不必为少量记录单独追求大带宽。
确需新实例时,可查看雨云 RCS 的地区与配置,比较自己手机常用网络的访问条件、本地磁盘、月付、续费与异地备份费用。先用少量记录核对登录、附件和恢复,再决定长账期;已有服务器够用就继续使用。
以下在已有 Docker Engine 与 Compose 插件的 Linux root shell 中建立新实例。先拒绝已有目录或同名符号链接,避免覆盖旧库。
set -eu
umask 077
test ! -e /srv/lubelogger
test ! -L /srv/lubelogger
mkdir -p /srv/lubelogger/data /srv/lubelogger/keys
chmod 700 /srv/lubelogger
cd /srv/lubelogger
保存 compose.yaml。端口只绑定服务器回环地址,两个持久目录互不嵌套,镜像版本与多架构摘要一起固定。
services:
lubelogger:
image: ghcr.io/hargata/lubelogger:v1.7.4@sha256:483a9d7582c4e6258615fd822b3de4193b4fcc4230d0a92432c6d407faf75af2
restart: unless-stopped
environment:
TZ: Asia/Shanghai
ports:
- "127.0.0.1:8091:8080"
volumes:
- ./data:/App/data
- ./keys:/root/.aspnet/DataProtection-Keys
mem_limit: 512m
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
这里沿用官方镜像默认运行用户,不自行指定 user。镜像环境中存在 APP_UID,不等于应用已按该 UID 非 root 运行;更换运行身份与密钥路径要另行核对,不能只改目录权限。
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=80 lubelogger
在自己的电脑另开终端,替换 SSH 用户和主机:
ssh -N -L 18091:127.0.0.1:8091 user@your-server
打开 http://127.0.0.1:18091。默认部署不要求认证,先在 Settings 勾选 Enable Authentication,建立 Root/Super User 的独立用户名与密码,完成退出、重新登录。用新的未登录窗口检查车辆页和一份测试附件,确认出现登录要求、没有返回原文件,再安排外部访问。不要把首页可打开或登录按钮存在当作认证已生效。
先定单位,再录第一张加油票
先确定里程使用公里还是英里、燃油使用升还是加仑,以及日期、小数点和货币显示习惯。区域设置影响输入和展示,切换地区不等于已经把旧记录换算成另一币种。更换区域设置后按官方要求重启应用,再用一条虚构记录核对金额与日期,避免小数分隔符被错误解释。
保留旧表格及单位,先迁移几条完整记录。里程来自仪表、票据或能够核对的历史,不为了让曲线连续而补数;更换仪表或里程口径发生变化时,在备注写清发生日期与前后口径。
加油记录核对日期、里程、加油量、费用以及是否加满。部分加油、漏记一次或单位混用都会影响油耗解释,不用任意两张票据推导精确油耗。先把原始记录录准,再看图表有没有符合这些条件。
同日两条记录可能是真实的两次加油,也可能是重复导入。按票据和账户记录核对后再删,不只按日期去重。保存后从独立浏览器配置重新登录,抽查日期、里程和金额,确认看到的不是当前表单里尚未保存的值。
保养条目写清做了什么
比起只写“常规保养”,留下具体更换项目、规格、里程和日期更方便回看。能从票据确认的型号再填写,不从付款金额猜零件品牌;发生故障和实际维修不是同一天时,把两个时间分开记。
一张票据包含多个项目,可以按自己的检索习惯拆条,但要保留关联,并检查费用是否被重复加总。配件采购、正式更换和库存也有不同含义,不把买到配件当天自动当成装车日期。
提醒需要按自己的时间或里程条件设置,再用临时测试条件核对显示。本文未配置发信和自动事件服务,不把界面出现提醒等同于邮件已经送到。要启用外部通知时,另行核对当前版本的任务前置、时区、收件渠道与发送结果;不要为了验证提醒修改真实保养历史。
附件能打开,才算归档完成
先上传一张无个人信息的测试图片和一份测试 PDF。离开编辑页、重新打开,再下载原附件,核对文件字节、页面数量、方向与可读性。缩略图正常不等于 PDF 完整,文件名相同也不等于内容相同。
票据可能带有车牌、姓名、维修位置和联系方式,上传前裁去不需要的信息,原件继续另存。应用里的副本与手机上的原图各有用途,不能因为上传成功就删除唯一原件。
v1.7.4 的图片、文档和临时文件路由要求登录,但这些文件路由没有逐车的协作者筛选。车辆列表互不可见,不能证明拿到附件直链的另一个已登录账号也被隔离。因此本例按单人私人实例配置,不在同一多人实例里存放彼此需要隔离的敏感票据。
未登录窗口的检查应确认没有拿到原始文件,可能表现为跳转登录页,不强求某个固定错误码。确需家庭成员分别保存私密资料时,先验证完整的附件访问边界,或使用各自独立实例;不以难猜的文件名代替权限。
域名访问与成员权限最后确认
需要远程访问时,在宿主机现有 Caddy 配置中加入自己的域名。替换示例域名,确认 DNS、80/443 与证书申请条件,验证配置后再重载,保留其他站点。
carlog.example.com {
reverse_proxy 127.0.0.1:8091
}
正式 HTTPS 入口还需重验退出登录、登录、上传与下载。代理位于另一个容器时,127.0.0.1 指向代理自身,需要按已有网络连接应用。仅通过私有网络使用也可以,不必为完成部署而开放公网入口。
Root/Super User 能看到所有车辆,也能备份、恢复和关闭认证。普通用户与 Admin 的车辆范围受协作者和 household 等授权关系控制,Admin 还可以管理用户,不适合作为不受信任的访客角色。需要另建日常账号时,用管理员生成与邮箱绑定的一次性邀请令牌;不启用免邀请公开注册。没有 SMTP 就不会自动收到邀请邮件,令牌需要通过自己的受保护方式交付,不能贴在公开页面。
冷备数据、密钥和配置
普通记录导出方便迁移,应用生成的备份 ZIP 也不包含 Docker 的数据保护密钥目录。本例换机需保存同一时间点的 data、keys、Compose 及实际使用的 .env,不能只拿 CSV 或一个 ZIP 就认定灾备齐全。
已经改用 PostgreSQL 或另有外挂目录的实例,需要另外备份这些资源,不直接套用本例整包。
先暂停录入与上传,在维护窗口执行以下冷备。停止失败或 OOM 时拒绝归档;中途异常会尝试启动原服务,未完成文件保留 .partial 后缀。
set -eu
cd /srv/lubelogger
umask 077
mkdir -p /srv/lubelogger-backups
snapshot=$(mktemp -d /srv/lubelogger-backups/cold-XXXXXX)
cid=$(docker compose ps -q lubelogger)
test -n "$cid"
set -- compose.yaml data keys
if [ -f .env ]; then set -- "$@" .env; fi
trap 'docker compose start lubelogger >/dev/null' EXIT
docker compose stop -t 60 lubelogger
state=$(docker inspect --format '{{.State.Status}} {{.State.OOMKilled}} {{.State.ExitCode}}' "$cid")
case "$state" in
"exited false 0"|"exited false 143") ;;
*) printf '未确认正常停止,拒绝归档:%s\n' "$state" >&2; exit 1 ;;
esac
tar --numeric-owner -czpf "$snapshot/instance.tar.gz.partial" \
-C /srv/lubelogger "$@"
tar -tzf "$snapshot/instance.tar.gz.partial" >/dev/null
mv "$snapshot/instance.tar.gz.partial" "$snapshot/instance.tar.gz"
(cd "$snapshot" && sha256sum instance.tar.gz > SHA256SUMS)
docker compose start lubelogger
trap - EXIT
printf '备份目录:%s\n' "$snapshot"
将归档和校验文件加密保存到另一台设备。包中有车辆记录、附件、账号与设置,不放在网站目录,也不把同盘副本当作异地备份。
从空目录恢复后再升级
在有余量的测试主机使用相同版本,从新空目录恢复。替换 snapshot,只解压自己创建的可信归档:
set -eu
snapshot=/srv/lubelogger-backups/cold-实际后缀
(cd "$snapshot" && sha256sum -c SHA256SUMS)
restore=$(mktemp -d /srv/lubelogger-restore.XXXXXX)
tar --numeric-owner -xzpf "$snapshot/instance.tar.gz" -C "$restore"
cd "$restore"
cp compose.yaml compose.restore.yaml
在 compose.restore.yaml 中,只把回环端口改为 127.0.0.1:8092:8080,restart 改为 "no";固定镜像与两个 ./data、./keys 挂载保持原样。上述配置不启用外部集成;从已有服务恢复时,先停用其 SMTP、Webhook、自动事件等出口,否则先核材料,不启动副本。
project="lubelogger-recovery-$(basename "$restore" | tr 'A-Z.' 'a-z-')"
docker compose -p "$project" -f compose.restore.yaml config --quiet
docker compose -p "$project" -f compose.restore.yaml up -d
docker compose -p "$project" -f compose.restore.yaml logs --tail=80 lubelogger
保持这个目录和终端,在自己的电脑另开 SSH 转发,将 user@test-server 替换为测试主机:
ssh -N -L 18092:127.0.0.1:8092 user@test-server
打开 http://127.0.0.1:18092,用新的浏览器配置登录原账号,核对车辆、单位、几条保养与加油记录,并下载测试附件比较字节。再新增一条虚构记录、重启副本并重新查询。回环绑定只限制入站,不等于禁止容器向外联网;需要完全隔离出口时,先配置相应网络限制。
检查未完成时保持恢复待验,不把首页、登录或压缩包校验单独当作完整恢复。验完在副本目录执行 docker compose -p "$project" -f compose.restore.yaml stop,保留材料。升级前阅读目标版本说明,先保留旧镜像与两份数据目录;数据库已被新版本迁移时,退回需要恢复升级前数据并配套旧镜像,不能只把 tag 改回去。
推荐码:KuZhuJi




