Zoffline项目多设备间同步骑行进度的方法解析

Zoffline项目多设备间同步骑行进度的方法解析

zwift-offline Use Zwift offline 项目地址: https://gitcode.com/gh_mirrors/zw/zwift-offline

在Zwift离线版（Zoffline）使用过程中，许多用户会遇到需要在不同设备间同步骑行数据的需求。本文将详细介绍如何安全地在Windows和Linux系统间迁移用户进度数据，并深入解析相关技术原理。

核心数据文件说明

Zoffline项目通过本地数据库文件存储用户的所有骑行数据，其中最关键的两个文件是：

1. profile.bin - 用户核心配置文件

   • 存储用户等级、里程、解锁装备等核心进度
   • 文件大小通常在几KB到几十KB之间
   • 采用二进制格式存储

2. storage.db - 完整数据库文件

   • 包含所有历史骑行记录、分段成绩、全息回放等扩展数据
   • 文件大小可能达到数百MB
   • 使用SQLite数据库格式

完整迁移步骤

对于需要完整保留所有数据的用户，建议采用以下操作流程：

1. 停止Zoffline服务

   • 在Ubuntu终端执行sudo systemctl stop zoffline
   • Windows用户通过任务管理器结束相关进程

2. 定位数据存储目录

   • Linux默认路径：/var/lib/zoffline/
   • Windows默认路径：C:\ProgramData\zoffline\

3. 复制存储文件夹

   • 使用rsync命令(Linux)：rsync -avz /var/lib/zoffline/ user@windows_host:/target/path/
   • 或直接通过U盘/USB移动硬盘拷贝整个目录

4. 权限设置(Linux)

   • 迁移到Linux后需执行：sudo chown -R zoffline:zoffline /var/lib/zoffline

精简迁移方案

若只需迁移基础进度数据，可采用简化方案：

1. 单独复制profile.bin文件
2. 覆盖目标设备的同名文件
3. 注意文件修改时间应保持一致性

技术注意事项

1. 数据库锁定机制

   • 迁移前必须确保服务停止，避免数据损坏
   • SQLite数据库在写入时会锁定整个文件

2. 跨平台兼容性

   • 二进制数据在不同系统架构间兼容
   • 注意Windows/Linux的换行符差异不影响数据读取

3. 版本兼容性

   • 建议保持服务端版本一致
   • 大版本升级时可能需要数据迁移工具

自动化方案建议

对于频繁切换设备的用户，可考虑以下进阶方案：

1. 使用云存储同步（如Nextcloud）自动同步storage目录
2. 编写shell脚本实现定时备份
3. 通过SSH实现设备间自动同步

通过以上方法，用户可以灵活地在不同设备间保持骑行数据的同步，确保训练进度的一致性。建议重要数据定期备份，避免意外丢失。

zwift-offline Use Zwift offline 项目地址: https://gitcode.com/gh_mirrors/zw/zwift-offline