Ludusavi 云备份如何配置：3 步接入 Rclone 把游戏存档同步到云端的完整指南
【免费下载链接】ludusaviBackup tool for PC game saves项目地址: https://gitcode.com/GitHub_Trending/lu/ludusavi
Ludusavi 是一个游戏存档备份工具，它通过内置的 Rclone（一个把云盘当文件夹用的开源同步工具）集成，把本地备份目录和任意云盘双向同步。本文讲清楚 Ludusavi 云备份的配置流程、自动上传机制和冲突处理：如何接入 Google Drive / OneDrive / FTP 等远程、备份后如何自动上传、两边不一致时如何手动对齐。读完你可以直接落地一套云端存档容灾方案，也能用命令行把它脚本化。
🧰 开始前的准备工作：4 项自检
| 检查项 | 用途 | 如何确认 |
|---|---|---|
| Ludusavi 已安装 | 扫描并备份本地存档 | 运行ludusavi --version能输出版本号 |
| Rclone 已安装 | 实际执行云端同步的引擎 | rclone version能输出（官方验证版本 1.62.2，其他版本一般也可用） |
| 云账号或服务器凭据 | 完成远程授权 / 登录 | OAuth 类（Google Drive、OneDrive 等）有账号即可；FTP / SMB / WebDAV 需备齐主机、端口、账号、密码 |
| 本地已有备份 | 云备份同步的是备份产物，不是原始存档 | 先跑过ludusavi backup，或确认 配置文件 里backup.path指向的目录有内容 |
🚀 快速上手：3 步完成 Ludusavi 云备份
第 1 步：确认 Rclone 可用。在终端运行rclone version。完成后你应该看到版本号。Ludusavi 会在系统 PATH 中自动查找 Rclone，找到后无需再填路径；找不到时需要在界面里手动填可执行文件的绝对路径（Flatpak 用户见下文）。
第 2 步：配置云远程。打开图形界面的 “other” 屏幕，在云远程下拉框中选择服务商（Box、Dropbox、Google Drive、OneDrive、FTP、SMB、WebDAV），保存。OAuth 类服务会触发浏览器授权流程，授权完成即接入成功；FTP / SMB / WebDAV 直接填写主机、端口、用户名、密码，WebDAV 额外要填 URL 和服务商类型（provider，默认other）。保存后 Ludusavi 会在 Rclone 中自动创建名为ludusavi-<时间戳>的远程，并删除上一个旧远程。也可以改用命令行：
ludusavi cloud set google-drive # FTP / WebDAV 示例： ludusavi cloud set ftp --host ftp.example.com --username alice ludusavi cloud set webdav --url https://dav.example.com --username aliceFTP 默认端口 21，SMB 默认 445，不填即可。
第 3 步：备份并验证上传。运行一次备份，开启的自动同步会在备份完成后把变更上传到云端：
ludusavi backup ludusavi cloud upload --preview完成后你应该看到：backup输出列出已备份的游戏；cloud upload --preview列出会同步的文件，两边一致时显示无变化。云端目录名默认为ludusavi-backup，可在 “other” 屏幕的云路径字段修改。
⚙️ 幕后原理（30 秒版）
Ludusavi 本身不实现任何云存储协议：它先把存档扫描、打包成本地备份文件，再调用系统里的 Rclone 执行rclone sync，让本地备份目录与云端目录对齐。Rclone 以 JSON 日志逐行汇报进度和每个文件的处理结果，Ludusavi 把这些事件翻译成界面上的进度条与“新增 / 已替换 / 已删除”列表，点取消会直接结束子进程。
自动同步采用“先预检、再动手”的策略：每次备份开始前，先做一次模拟上传（dry-run）对比本地和云端。两边一致，备份完成后直接上传新变更；一开始就不一致，云端数据保持不动，并显示冲突警告——解决方式是手动执行一次上传或下载，让两边对齐。
🛠️ 进阶玩法：按你的场景配置
场景一：只同步部分游戏
适用情况：存档总量大，只想把重点游戏的备份上传到云端。
配置方法：给上传 / 下载命令追加游戏名，多个游戏名用空格分隔，游戏名必须与本地备份目录中的名称一致：
ludusavi cloud upload "Hades II" "Baldur's Gate 3"如何验证：加--preview再跑一次，只有指定游戏目录下的文件出现在同步列表中即生效。
场景二：同步太慢时提速
适用情况：文件数量多、目录层级深，或云服务商间歇性限流。
配置方法：在apps.rclone.arguments（或 “other” 屏幕的参数栏）里追加全局参数，常用的是--transfers=1：把并发传输降为 1，可规避部分服务商的限流，代价是整体速度变慢。不配置时默认已注入--fast-list --ignore-checksum（批量列举远程、跳过哈希校验），多数情况无需改动。注意这些参数作用于 Ludusavi 发起的每一次 Rclone 调用，选参数时按全局安全原则挑选。
如何验证：ludusavi cloud upload --preview明显变快，或限流报错消失。
场景三：Linux Flatpak 环境接入
适用情况：用 Flatpak 安装的 Ludusavi 在沙箱内看不到宿主机的系统 Rclone。
配置方法，二选一：
| 方式 | 操作 | 何时选用 |
|---|---|---|
| 用包内 Rclone | Rclone 路径填/app/bin/rclone | 最省事，Flatpak 包自带一份 Rclone |
| 复用宿主机 Rclone | 先执行flatpak override com.github.mtkennerly.ludusavi --filesystem=host，路径填/var/run/host/usr/bin/rclone；要复用宿主机已有远程配置时，参数栏追加--config /home/<用户名>/.config/rclone/rclone.conf | 宿主机 Rclone 已完成过 OAuth 授权 |
如何验证：ludusavi cloud upload --preview不再报 Rclone 不可用。
场景四：复用已配好的 Rclone 远程
适用情况：你已经在系统 Rclone 里配置并授权过某个远程（比如叫mydrive）。
配置方法：ludusavi cloud set custom --id mydrive。Custom 类型只做引用，不写配置、不触发 OAuth，旧远程也不会被删除。不配置的话，其余服务类型每次都会新建一个ludusavi-<时间戳>远程。
如何验证：ludusavi cloud upload --preview能正常列出文件。
❌ 常见坑与排错：云备份失败时先看这里
| 现象 | 最可能原因 | 解决办法 |
|---|---|---|
| 报 Rclone 不可用 | Rclone 没装，或路径没填对 | 装 Rclone；或填对可执行文件绝对路径（Flatpak 填/app/bin/rclone） |
| 云路径无效警告 | 云路径为空或填了/ | 改成具体目录名，如ludusavi-backup |
备份后提示cloudConflict | 本地和云端本就不一致，自动同步被暂停保护云端 | 手动执行ludusavi cloud upload --force或cloud download --force对齐两边 |
| 上传中途报限流 / 超时 | 云服务商限流或网络抖动 | apps.rclone.arguments加--transfers=1；仍反复失败则检查网络与云端服务状态 |
| OAuth 授权失败，远程没建好 | 授权中断或远程创建失败 | 重新运行对应的ludusavi cloud set子命令，让它重建远程并重新授权 |
| 界面提示 cloud not configured | cloud.remote还是空 | 完成第 2 步的远程配置 |
❓ 高频问答：读者常问的 3 个问题
问：Ludusavi 自带 Rclone 吗？
不自带。你需要先在系统里装好 Rclone，Ludusavi 会在 PATH 中自动查找；Flatpak 沙箱例外，它内置了一份，路径填/app/bin/rclone即可。
问：出现冲突警告后我该怎么办？
先想清楚哪边才是你想保留的版本，然后手动执行一次ludusavi cloud upload --force（以本地为准）或ludusavi cloud download --force（以云端为准），让两边一致后再跑备份即可。
问：怎么确认云备份真的生效了？
运行ludusavi cloud upload --preview：列出待同步文件说明有差异；显示无变化说明本地和云端已一致。想看机器可读结果，加--api输出 JSON。
以上配置完成后，你的存档就拥有了云端副本，换机或误删时可以直接从云端恢复。更多细节见 docs/help/cloud-backup.md 与 docs/help/configuration-file.md。
【免费下载链接】ludusaviBackup tool for PC game saves项目地址: https://gitcode.com/GitHub_Trending/lu/ludusavi
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
