设置同步

更新日期:2026-10-21

Plainva可以选择性地把每个仓库与你自己选择的存储同步——直接从应用内完成,中间没有任何由Plainva运营的服务:你的数据只会在你的电脑和你自己的账户/服务器之间传输。本页逐步说明各服务商的配置方法。

哪些服务大体上可用(包括通过WebDAV或服务商的桌面客户端)在同步兼容性中有详细说明。

比较已保存的版本

文本冲突无法自动合并时,每个原文件会保留一个本地工作副本。之后的编辑会保存到同一个副本中,重新打开笔记或重启应用后也是如此。提示栏会说明:你正在编辑冲突副本。合并后才会同步。

在比较界面中,比较已保存的版本 可显示已保存的初始版本(如果有)。工作副本在本次会话之外被修改时,另一个版本也会保留,并可在此比较。采用副本、保留两者和丢弃副本都会重新检查当前文件;比较内容已过期时,请重新加载。移动或删除相关文件及其文件夹之前,请先解决冲突。旧的冲突副本仍会单独列出。

冲突未解决期间,应用的其他部分仍会继续使用这条笔记。在编辑器之外所做的更改——数据库中的单元格、勾选的任务、日志条目、随笔记重命名而更新的链接——会同时写入笔记和你的冲突副本,因此无论保留哪个版本,更改都在。如果你的副本中已没有该更改对应的位置(例如你在那里改写了某个任务的文字),副本会保持原样,比较界面会显示这一差异。如果在你的设备上传之前,另一台设备修改了笔记本身的同一处,笔记自己的文本也不会丢失:它会作为另一份冲突副本保存在笔记旁边。

诊断导出还包括最近的冲突记录:存储类型、写入来源、哈希比较,以及换行符、BOM 或末尾换行的差异。这些冲突记录不包含笔记内容或文件名。无论应用使用哪种语言,诊断导出始终为英文,方便你原样粘贴到 GitHub 的 issue 中。

基础知识

WebDAV / Nextcloud

对于自建服务器和大多数云存储来说,这是最简单的方式:

  1. 在云账户 → 连接账户… 中选择Nextcloud(或WebDAV / CalDAV)图块。
  2. 输入服务器地址、用户名和密码或应用令牌——只要可能,就使用应用密码而不是主密码(在Nextcloud中:设置 → 安全 → 应用密码)。
  3. 连接会验证凭据;之后通过选择文件夹… 选择云端文件夹。 这里同样可以创建 新文件夹——凡是 Plainva 选择云文件夹的地方都可以,手机上的 更改云文件夹 也是如此。

Nextcloud的特殊之处:一个表单即可同时覆盖文件和日历——Plainva会直接从服务器地址推导出WebDAV和CalDAV端点(推导出的地址会显示在助手中;高级:分别设置各个端点可以设置独立的URL)。同时勾选两项服务,一次连接即可同时完成两者。

常见的服务器地址(Nextcloud、Koofr、MagentaCLOUD、Storage Box等等)列在同步兼容性中。

该地址指向仓库文件夹本身。 其下的所有内容都属于该仓库,因此地址若高出一级,相邻的文件夹也会被一并纳入。在 WebDAV 中,文件夹是服务器地址的一部分——以后要移动仓库,请重新连接账户。

更改密码时,会先向所有相关的密码保护服务进行验证。如果保存中断,已确认的更改会保留。重新打开账户并选择继续保存。重启后,受保护的操作仍然可用。如果账户关联或凭据发生变化,可以选择重新验证密码,为当前关联的服务验证现用密码。缺失的凭据不会被跳过。之前关闭的 vault 下次打开时,也会使用新的日历登录。

新的日历连接始终关联到开始连接时的 vault。如果在验证期间关闭或切换该 vault,请回到原 vault 重新连接。如果无法读取现有凭据,账户合并会停止,并保留原有账户。

Google Drive

Google Drive目前采用自备凭据(“Bring Your Own”)的方式运行:你只需一次性创建一个只属于你自己的免费Google Cloud项目。分步指南见:Google Drive(BYO)。

