同步与恢复
Nokuo 的本地同步目录、S3 兼容对象存储、恢复和多设备使用方式。
两种同步方式
Nokuo 的同步围绕加密后的 Vault 文件展开。你可以选择本地同步目录，也可以使用 S3 兼容对象存储。
本地同步目录
你可以把 Vault 放在 iCloud、OneDrive、Syncthing、飞牛同步、NAS 同步或其他本地同步目录中。
这种方式的特点是：
- Nokuo 只读写本地 Vault 目录。
- 同步工具负责把加密后的 Vault 文件复制到其他设备。
- 适合已经有稳定本地同步工具的个人用户。
先在设置里完成同步目录和前置条件配置，页面变成可同步状态后，再让本地同步工具接管文件复制。
S3 兼容对象存储
对象存储同步适合需要更顺手同步、恢复和历史版本体验的个人用户。对象存储同步可用于 S3、Cloudflare R2、阿里云 OSS、MinIO 等 S3 兼容服务。
你需要在桌面端配置 endpoint、region、access key、secret key 和 bucket 等信息。同步目标中保存的是加密后的 Vault 文件，不是明文资料。
各平台怎么填
先记住一条：这套配置的核心是同一组字段，不是每个平台一套新逻辑。
endpoint：对象存储服务地址region：区域名，部分服务可以自动推导access key/secret key：访问凭证bucket：目标桶名
常见平台的填写方式如下：
| 平台 | 怎么选 | region | endpoint |
|---|---|---|---|
| 阿里云 OSS | 选择「阿里云 OSS」 | 选实际区域，例如 cn-beijing、cn-hangzhou | 一般自动变成 https://oss-<region>.aliyuncs.com |
| AWS S3 | 选择「AWS S3」 | 选实际区域，例如 us-east-1、ap-southeast-1 | us-east-1 用 https://s3.amazonaws.com，其他区域用 https://s3.<region>.amazonaws.com |
| 腾讯云 COS | 选择「腾讯云 COS」 | 选实际区域，例如 ap-guangzhou、ap-shanghai | 一般自动变成 https://cos.<region>.myqcloud.com |
| 七牛云 Kodo | 选择「七牛云 Kodo」 | 选七牛区域，例如 cn-east-1、ap-southeast-1 | 一般自动变成 https://s3-<region>.qiniucs.com |
| 火山引擎 TOS | 选择「火山引擎 TOS」 | 选实际区域，例如 cn-beijing、cn-shanghai | 一般自动变成 https://tos-s3-<region>.volces.com |
| Cloudflare R2 | 选择「Cloudflare R2」 | 填 auto | 填 https://<ACCOUNT_ID>.r2.cloudflarestorage.com |
| 自建 / 其他兼容服务 | 选择「自建 / 其他 S3 兼容」 | 按服务要求填写；不确定时先用 auto | 手动填服务给你的兼容 S3 地址 |
注意：
- 这里的「D1」不属于 S3 兼容对象存储，不能用在这条同步线上。
- 如果你用的是 MinIO、NAS 上的 S3 兼容服务，通常走「自建 / 其他 S3 兼容」。
- 如果你只想做本地同步目录，不需要配置这里这一组字段。
官方链接
- 阿里云 OSS：官网 OSS 产品页，教程 OSS 文档
- AWS S3：官网 Amazon S3，教程 Getting started
- 腾讯云 COS：官网 Cloud Object Storage，教程 Quick Start
- 七牛云 Kodo：官网 对象存储 Kodo，教程 快速入门文档
- 火山引擎 TOS：官网 TOS 概览，教程 帮助文档
- Cloudflare R2：官网 R2 Overview，教程 Get started
恢复流程
如果你是换设备、重装应用，或者需要把备份重新写回本地，正常恢复只走“远程地址 + 恢复目录 + 主密码”这条线。
1. 打开恢复页并填写远程地址
先打开恢复页，填好远程地址，再选择本地恢复目录。
2. 配置对象存储
填写 endpoint、region、access key、secret key 和 bucket，然后测试连接并加载远端 Vault 列表。
如果你还没配过，可以先参考上面的平台对照表；恢复页和设置页用的是同一套字段。
3. 选择要恢复的 Vault
从远端列表里选中要恢复的 Vault，确认覆盖提示后开始恢复。
4. 恢复后输入主密码
恢复完成后，应用会回到解锁页。这里输入主密码就能继续使用，不需要恢复密钥。
5. 忘记主密码时走恢复密钥
恢复密钥是另一条线，只在忘记主密码时使用。验证恢复密钥后，再设置新的主密码。
什么时候适合对象存储同步
如果你需要更大容量、对象存储同步、恢复和历史版本能力，可以考虑这条路线。