跨设备备份与恢复 Loris Tunnel 配置
版本与截图
本指南描述当前源码版本。已发布的安装包可能功能较少；请对照发布说明确认你安装的版本。截图使用演示数据和 Pro 示例状态。
在另一台电脑上重新录入每条隧道很繁琐。Cloud Sync 可以备份配置文件，并让另一台设备先查看、再采用云端版本。它是配置备份，不是完整的整机或凭据备份。
开始之前
你需要有效的 Pro 授权、网络连接，以及一份准备好上传的本地配置。在替换重要配置前先导出一份本地副本，并想清楚哪些设备应当共用同一个云空间。
会上传什么？
备份包含实际生效的完整 config.toml，包括注释以及其中保存的 SSH 密码、私钥路径和注册码。上传走 HTTPS；服务端会对存储的备份加密。这不是客户端端到端加密，而密钥路径也不等于密钥文件本身。
以下内容不在 TOML 备份范围内：
- 私钥文件与 SSH Agent 状态。
- Dev Tunnel 登录凭据，以及
~/.cloudflared下的 Cloudflare 文件。 frp-local.json中的 FRP 服务器设置与 token。- 日志、
config.root目录指针和本地云连接设置。
普通的 TOML 导出同样可能包含密码和注册码。请把导出文件和云空间 Token 都当作私密信息保管。
连接云空间
- 打开 Sync 并启用 Cloud Sync。
- 为新空间生成一个 Token，或输入已有空间的 Token。请安全保存；重新生成 Token 会创建另一个空间。
- 检查设备名称，必要时使用测试连接，然后选择连接。
- 查看返回的状态。连接会立即检查云端，若空间为空则上传本机配置。
- 准备同步时使用立即同步。自动同步默认关闭；只有在你希望本地改动自动上传时才启用。
Token 保存在 macOS 钥匙串或 Windows 凭据管理器中。与环境相关的连接设置保存在配置旁的 sync.dev.json 或 sync.prod.json，其中不含明文 Token。
恢复云端版本
在另一台设备上激活 Pro，并用同一个 Token 连接。如果存在云端版本，先查看该版本与本地状态，再选择使用云端。如果两台设备都改过，需要决定保留哪一份完整配置；这不是逐字段合并。
确认后会整体替换本地 TOML，包括密码和授权字段。运行中的隧道会先停止；应用会保存 config.toml.before-restore，写入云端文件，然后按恢复后的自动启动与手动停止设置启动符合条件的隧道。
当前桌面界面会展示可用的云端版本和冲突选项，但不提供历史版本浏览器；不要期待按日期挑选恢复点。
验证恢复后的配置
检查跳板机、分组、端口分配和实际生效的配置目录。安装各服务商的 CLI、登录、提供密钥与凭据，并按需重新绑定 FRP 服务器。在依赖自动启动之前，先手动启动一条有代表性的隧道。
常见问题
启用自动同步会悄悄替换我的本地文件吗？
不会。替换本地配置需要确认。自动上传和云端版本检查与「接受恢复」是两回事。
云备份是永久归档吗？
不是。当前服务会在所有关联设备连续七天不活跃后删除云端备份。若需长期保留，请另做本地备份；本地配置不受云端过期影响。
为什么恢复后的密钥路径不可用？
Windows 上的路径在 macOS 上可能不存在，反之亦然。请安全地传输实际密钥并更新本地路径，或配置合适的 SSH Agent。