# 云同步

云同步用于在设备不处于同一本地网络时，让章鱼速贴的部分数据持续保持一致。它通过你配置的 WebDAV / S3 存储路径同步数据。

> [!INFO] 付费功能
> 云同步是付费功能。建议先用免费版 + 附近同步验证第一次跨设备复制粘贴，再在需要跨网络或长期多设备同步时启用云同步。

## 什么时候使用云同步

适合使用云同步的情况：

- 你的设备经常不在同一网络；
- 你希望剪贴、收藏、别名和部分设置长期跟随多台设备；
- 本地设备发现被路由器、VPN、访客 Wi-Fi 或企业网络拦截；
- 你希望使用自己可控的 WebDAV / S3 存储路径。

如果两台设备在同一本地路径下，优先使用 [附近同步](/features/nearby-sync)。

## 可以同步什么

根据当前设置和版本，云同步可能包括：

- 按同步范围选择的剪贴历史；
- 收藏夹和收藏内容；
- 别名和可复用输入数据；
- 部分同步元数据和偏好设置。

建议先从较窄范围开始，例如只同步收藏和别名，确认成功后再扩大到完整剪贴历史。

## 初次配置步骤

:::steps
:::step{title="确认当前设备已激活付费功能"}

云同步只在已启用付费功能的设备上可用。当前方案与可激活设备数以 [官网定价页](https://octoclip.app/zh/pricing.html) 及应用内许可证页面为准。

:::
:::step{title="打开云同步设置"}

进入章鱼速贴设置，打开云同步入口。

:::
:::step{title="选择 WebDAV 或 S3"}

准备服务商地址、账号、凭据、桶或路径、区域等信息。

:::
:::step{title="选择同步范围"}

先选择较小范围。第一次同步成功后，再按需要扩大范围。

:::
:::step{title="在其他已激活设备上配置同一路径与密钥"}

多台设备需要使用**同一存储路径，以及完全相同的加密密钥**。云同步内容用你持有的密钥端到端加密，密钥不一致的设备无法解密——即使网络正常，内容也会静默无法显示。

:::
:::step{title="先用短文本测试"}

在设备 A 复制一段唯一文本，再确认设备 B 是否出现同一条记录。
:::
:::

## 同步行为说明

- 云同步目标是最终一致，不是强实时镜像。
- 有新数据时，一个匿名通知服务会提示你的其他设备来拉取。该信号只表示"有新数据"，不携带任何剪贴内容或密钥。
- 离线期间的变更会先保存在本地，联网后再同步。
- 多设备并发修改时，最终结果可能取决于较新的版本或产品内冲突处理策略。
- 大图片和文件通常会比短文本更慢。

## 安全与存储边界

云同步内容会**在你的设备上用你设定的密钥进行端到端加密**，再以密文形式上传。你的加密密钥与存储凭据保存在设备的钥匙串 / 安全存储中，**不会**存放在任何章鱼速贴的服务器上。第二台设备需要**相同的存储配置和相同的密钥**才能解密。章鱼速贴和你的存储服务商只能看到密文。

> [!DANGER] 妥善保管你的加密密钥
> 一旦丢失加密密钥，存储桶中已加密的剪贴将无法恢复——包括章鱼速贴在内，任何人都无法解密。请在启用云同步前把密钥保存到密码管理器中。

云同步的数据路径仍取决于你配置的 WebDAV / S3 服务商。章鱼速贴无法控制该服务商的可用性、保留、地区和备份策略——这些仍由你的存储服务商负责。请确认服务商的访问控制和安全设置。

涉及敏感剪贴时，建议：

- 不同步完整剪贴正文；
- 缩短历史保留时间；
- 排除敏感应用或来源；
- 能用本地流程时尽量使用本地流程。

## 常见排查

云同步失败时按这个顺序检查：

1. 两台设备都已激活付费功能。
2. 两端都开启了云同步。
3. 服务商地址、凭据、桶/路径和区域配置正确。
4. 两台设备使用**相同的加密密钥**（密钥不一致会导致无法解密，内容已到达却无法显示）。
5. 同步范围包含你正在测试的内容。
6. 网络没有拦截访问服务商。
7. 先用短文本测试，再测试文件。

继续查看 [同步失败](/advanced/troubleshooting/sync-failed) 或 [日志与诊断](/advanced/troubleshooting/logging-and-diagnostics)。