简要版本:在云账户 → 连接账户… 中选择Google图块,勾选文件服务,输入你Google项目中的客户端ID和客户端密钥,然后点击使用 Google 登录…——登录界面会在浏览器中打开。连接成功后,你可以通过选择文件夹… 直接从你的Drive中选择云端文件夹(包括子文件夹,默认为”Plainva”)。注意:只要你的Google项目处于测试模式,登录就会在7天后过期——而且是永久性的,因为Google在这种模式下也会让刷新令牌一并失效,Plainva便无法在后台自动为你续期。这时同步功能会提示你登录已过期,在账户详情中点击重新登录即可恢复——一次操作即可恢复该账户的所有服务。已发布状态会取消测试模式的固定有效期,但不保证永久登录:Google仍可能使访问权限过期或撤销访问权限。发布和验证要求取决于用途及所请求的权限。Google:刷新令牌过期。

如果连接时同时勾选文件和日历,Google 只会请求一次授权,且仅申请所选服务对应的权限。以后再添加其他服务时,会出现第二次补充授权。

OneDrive

Plainva自带了应用注册——你不再需要自己创建ID:

  1. 在云账户 → 连接账户… 中选择Microsoft图块,并勾选文件服务(OneDrive)——如果需要,可以同时勾选日历与任务和邮件(一个Microsoft账户可以同时承担全部三项服务)。
  2. 点击使用 Microsoft 登录…,并在浏览器中确认登录。完成——Plainva会创建该文件夹(默认为”Plainva”),并同步其全部内容,包括外部添加的文件。
  3. 可选:连接成功后,你可以通过选择文件夹… 直接从你的OneDrive中选择云端文件夹(包括子文件夹)。

可选:通过使用你自己的应用 ID,你可以改为填入一个自行注册的客户端ID(例如遇到公司限制时)。详细指南:OneDrive与Dropbox(BYO)。

如果同时连接一个账户的多项服务——例如文件和日历——服务商只会请求一次授权,Plainva 会为整个账户保存一份登录。这对Microsoft(文件、日历、邮件)和Google(文件与日历;Gmail 邮箱不受影响,因为它通过 IMAP 配合应用专用密码运行,不需要授权)同样适用。

向导会把你选定的服务商带到每一步:第 2 步和第 3 步直接打开对应的表单(Google 日历表单而不是服务商选择,Gmail 而不是通用的 IMAP 表单),不会再问一次你想连接谁。前一步已经收集到的内容,下一步就已经在那里:对 Nextcloud,Plainva 会从第 1 步的服务器地址推导出 CalDAV 地址;套件密码只需输入一次,而不是三次。这些内容只在本次流程期间保存在内存中,不会写到任何地方,流程结束后即消失——包括你通过退出向导中止它的时候。

仍按服务分别登录的账户会在账户列表中标记为旧登录方式,并显示一次登录,所有服务通用——账户列表和账户详情中都是如此,桌面版和移动应用里也不例外。只需一次操作,之后所有服务就会共用同一个登录。这不仅仅是方便:分开的登录可能会逐渐脱节,导致一项服务仍在正常运行,而同一账户的另一项服务却已悄悄过期。对这类账户,重新登录现在会更新整个账户,而不只是单个服务。即使已经存在共用登录,但它并未覆盖账户的所有服务——比如你在同意授权时漏掉了一个勾选项——这个提议依然会保留。Google 无法在事后扩展一次已经给出的授权。

重新登录 Google 会保留 Gmail 邮箱的应用专用密码。浏览器登录仅更新该账户的 OAuth 服务,IMAP 邮箱无需为此重新设置密码。即使多个仓库中存在相同的账户配置,Outlook 也会按仓库分别保存登录信息和管理连接。桌面端和移动端均如此。

文件、日历和 Outlook 邮件各自需要相应权限。因此,文件同步正常并不代表日历或邮箱也已获得授权。Plainva 会检查每项服务的权限;若缺少权限,请重新登录并授予所需访问权限。Google 的等效权限名称也会被识别。

Dropbox

Plainva自带了Dropbox应用——无需自己的应用:

  1. 在云账户 → 连接账户… 中选择Dropbox图块(它只承担文件服务)。
  2. 点击使用 Dropbox 登录…,并在浏览器中确认。完成(默认文件夹为/Plainva)。
  3. 可选:连接成功后,你可以通过选择文件夹… 直接从你的Dropbox中选择云端文件夹(包括子文件夹)。

可选:通过使用你自己的应用 ID,你可以改为填入一个自行注册的App key。详细指南:OneDrive与Dropbox(BYO)。

S3兼容存储

