企业官网建设流程全解析

Ludusavi 云备份如何配置：3 步接入 Rclone 把游戏存档同步到云端的完整指南

【免费下载链接】ludusaviBackup tool for PC game saves项目地址: https://gitcode.com/GitHub_Trending/lu/ludusavi

Ludusavi 是一个游戏存档备份工具，它通过内置的 Rclone（一个把云盘当文件夹用的开源同步工具）集成，把本地备份目录和任意云盘双向同步。本文讲清楚 Ludusavi 云备份的配置流程、自动上传机制和冲突处理：如何接入 Google Drive / OneDrive / FTP 等远程、备份后如何自动上传、两边不一致时如何手动对齐。读完你可以直接落地一套云端存档容灾方案，也能用命令行把它脚本化。

🧰 开始前的准备工作：4 项自检

🚀 快速上手：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 alice

FTP 默认端口 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。

配置方法，二选一：

如何验证：ludusavi cloud upload --preview不再报 Rclone 不可用。

场景四：复用已配好的 Rclone 远程

适用情况：你已经在系统 Rclone 里配置并授权过某个远程（比如叫mydrive）。

配置方法：ludusavi cloud set custom --id mydrive。Custom 类型只做引用，不写配置、不触发 OAuth，旧远程也不会被删除。不配置的话，其余服务类型每次都会新建一个ludusavi-<时间戳>远程。

如何验证：ludusavi cloud upload --preview能正常列出文件。

❌ 常见坑与排错：云备份失败时先看这里

❓ 高频问答：读者常问的 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