使用文档
备份与迁移

换设备与跨存储迁移

从本地迁到云端,或更换私有服务时保留可回退的源数据

只是换客户端

如果原数据位于 OSS、COS 或私有服务,在新设备输入同一存储配置并用原主密码解锁即可,不需要重复导入一份 JSON。先验证几条记录,再继续日常使用

更换存储位置

例如桌面本地迁到 NAS、OSS 换到 COS、从旧服务器迁到新服务器:

  1. 在源端停止同时编辑,确认所有修改已成功保存
  2. 导出 JSON,记录密码数、标签数和备份时间,另存完整源目录/设置
  3. 在目标环境先用测试账号验证可以保存和重新读取
  4. 连接目标库,设置目标主密码,使用 JSON 恢复
  5. 按提示输入源备份的主密码。目标主密码可与源端不同,应分别记录
  6. 核对记录数、标签、自定义字段和备注,关闭后重新连接再检查
  7. 逐台设备切换到目标存储,确认它们都能读取一致数据
  8. 保留源数据和备份一段时间,验证完成后再决定是否清理

两边都有数据

分别备份两边,再使用合并恢复。检查重复记录与修改备注。不要直接复制 store.json 覆盖正在使用的目标库;这样可能绕过合并和主密码处理

整台私有服务迁移

停止原服务后复制完整工作目录,同时迁移 password-xl.toml 和各用户数据目录。在新服务器使用相同程序版本/镜像摘要先验证,再单独升级。文件权限、端口和 HTTPS 域名也要更新

不要同时让新旧服务写同一份共享目录。切换期间新增的数据应明确归属,避免恢复旧快照时丢失新记录