适用于AWS S3、Cloudflare R2、Backblaze B2、MinIO、Wasabi、Hetzner等等——纯密钥方式,完全不需要浏览器登录。在云账户 → 连接账户… 中选择对象存储 (S3) 图块并填写以下字段:

字段含义
EndpointS3 API的基础URL,例如https://s3.eu-central-1.amazonaws.com、https://<account>.r2.cloudflarestorage.com,或本地MinIO的http://127.0.0.1:9000
存储桶存储桶名称
区域SigV4区域;大多数非AWS存储使用us-east-1即可,Cloudflare R2使用auto
Access Key ID / Secret Access Key来自服务商的一对API密钥
Key前缀(可选)仓库在存储桶内所处的子文件夹;留空=存储桶根目录
路径样式URL推荐启用(适用于MinIO、R2和大多数兼容存储);仅在virtual-hosted风格的AWS存储桶上关闭

Key前缀(即云端文件夹)可以在连接后通过选择文件夹… 直接从存储桶中选择。

连接后,同步会立即开始。

另请参阅

同步加密(密码短语)

已在P3替换: 以下说明不再用于仓库内容。请使用安全与共享。此处保留的口令仅保护可选设置与机密信息。

Plainva 可以对从你的设备发往同步服务器的内容进行加密,而你的本地仓库始终保持为Obsidian可以读取的纯Markdown格式。

打开设置 → 同步 → 同步密码短语与加密:

  1. 设置密码短语。 这会为仓库创建一个加密密钥,并显示一次性的恢复代码——请妥善保存;如果你忘记了密码短语,这是唯一能找回访问权限的方法。从此以后,该仓库同步的设置会以加密形式传输。
  2. 加密仓库内容(可选)。加密按钮会把每一篇笔记以密文形式重新上传到同步服务器。你的本地文件仍然是纯Markdown,所以本地仓库永远不会有风险——建议先在一个可丢弃的仓库上试一试。上传完成后,使用完成迁移,此后就只接受密文。
  3. 在另一台设备上,打开同一个已同步的仓库。Plainva会检测到该仓库已加密,并提示你输入密码短语(或恢复代码)。解锁后,笔记会被解密并出现在本地。

已解锁的密钥会在每台设备上缓存。开启每次启动都要求输入密码短语,可以改为在每次重启后重新输入;使用锁定可以从此设备上移除缓存的密钥。

所有设备上的账户是三个步骤。1 · 设置与账户:把仓库设置以及你的账户(日历、邮箱、日历选择)存为仓库中的一个小文件——只要尚未设置密码短语,这就不需要;一旦设置了密码短语,每台设备都必须输入它,设置才会从该设备同步出去。此步骤默认开启——设置与账户并非机密;你可以随时按仓库关闭它。2 · 同步密码短语(可选):只有当登录信息也需要一并同步时才需要,它还会加密第 1 步中的设置。3 · 一并带上登录信息:另外以加密方式携带静态的 IMAP 和 CalDAV 密码,并且只有在第 1 步已经运行且密码短语已解锁的情况下才能开启——密码只能同步到设备已知的账户。不会携带:设备专有路径和 OAuth 登录(Microsoft、Google);它们的令牌绑定单台设备,因此账户会出现在新设备上,并需要在那里登录一次。

在手机上,仓库页面提供同样的链条——同样的三个步骤和同样的锁定。来自其他设备的账户会在那里创建,你不再需要手动输入。使用立即从其他设备获取可以马上取回,而无需等待下一次同步。

如果 Plainva 提示“旧版本仍在发布已停用的账户数据”,请在使用此仓库的所有设备上更新 Plainva。当前设备会忽略旧的 Google 客户端凭据,并保留正常工作的本地登录。所有参与同步的设备完成更新之前,请勿确认删除旧的远程数据。 相应的按钮位于设置 → 仓库 → 同步 → 诊断中的提示里:删除已停用的条目——它询问的正是这项确认。

这一步 登录 在哪里进行取决于服务:邮箱会在 邮件 区域自己那一行显示 在此设备上登录 按钮,日历或文件账户则在 云账户 中显示。Microsoft 邮箱始终转到 云账户,因为它的登录在浏览器中进行。

首次 设置加密时,第 3 步默认开启——否则后续每台设备都会长期没有登录信息。对于你已经在用的保险库,不会悄悄改变:Plainva 只问一次,并记住你的回答。

如果一个账户显示为 两张卡片,说明 Plainva 无法从服务商获取身份——它不会猜测。在 云账户 中打开其中一张,用 合并 说明这是同一个账户;Plainva 会先显示哪些内容会被保留。

