WebDAV 同步

WebDAV 同步功能允许你通过 WebDAV 协议将输入方案配置和用户数据备份到远程服务器，或在多台设备之间同步配置。

同步内容

功能备份以下文件：

目录	文件	说明
rime/	*.yaml	输入方案定义、词典文件和用户配置

不同步的内容：

• rime/build/ — Rime 编译产物（部署时自动重新生成）
• rime/*.userdb/ — 用户自造词数据库（各设备独立，同步会导致冲突）

准备工作

1. 注册 WebDAV 服务

选择一个支持 WebDAV 协议的云存储服务：

服务	服务器地址	备注
坚果云	dav.jianguoyun.com	国内速度快，免费账户有流量限制
Nextcloud	自建服务器地址	开源，可自建
ownCloud	自建服务器地址	开源，可自建
Synology NAS	地址:5006	群晖 NAS 自带 WebDAV Server

2. 获取访问凭证

坚果云为例：

1. 打开坚果云 App 并登录
2. 进入「设置」→「第三方应用管理」
3. 点击「添加应用密码」
4. 生成一个应用密码（注意：不是登录密码，登录密码不能用于 WebDAV 访问）
5. 记下生成的应用密码

3. 配置服务器信息

在设置页面：

1. 进入「设置」→「同步与备份」→「WebDAV 同步」
2. 填写以下信息：

字段	坚果云示例	说明
服务器地址	https://dav.jianguoyun.com/dav	WebDAV 服务器地址
用户名	[email protected]	坚果云登录邮箱
密码	步骤 2 生成的应用密码	应用密码，不是登录密码
远程路径	xime	远程目录名，会在服务器上创建同名文件夹

4. 测试连接

填写完成后点击「测试连接」，成功后会显示「连接成功」。

上传备份

点击「上传到服务器」将本地配置备份到远程 WebDAV 服务器。

• 上传会覆盖远程同名文件
• 上传过程中会逐文件显示进度
• 上传失败时会显示具体的 HTTP 错误码

下载恢复

点击「从服务器下载」将远程配置恢复到本地设备。

• 下载会覆盖本地同名文件
• 下载完成后建议执行一次「部署方案」
• 下载失败时会显示具体的 HTTP 错误码

常见问题

连接测试失败

• 检查服务器地址是否正确，某些服务需要完整的 URL（如 dav.jianguoyun.com 不需要 /dav 后缀）
• 确认使用的是应用密码而非登录密码
• 确认设备网络可以访问该服务器（尝试用浏览器访问 https://<服务器地址>）

上传/下载返回 403

• 服务器拒绝了当前操作。检查用户名和密码是否正确
• 坚果云需要先在网页端开启 WebDAV 访问并生成应用密码

上传/下载返回 410 Gone

• 服务器主动拒绝了请求。检查：
  • 服务器 URL 是否正确（尝试去掉路径中的 /dav）
  • WebDAV 服务是否已在服务器端开启
  • 账户是否具备 WebDAV 访问权限

DNS 超时（result_code:408）

• 设备无法解析服务器域名。可能的原因：
  • 更换网络环境（如切换到移动数据或另一个 Wi-Fi）
  • 修改设备的 DNS 设置

同步后输入方案不生效

• 下载配置后需要执行一次「部署方案」才能生效
• 进入「设置」→「输入方案」，点击底部「部署方案」按钮