DBX 配置云同步
DBX 可以把连接配置、界面设置和保存的 SQL 组成一个快照，上传到 WebDAV 或私有代码片段，并在另一台设备恢复。
在 设置 → 同步 中选择同步方式：
- WebDAV：适合已有 NAS、Nextcloud、坚果云或其他 WebDAV 服务的用户，支持定时自动上传。
- GitHub / Gitee 代码片段：不需要自己维护服务器，通过私有 Gist 或私有代码片段保存快照。目前需要手动上传和下载。
同步哪些内容
| 项目 | 默认行为 |
|---|---|
| 数据库连接及普通连接参数 | 同步 |
| 侧边栏布局、固定节点 | 同步 |
| 保存的 SQL 库 | 同步 |
| 桌面和编辑器设置 | 同步 |
| 数据库密码、SSH 密码、代理密码、HTTP 隧道 Token、连接串、AI API Key | 默认不同步；可以选择加密后同步 |
| JDBC 驱动、插件和本地文件 | 不同步 |
下载会用远端快照替换本地连接元信息和保存的 SQL。恢复前请确认代码片段 ID 或 WebDAV 路径正确。
GitHub Gist
创建访问令牌
推荐使用 GitHub Fine-grained personal access token：
打开 GitHub Fine-grained token 创建页面
也可以使用 Classic token，但只应勾选 gist scope，不要授予无关权限。
首次上传
DBX 会在 Gist 中保存一个经过代码片段加密密码加密的 dbx-sync.json 文件。该密码保护完整快照，片段链接本身不会暴露连接信息、SQL 或设置；历史明文片段仍可下载一次以便迁移。
旧版本创建的明文片段不能安全地原地迁移：更新同一个 Gist 不会删除历史修订。请使用 迁移旧版代码片段 操作。DBX 会先将已有的远端快照加密写入新片段并保存新 ID，然后重新读取旧片段后才删除它；如果另一台设备已更新旧内容，则停止自动删除并提示手动清理。若旧快照包含已加密的敏感信息，请输入其原敏感信息同步密码以完成删除前验证。请轮换旧片段中可能已经暴露的凭据。
在另一台设备恢复
- 打开该私有 Gist，从地址栏复制 ID。地址通常类似
https://gist.github.com/<实际用户名>/<gist-id>，最后一段就是 ID。也可以直接访问https://gist.github.com/<gist-id>，GitHub 会跳转到包含实际用户名的地址。 - 在新设备填写相同的 GitHub 令牌和 Gist ID。
- 点击 测试，确认令牌和 ID 可访问。
- 点击 下载 并确认恢复。
Gitee 代码片段
创建私人令牌
gists）相关权限。如果界面只提供合并权限，选择能够读写代码片段的最小权限。上传与恢复
- 在 设置 → 同步 → GitHub / Gitee 中选择 Gitee 代码片段。
- 输入私人令牌。首次上传时将代码片段 ID 留空，DBX 会创建私有代码片段并保存 ID。
- 在其他设备恢复时，填写同一个代码片段 ID，然后点击 下载。
Gitee 代码片段中同样使用 dbx-sync.json 文件。
同步密码与敏感信息
GitHub Gist 和 Gitee 代码片段始终使用代码片段加密密码加密整个快照。该密码不会上传或保存，也无法找回；它与可选敏感信息的同步密码相互独立。
默认快照不会包含数据库密码等密钥。如果需要在新设备直接恢复密码：
- 开启 上传时包含加密敏感信息。
- 输入单独的 敏感信息同步密码。
- 上传快照。
- 在另一台设备开启 下载时恢复加密敏感信息 并输入同一密码；保持关闭即可保留本地密码。
同步密码使用 Argon2id 派生密钥，并使用 AES-256-GCM 加密。访问令牌只会使用设备密钥加密保存在本机，永远不会写入 dbx-sync.json。
两种密码都无法找回。GitHub/Gitee 的加密代码片段没有代码片段加密密码就无法恢复；WebDAV 中不含加密敏感信息的快照仍可不使用同步密码恢复。
WebDAV
填写 WebDAV 服务地址、用户名、应用密码和远端快照路径。默认路径为 DBX/sync/snapshot.json。
WebDAV 支持定时自动上传。自动上传只在 DBX 运行期间执行；下载始终需要手动确认，避免远端快照意外覆盖本地数据。
常见问题
HTTP 401 或 403
令牌无效、已过期，或没有代码片段读写权限。重新创建最小权限令牌后再测试。
HTTP 404
代码片段 ID 不正确，或者当前令牌无权访问该私有代码片段。
首次上传后在哪里找 ID
DBX 会自动保存 ID。也可以在 GitHub Gist 或 Gitee 代码片段页面的地址栏中查看。
多台设备可以同时自动同步吗
代码片段同步目前只支持手动上传和下载，不会自动合并两台设备上的修改。上传前建议先下载最新快照，避免覆盖另一台设备刚上传的版本。