用 LubeLogger 保存车辆保养记录：Docker 部署、里程口径与票据归档

换过几次机油以后，最容易忘的往往不是花了多少钱，而是上一次到底什么时候、多少公里换的。票据在相册里，轮胎和保险记录在另一份表格里，卖车或查维修历史时又得重新找。LubeLogger 可以把车辆、保养、加油与相关附件放到同一个入口，适合自己管理几辆车的记录。

开始之前先选一辆车，录入最近几次有票据可对照的记录。老记录缺少里程或日期时，保留缺失状态，不为了让图表完整随手补一个数。这个账本保存的是已知历史，保养周期和维修判断仍要结合车辆说明及实际情况。

部署前先确认 VPS 的磁盘、内存和公网访问条件，也可以查看雨云云服务器；注册时填写优惠码 KuZhuJi。

数据目录之外，还有一份需要保留的密钥

官方 Compose 持久保存 /App/data 和 /root/.aspnet/DataProtection-Keys。前者是应用数据，后者是 ASP.NET 数据保护密钥。迁移时两处都保留，不只复制看到照片的目录。

LubeLogger 官方界面示例

项目提供的示例用于展示记录界面，图中的车辆和金额是演示内容。自己的条目应能回到票据、里程或原始记录核对，不能把示例中的保养安排直接套给另一辆车。

记录中可能出现车牌、维修地点和个人活动信息。初次部署先用 SSH 转发，在账号与访问范围确认之前，端口只监听服务器回环地址。

mkdir -p ~/services/lubelogger/data ~/services/lubelogger/keys
cd ~/services/lubelogger

保存 compose.yaml：

services:
  lubelogger:
    image: ghcr.io/hargata/lubelogger:latest
    ports:
      - "127.0.0.1:8091:8080"
    volumes:
      - ./data:/App/data
      - ./keys:/root/.aspnet/DataProtection-Keys
    restart: unless-stopped

示例使用正式发行镜像通道。项目另有 edge 构建，可能包含尚未充分测试的功能，长期车辆档案不宜顺手换到它。首次验收后记录实际版本或镜像摘要，升级前留存数据和密钥。

docker compose config --quiet
docker compose up -d
docker compose logs --tail=100 lubelogger
ssh -L 18091:127.0.0.1:8091 user@your-server

本机打开 http://127.0.0.1:18091。先确认网页正常，在 Settings 中启用 Enable Authentication，建立 Root/Super User 的独立账号与密码，再完成一次退出和登录。LubeLogger 默认不要求认证，这一步必须在开放正式入口前完成。默认能够进入页面，不代表已经限制为自己访问；正式域名开放前要用退出登录的窗口检查。

先定单位，再录第一张加油票

一辆车采用哪种里程单位、燃油容量单位和费用币种，应在开始录入时确定。公里与英里、升与加仑混在一起，图表仍可能显示一个数字，却没有可比较的含义。迁移旧表格时保留原字段及单位，转换后抽查几条。

车辆档案中的初始里程应来自自己能够核对的记录。更换仪表、里程回拨或其他特殊情况，写进备注并保留发生时间，不直接把后续记录全部改成看起来连续的数字。

加油记录先录三到五次，核对日期、里程、加油量、费用和是否加满。部分加油与加满的记录具有不同计算条件，不能用任意两张票据推算精确油耗。遗漏中间的一次加油，也会改变这一段数据的解释。

同一辆车使用多人录入时，约定谁负责补票据、怎样处理重复。重复照片不一定是重复交易，日期相同也可能确有两次加油；删除前对照原件，而不是只按日期去重。

车辆记录、里程与恢复材料关系示意

这张图表示本文的记录与保存方式。车辆原始资料继续另存，应用负责整理，不把上传完成视为原件可以立即删除。

准备独立实例时，可在雨云选择适合的云服务器配置，优惠码 KuZhuJi。配置按实际任务选择，数据库和附件另做备份。

保养条目写清做了什么

“常规保养”这样的描述很容易在半年后失去意义。记录更换项目、使用的规格、里程、日期和维修点，能够确认的型号再填写。自己没有确认的零件品牌，不从付款金额猜测。

一张票据包含多个项目时，可以按自己的检索需要拆成条目，但要保留关联说明，避免费用被重复加总。记录维修与消耗品更换时，也把发现问题的时间和处理时间分开；两者相差几周时，只留一个日期会影响回看。

提醒功能只负责按设定条件提示。说明书规定的周期可能同时涉及时间和里程，实际车辆还受使用方式影响。建立提醒后检查它的触发条件，别只因为界面显示下一次日期，就把它当作维修建议。

需要增加服务器时，可以打开雨云选购页面，填写优惠码 KuZhuJi；迁移前保留数据与原有部署配置。

附件能打开，才算归档完成

上传一张不含个人信息的测试图片和一份测试 PDF，刷新页面后重新打开，再从另一台设备查看。核对文件完整、方向和文字可读性，尤其手机拍摄的长票据不要只看缩略图。

正式上传前可以裁去不需要的个人信息，但保留自己核对费用和项目所需内容。原图另存，上传版本与原件之间有清楚的对应关系。相册搜索不到照片时，不能只依赖文件名里的模糊日期。

应用备份和手机原图是不同副本。照片放进应用目录后，仍需纳入服务器之外的备份。打印票据会褪色，重要记录提前保存电子副本，比多年后重新识别更省事。

域名访问与成员权限最后确认

需要长期远程使用时，HTTPS 反向代理连接宿主机 127.0.0.1:8091。证书和登录都正常后，再检查记录页面及附件地址；私人记录不因前台有登录按钮就自动获得同样的附件访问限制。

多人使用先建测试账号，核对它能看到哪辆车、能否编辑和删除条目。使用当前版本提供的权限方式，不默认同一个实例中的每位用户都应看到全部车辆。若需要单独隔离，而现有功能不能满足，采用分开的实例比共享管理员更清楚。

备份前暂停应用，保存数据、密钥和部署文件：

mkdir -p backups
docker compose stop lubelogger
tar -czf "backups/lubelogger-$(date +%F-%H%M%S).tar.gz" data keys compose.yaml
docker compose start lubelogger

副本移到外部受保护的存储，另存票据原件。恢复时使用独立目录和原版本，检查车辆、几笔费用、里程顺序及附件下载。把能登录、能打开票据、能对照原记录的恢复日期记下来，真正换服务器时就知道哪份材料可用。