如果日历与账户中列出了同一个日历的两行,Plainva 会提示这一情况,但不会自行合并它们:合并会导致日历选择以及与镜像任务的关联丢失。请检查哪一行保留着你的选择,删除另一行。

你移除的账户会保持移除状态:这项删除会通过设置同步传递到你的其他设备,而不会在下一轮同步时从那里被重新带回来。

哪些内容会同步,哪些留在本机

如果云账户中出现检查重复账户,Plainva 不会仅凭名称猜测。请在正确的卡片上选择保留此账户。确认页会列出目标、来源和受影响的服务,并先在此设备上创建备份。取消不会更改任何内容。合并只会移除孤立的本地账户、缓存和凭据;提供商处不会删除任何内容。

随仓库同步留在本设备
账户——日历、邮箱、云账户、书签绝对路径——仓库位置、备份目标
文件夹与模板——日记、模板文件夹、收件箱文件夹、附件文件夹、任务数据库Microsoft 与 Google 的登录令牌
日历设置——会议文件夹、默认日历你最后打开的邮箱和文件夹
邮件设置——归档文件夹、远程图片本设备用于新仓库的初始布局
备份规则——快照间隔、保留期限、归档静态密码——除非启用了第 3 步
同步间隔
栏位布局(桌面端)

手机端携带的内容稍微少一些:四个桌面端栏位的布局留在电脑上——它自己的导航栏确实会跟随,会议文件夹也是如此。仓库页面上它自己的三步链会显示它携带了什么,两端都会在下方说明同步最近究竟做了什么,并列出随之传输的设置项名称;接收时还会列出发生变化的项。「已从其他设备接收设置」的提示每次会话最多出现一次,且只在确有变化时出现;之后由这几行说明。 本版本起,手机端也会沿用日记的文件名格式、新笔记的 OKF 类型以及你的书签——此前,只要手机接触过设置了其他日期格式的仓库,同一天就会多出第二篇日记。

诊断现在会分别显示最近检查(本地配置字段)、最近下载、最近应用和最近实际发送。“发送”只会在成功写入云端后更新;因此,无变化的同步会更新检查与下载时间,但不会更新发送时间。密钥结果会单独显示为已导入、未更改、已拒绝、已过时、出错或等待账户的数量。这里只保存稳定的原因代码,不包含账户 ID、密码、令牌或原始错误。出现旧客户端提示时,应更新所有参与设备上的 Plainva;本设备会忽略已停用的 Google 客户端数据。

删除会随同步传播。 你确认过的删除会在日志(.plainva/sync/deletions.json)中保留 90 天,并在其他所有设备上无需询问地执行——重启后也是如此,即使那里一次缺少许多文件也一样。反之,如果云端缺少许多文件而日志无法解释,Plainva 会暂停镜像并询问:应用删除 还是 保留在本地(然后会把这些文件作为新文件重新上传)。任务列表同理:在提供商处执行的删除也会在另一台设备上移除任务笔记,前提是那里没有改动它。在询问之前——也在移除此处任何一个文件之前——Plainva 会直接向云端核实:抽取一部分缺失的文件,逐个询问。只要其中有一个存在,就说明云端的列表不完整:不会删除任何文件,也不会询问任何人,同步状态会显示 云端的响应不完整——没有删除任何文件 和 重新检查。只有在确认文件确实不存在并已在此处移除之后,才会写入日志记录;如果某条记录对应的文件又出现在云端,该记录会被撤回;关于与诊断 中的 检查删除日志 可以随时执行这项检查。如果找不到一个已经同步过的仓库在云端的文件夹,Plainva 不再新建一个空文件夹来代替,而是给出提示——这时请选择现有的文件夹。

错误和自动重试

同步错误窗口会保留失败尝试的确切信息,即使自动重试已经改变了实时状态。它会显示重试正在进行或已经成功。只有身份验证错误才会建议重新连接;网络、超时和提供商错误会保留具体原因并自动重试。 设置同步同样会等待临时性故障:超时先显示为带计数的普通提示,只有连续第三次失败后才变成红色消息;而登录已过期时会立即变红。

仅拼写不同的文件名

