设置同步

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

哪些服务大体上可用（包括通过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. 连接会验证凭据；之后通过选择文件夹…选择云端文件夹。

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

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

如果应用密码以后发生变更，只需在账户详情的登录凭据中输入一次：Plainva 会逐一验证该账户的每项服务，全部通过后才保存，不会有服务停留在旧密码上。

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 配合应用专用密码运行，不需要授权）同样适用。

仍按服务分别登录的账户会在账户列表中标记为旧登录方式，并显示一次登录，所有服务通用——账户列表和账户详情中都是如此，桌面版和移动应用里也不例外。只需一次操作，之后所有服务就会共用同一个登录。这不仅仅是方便：分开的登录可能会逐渐脱节，导致一项服务仍在正常运行，而同一账户的另一项服务却已悄悄过期。对这类账户，重新登录现在会更新整个账户，而不只是单个服务。

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

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

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

错误和自动重试

同步错误窗口会保留失败尝试的确切信息，即使自动重试已经改变了实时状态。它会显示重试正在进行或已经成功。只有身份验证错误才会建议重新连接；网络、超时和提供商错误会保留具体原因并自动重试。

仅拼写不同的文件名

Google Drive 搜索时不区分大小写，Windows 和 macOS 也会把 笔记.md 和 笔记.MD 存成同一个文件。如果同一个文件夹里有两条笔记，名称只在大小写上不同——或者只在重音字母的写法上不同（ü 是一个字符，或者是 u 加分音符）——Plainva 在另一端就无法区分它们。这时同步不会修改也不会删除任何内容，而是报告一个同时列出两个名称的错误。把其中一条笔记改名，同步就会继续。