Ludusavi Rclone 云备份指南把游戏存档安稳上云【免费下载链接】ludusaviBackup tool for PC game saves项目地址: https://gitcode.com/GitHub_Trending/lu/ludusavi一块硬盘损坏几年的存档进度就可能清零换盘之后唯一的安慰是云端还留着副本。Ludusavi 的云备份能力正是为这种场景设计的它通过内置的 Rclone 集成把本地备份目录与任意云存储保持同步让每份游戏存档都有一份异地容灾的拷贝。 快速起步5 分钟搭好第一套云备份这一节的目标是让你在半小时内跑通本地 → 云端的完整链路不用理解每一个字段。前提是系统里已经装好 Rclone并且你知道它放在哪里路径要填给 Ludusavi。GUI 最短路径全部发生在 other 屏幕填入 Rclone 可执行路径如C:/opt/rclone.exe在远程下拉框选 Google Drive完成浏览器里弹出的授权云文件夹保持默认即可回到主界面跑一次 Back up备份完成后会看到自动上传自动同步默认开启。CLI 最短路径ludusavi cloud set google-drive ludusavi cloud upload --force第一条命令把 Rclone 远程配置写好、顺带完成授权第二条把本地备份直接推上云端。同步是怎么跑的Ludusavi 与 Rclone 各管一摊第一次上传成功之后打开引擎盖看看里面发生了什么。分工很干净Ludusavi 是打包工决定哪些文件进箱——存档识别与打包都由它完成Rclone 是搬运工只管传输、比对与上传。云备份的核心实现在 src/cloud.rs每次同步实际发出的命令是rclone sync -v --use-json-log 本地备份目录 remote_id:云路径-v --use-json-log让 Rclone 以 JSON 逐行输出日志Ludusavi 再把行翻译成三类文件级事件Copied (new)云端新增的文件记为新增Copied (replaced existing)云端已有但内容不同记为差异Deleted本地已删除的文件记为删除。stats行里的bytes/total_bytes数值则驱动进度条。还有两个小约定远端目录统一写成remote_id:path路径中的反斜杠会被转成正斜杠进程退出码为 0 判定成功而上传时若本地目录不存在此时 Rclone 返回退出码 3Ludusavi 会先创建目录再发命令。配置全景Ludusavi Rclone 配置一览这一节把 GUI、配置文件、命令行三套入口的配置项汇在一起方便按需取用。GUI other 屏幕最直观的入口云备份区块包含五类控件Rclone 可执行路径与全局参数对应apps.rclone.path/arguments远程类型下拉框None、Custom 与六种预配置服务Box、Dropbox、Google Drive、OneDrive、FTP、SMB、WebDAV选中后显示对应的凭据字段——主机、端口、账号密码WebDAV 另有 URL 与服务商云文件夹云端的目录名默认ludusavi-backup自动同步开关synchronize控制备份完成后是否自动上传上传 / 下载按钮随时手动对齐两边数据。屏幕实时执行两条校验不满足就标红remote 未配置时提示cloud not configured云路径为空或为/时提示cloud path invalid。两条都通过上传 / 下载按钮才会出现校验逻辑见 src/gui/screen.rs。config.yaml配置文件里长什么样配置文件中的相关段落完整结构见 docs/schema/config.yamlapps: rclone: path: C:/opt/rclone.exe # Rclone 可执行文件路径 arguments: --fast-list --ignore-checksum # 附加到每次 Rclone 调用的全局参数 cloud: path: ludusavi-backup remote: GoogleDrive: id: ludusavi-1234567890 synchronize: true带密码的远程FTP / SMB / WebDAV其密码字段序列化时会被跳过从不落盘。remote字段的源码注释src/resource/config.rs明确要求经 GUI 或cloud set命令修改手工改动只会更新 Ludusavi 这一侧的记录Rclone 配置里的对应远程并没有被创建或删除两边会就此脱节。CLI 两条命令链cloud set 与 upload / download子命令定义在 src/cli/parse.rs执行逻辑在 src/cli.rs。配置远程ludusavi cloud set none # 关闭云备份 ludusavi cloud set custom --id my-remote # 复用已存在的 Rclone 远程 ludusavi cloud set google-drive # Box / Dropbox / OneDrive 同理 ludusavi cloud set ftp --host ftp.example.com --username alice --password pass # 默认端口 21 ludusavi cloud set smb --host nas.example.com --username alice --password pass # 默认端口 445 ludusavi cloud set webdav --url https://dav.example.com --username alice --provider nextcloudWebDAV 的--provider可取other默认、nextcloud、owncloud、sharepoint、sharepoint-ntlm对应 Rclone WebDAV 后端的vendor参数。手动上传 / 下载与自动同步走的是同一套机制参数共享ludusavi cloud upload [--local 路径] [--cloud 路径] [--force] [--preview] [--api] [--gui] [游戏名...] ludusavi cloud download [--local 路径] [--cloud 路径] [--force] [--preview] [--api] [--gui] [游戏名...]参数含义--local本地备份目录缺省取配置文件中的backup.path--cloud云端文件夹缺省取cloud.path游戏名...只同步指定游戏也支持经 stdin 每行一个传入--preview只预览将发生的变化即 Rclone 的--dry-run不动数据--force跳过确认提示--api以机器可读 JSON 输出每个文件的同步结果--gui用 GUI 对话框做提示各远程类型要填的字段与自动附加的参数对照逻辑在Remote::config_args()见 src/cloud.rs远程类型需填写的字段写入 Rclone 配置时自动附加的参数Customid指向已有远程无不写 Rclone 配置Box / Dropboxid无走 OAuth 流程Google DriveidscopedriveOneDriveiddrive_typepersonal、access_scopesFiles.ReadWrite,offline_accessFTPhost、port、username、passwordhost、port、user、passSMBhost、port、username、passwordhost、port、user、passWebDAVurl、username、password、providerurl、user、pass、vendor本地与云端不一致时Ludusavi 的决策链这一节讲自动同步背后的判断过程是整套机制里最容易误解的部分。开启cloud.synchronize后每次备份开始时 Ludusavi 会先以上传方向发一次带--dry-run的侦察src/api.rs量出本地与云端的差距随后按结果分叉侦察无差异两边本就一致备份完成后直接上传本次产生的变更侦察有差异说明这次备份开始前两边已经分家按策略三选一策略行为适用场景Download先把云端拉到本地再开始本次备份保证mapping.yaml等元数据连贯云端比本地更新、更可信时Upload先完成本地备份结尾无条件向云端强推一次已确认本地是唯一可靠来源默认未指定方向云端原样保留记录cloudConflict需要人工查看差异后自行决定即便走 Upload 策略Ludusavi 也只同步本次备份中确有实际产物的变更游戏没变化的游戏不占网络。流程中的任何失败Rclone 不可用、网络异常等记为cloudSyncFailed与cloudConflict表示有冲突而非失败区分开【免费下载链接】ludusaviBackup tool for PC game saves项目地址: https://gitcode.com/GitHub_Trending/lu/ludusavi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考