Google Drive 在搜索时不区分大小写,Windows 和 macOS 也会把 Note.md 和 note.md 存为同一个文件。同一个字符还可能有两种保存方式:ü 作为单个字符,或作为 u 加上一个变音符号。对于这种写法,Plainva 现在会认定它们是同一个文件并照常同步,只要匹配项只有一个。

但如果两个名称只在大小写上不同,那就是两个文件。此时 Plainva 不会更改也不会删除任何内容,而是显示卡片两种写法,同一个文件并列出两个名称——手机上在资料库页面,桌面版在同步设置中。其余文件继续正常同步。重命名其中一条笔记,卡片就会自动消失。

新登录未涵盖所有服务。已保留你的原有登录信息。请重新登录并允许列出的所有服务。 账户关联已更改。请打开当前账户设置并重新登录。

Google Drive:尚未完成的下载

当 Google Drive 暂时限制请求时,Plainva 会间隔一段时间后重试下载。下载失败不会被视为文件不存在或更改已完成。现有本地内容和已确认的同步状态会保留,下一轮同步将重试尚未完成的更改。其他已成功下载的文件仍可使用。权限不足或其他持续拒绝会显示为错误,并注明文件路径和原因。桌面端和移动端均采用此行为。

文件传输中断

超时限制也适用于从 WebDAV、Dropbox、OneDrive、S3 和 Google Drive 接收文件内容。如果分块接收的响应不再提供数据,Plainva 会结束该次尝试,并使用新请求进行有限次数的读取重试。只要数据持续到达,即使接收整个文件超过基础时限,该下载也会继续。移动端原生请求还有各自的时间限制。不完整的下载绝不会替换现有本地文件,也不会确认同步进度。大文件上传保留按大小计算的时间预算;结果不明确时由正常的同步恢复流程处理,而不会盲目重新发送。

扩展现有账户

直接为相应账户添加文件、日历或邮箱。Plainva 会检查所选登录并请求缺少的权限。

打开云账户,选择现有账户,在缺少的服务旁点击添加。现有服务保持连接。Gmail 继续使用独立的邮箱登录或应用专用密码。取消助手不会断开已完成的连接。移动文件迁移保留源库,优先考虑匹配的现有目标库,否则准备独立容器。同名冲突文件会逐一比较,并保留双方内容。加密目标通过现有配对流程打开。

在移动端添加文件时,Plainva 会在迁移前显示来源、目标及同名冲突。现有内容和服务得以保留,中断的迁移可以重试。

自托管服务器的证书

Android 也信任你在系统设置中安装的证书颁发机构。此设置适用于所有使用 Android 平台配置的 Plainva 连接,并非仅限某个 WebDAV 服务器。桌面 HTTP 连接使用系统证书颁发机构及公共根证书;iOS 使用系统信任设置。仍会验证有效期和服务器名称。过期、尚未生效或属于其他服务器的证书必须在服务器或地址配置中修正。Plainva 不提供接受所有证书的选项。如果系统未说明确切原因,Plainva 只报告验证失败,不猜测原因。移动端原生 HTTP 诊断仅记录方法和错误代码,不包含凭据、证书名称或私有服务器路径。

自动重试与缺失的同步历史

连接暂时不可用。Plainva 将自动重试;待同步的更改会保留在此设备上。

请重新登录同步帐户。在恢复访问之前,待同步的更改会保留在此设备上。

Plainva 无法验证加密库。同步已暂停;本地数据和待同步的更改均会保留。请打开“安全与共享”,如有可验证的副本则将其恢复,然后重新检查。

在仍保留完整且可验证历史记录的设备上选择“立即同步”。Plainva 可以从该副本恢复缺失的已签名操作。然后在 Plainva 上重新检查。如果没有有效副本,请保留或导出本地数据;验证检查点绝不会为了绕过缺失部分而被重置。

其他设备的未加密批注文件仍保留在服务器上。只有原始设备才能完成转换。Plainva 不会删除其他设备的文件。

只有在验证身份、实际授予的权限和安全存储后,才会接管现有登录。一个账户可以保留多个独立授权;添加服务不会移除其他服务的有效登录。Microsoft 邮件可以复用具备相应权限的文件或日历登录。另一台设备需要单独登录。

在同步设置中,Google 云端硬盘选择器会显示当前目标和所选文件夹的预览。打开同名文件夹,对比文件和修改时间。“使用此目标”会保存唯一的文件夹 ID。如果该文件夹以后无法访问,Plainva 会报告错误,不会创建替代文件夹。其他文件夹不会被移动或删除。