设置同步

更新日期：2026-09-10

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

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

基础知识

• 配置入口在设置 → 仓库 → 云账户：连接账户…会打开助手——先选择服务商，再勾选服务（用于文件同步的是文件），最后登录。图块概览会按实际普及程度列出各服务商；通过搜索服务商…还能找到以预设形式提供的邮件服务商。每个仓库始终恰好由一个账户承担文件服务。同步区域随后会显示已连接的账户及其云端文件夹，并管理相关行为（同步间隔、队列）；管理账户会返回云账户。 一旦连接了 文件 服务，助手就会询问一次 云文件夹——对每个提供商都是如此，并可在选择器中直接 新建文件夹；浏览 仍然可以回到这里。WebDAV 的文件夹是服务器地址的一部分，因此那里没有选择器。
• 对于文件服务，除了Microsoft（OneDrive）、Google（Drive）、Dropbox、Nextcloud、对象存储 (S3)以及通用的WebDAV / CalDAV之外，图块中还包含Fastmail、mailbox.org、Yandex、Mail.ru、Koofr和pCloud：在这些服务中，只需你的邮箱地址加一个应用专用密码即可——服务器地址已经预填好（基于WebDAV；可通过高级：分别设置各个端点更改）。
• 从欢迎界面设置已有的在线仓库：打开仓库 → 在线仓库会为每个服务商提供相同的三个步骤——1. 连接（登录或输入凭据）、2. 选择云端文件夹（也可以在此处通过新建文件夹新建一个）、3. 选择或创建本地文件夹。你也可以随时在设置中为已经打开的仓库配置同步。
• 在云端新建仓库：新建仓库 → 在在线服务中——先选择起始结构（空白或PARA等模板），然后连接并选择云端的目标文件夹，或通过新建文件夹新建一个，最后选择本地文件夹。结构会创建在本地文件夹中，并在首次同步时自动上传。
• 本地保存会立即上传；Plainva会按配置的**同步间隔（秒）**检查远端更改。
• 离线时的更改会排入队列，等到下次联通时传输；状态栏会显示在线/离线，同步指示器会显示当前状态（点击可立即同步）。在长时间同步或首次同步期间，状态栏会以计数形式显示进度（例如同步 123/540），让你能看到它正在逐步处理整个仓库。
• 如果两端都修改了同一个文件，Plainva会自动合并（三方合并）。如果无法合并，你的版本会被安全地保存为一个.CONFLICT文件——任何内容都不会丢失（参见常见问题与故障排查）。
• 解决冲突：受影响笔记中的一条横幅（以及文件树中.CONFLICT文件右键菜单里的解决冲突…）会打开对比对话框——左侧是文件的当前状态，右侧是你被保留下来的版本，可编辑，并支持按块单独采用。保存右侧版本并解决会把结果写入文件并清理冲突副本；保留另一端则会丢弃你的副本（仍会保留一个版本快照）。同步错误对话框也会列出现有的冲突副本，点击一下即可进入同一个对比界面。
• 批量删除保护：如果异常多的已同步文件即将在云端被一次性删除（例如因为本地仓库文件夹被清空或移动），Plainva会先暂停这些删除并询问：在云端删除会执行删除，**不删除（恢复）**会放弃删除，并在下次同步时从云端恢复这些文件。你在 Plainva 中自行确认的删除不会被拦截——对于大量删除（超过 10 个文件或超过仓库的 20%），Plainva 会在删除前再次向你确认。
• 附件（图片等）也会一并同步。
• 空文件夹也会同步：在Plainva中新建的文件夹会立刻出现在云端，云端已有的空文件夹最晚会在你其他设备的下一次完整同步中出现。
• 凭据和令牌保存在操作系统的钥匙串中（状态查看：设置 → 应用 → 关于与诊断 → 系统钥匙串），绝不会保存在仓库内的文件中。
• 已保存的凭据（设置 → 仓库 → 同步）显示 Plainva 存入钥匙串的内容，包括早已不再打开的仓库留下的条目。每一行都注明服务和仓库；删除会先询问。Plainva 从不在此自行删除任何内容。
• 钥匙串中的条目使用可读的名称 —— plainva · <仓库> · <服务> · <账户 ID> · #<指纹>，而不是一串 base64。首次打开仓库时，Plainva 会为已有条目重命名一次；如果重命名无法安全完成，旧条目会保留原样，Plainva 会在下次打开时再试。
• 断开连接会停止该仓库的同步；此操作不会删除任何地方的任何文件。
• 允许使用http://，推荐使用https://。 在自己的网络中运行的服务器通常使用未加密的http——这样可行，在手机上也一样。但在互联网上不应该这样做：WebDAV会在每次请求时都以明文通过http发送你的密码。如果你在自己的网络之外输入未加密的地址，Plainva会在表单中提示——但并不会阻止你。

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)**图块并填写以下字段：

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 不会仅凭名称猜测。请在正确的卡片上选择保留此账户。确认页会列出目标、来源和受影响的服务，并先在此设备上创建备份。取消不会更改任何内容。合并只会移除孤立的本地账户、缓存和凭据；提供商处不会删除任何内容。

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

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

删除会随同步传播。 你确认过的删除会在日志（.plainva/sync/deletions.json）中保留 90 天，并在其他所有设备上无需询问地执行——重启后也是如此，即使那里一次缺少许多文件也一样。反之，如果云端缺少许多文件而日志无法解释，Plainva 会暂停镜像并询问：应用删除 还是 保留在本地（然后会把这些文件作为新文件重新上传）。任务列表同理：在提供商处执行的删除也会在另一台设备上移除任务笔记，前提是那里没有改动它。

错误和自动重试

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

仅拼写不同的文件名

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

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

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

Google Drive：尚未完成的下载

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

文件传输中断

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