第2章:Remotely Save 多设备同步

本章结构:先理解同步机制 → 看流程图心里有数 → 跟着一步步配置 OneDrive → 接入第二台设备 → 了解自动同步与常见问题。
预计时间:概念 10 分钟 + 实操 30 分钟
示例后端:本章只用 OneDrive 一种方式。S3、WebDAV、Dropbox 等配置更复杂,新手用不上,这里不再展开。


1. Remotely Save 是什么

Remotely Save 是 Obsidian 社区插件,作用是把整个 vault 同步到你自己选的云存储上,让电脑、手机等多台设备的笔记保持一致。

没有它,桌面上导入的书、配好的 Templater 模板、Douban 的登录状态,不会自动出现在手机上——所以本教程把它作为第一个插件来配置。

提醒:Remotely Save 是同步工具,不是备份或版本管理工具。需要历史版本,请另外用 Git 或云盘自身的版本功能。


2. 为什么只用 OneDrive

本教程只推荐 OneDrive(个人版),理由如下:

理由 说明
免费够用 个人 OneDrive 自带 5GB,纯 Markdown 笔记 + 少量封面图绰绰有余
多数人已有账号 有 Outlook / Hotmail / Microsoft 账号即可,不用注册新服务
授权最简单 点一下 Auth 走浏览器登录授权即可,不用手动复制 Access Key / Secret 这类凭据
数据隔离干净 自动放进 OneDrive 的专用文件夹 /Apps/remotely-save/,不会碰你 OneDrive 里其他文件

对比之下,S3、WebDAV 需要手动填写 Endpoint、Key、Region 等一堆字段,对新手不友好,本教程一律不再涉及。


3. 工作原理

点击 Sync now 时,插件做三件事:

  1. 比对:对比本地与云端的修改时间,找出各自的新变化。
  2. 传输:上传本地改动、下载云端更新。若两边都改过同一个文件,则生成冲突副本 文件名.conflicted.日期.md 供你手动合并。
  3. 记录状态:更新本地同步记录,下次只同步变化的部分。

核心原则:插件不关心文件内容——笔记、插件配置、封面图片对它都是「文件」,一视同仁。日常你只需记住一个动作:Sync now


4. 配置与使用总览

动手前先看两张图,做到心中有数。

4.1 一次性配置流程(每台设备做一次)

flowchart TD
  A["📦 安装 Obsidian"] --> B["安装 Remotely Save 插件"]
  B --> C["设置里选择 OneDrive"]
  C --> D["点击 Auth 在浏览器授权"]
  D --> E{"授权成功?"}
  E -- 否 --> D
  E -- 是 --> F["开启「同步配置文件夹」"]
  F --> G["设置加密密码(可选)"]
  G --> H["Sync now 首次同步"]
  H --> I["完全重启 Obsidian"]
  I --> J["第二台设备重复 B → I"]

4.2 日常同步循环(反复进行)

flowchart LR
  A["桌面端 · 编辑笔记"] <-->|"Sync now"| C[("OneDrive 云端")]
  C <-->|"Sync now"| E["手机 · 阅读浏览"]

5. 第一步:准备工作

  1. 准备一个 Microsoft 个人账号(Outlook / Hotmail 均可)。
    • ⚠️ Remotely Save 的 OneDrive 后端支持的是个人版;学校或公司的 Microsoft 365 企业版账号可能无法授权。
  2. 在浏览器登录 onedrive.com,确认账号能正常使用。

6. 第二步:安装插件

  1. Obsidian → 设置第三方插件(社区插件)
  2. 关闭安全模式(Safe Mode)
  3. 浏览(Browse) → 搜索 Remotely Save安装启用

7. 第三步:连接 OneDrive

  1. 打开 设置 → Remotely Save
  2. Remote Service(远程服务) → 选择 OneDrive(个人版)
  3. Auth(鉴权) 按钮 → 会弹出一个授权链接
  4. 在浏览器打开该链接 → 登录你的 Microsoft 账号 → 看到授权请求后点 接受(Accept)
  5. 回到 Obsidian:Auth 按钮变成 Revoke Auth(撤回鉴权),即授权成功
  6. Check(检查) 测试连接,出现「可以连接」之类的提示即 OK

同步位置说明:免费版会把数据放进 OneDrive 的专用文件夹 /Apps/remotely-save/你的库名,插件只能访问这个文件夹,不会读写你 OneDrive 里其他文件。

⚠️ 关键:所有设备的 vault 名字必须完全一致(包括大小写),否则会被当成两个不同的库,同步不到一起去。


8. 第四步:配置同步选项

仍在 Remotely Save 设置里继续:

  1. 同步配置文件夹(Sync Config Dir,实验性质) → 开启
    • 作用:把 .obsidian/plugins/ 一并同步,新设备不用重复安装和配置插件(含 Douban 登录态等)。
  2. 加密密码(Encryption Password) → 可选
    • 开启后文件上传前会被 AES 加密,连 OneDrive 也读不到内容。
    • ⚠️ 所有设备必须填相同的密码;密码一旦丢失 = 笔记无法解密,请务必妥善保管。

9. 第五步:首次同步并重启

  1. 点击侧栏的双箭头图标,或命令面板 Ctrl+PRemotely Save: Sync now
  2. 等首次同步完成(文件多的话,建议在 Wi-Fi / 有线网络下进行)
  3. 完全退出 Obsidian 再重新打开

验证:登录 onedrive.com,进入 应用 → remotely-save → 你的库名,应能看到 vault 里的文件已经上传。


10. 第六步:第二台设备接入

10.1 电脑(Windows / macOS)

  1. 安装 Obsidian → 创建一个与主设备同名的 vault
  2. 只安装 Remotely Save 一个插件
  3. 重复第三步:同样选 OneDrive → Auth 授权(登录同一个 Microsoft 账号)
  4. 开启「同步配置文件夹」;若主设备设置了加密,填入相同密码
  5. Sync now → 等待完成
  6. 完全退出 Obsidian 再重新打开
  7. 确认 Templater、Dataview、Douban 等插件已自动启用

验证:左侧文件树能看到 Books/Tools/Templater/ 等文件夹(内容为空是正常的,等第 4 章导入书籍后才会出现笔记文件)。

10.2 手机(Android / iOS)

  1. 手机端 Obsidian 安装 Remotely Save
  2. 创建与主设备同名的 vault
  3. 同样选 OneDrive → Auth 授权
  4. 首次同步建议在 Wi-Fi 下进行
  5. Sync now → 等待完成

手机同步完成后,即可用 Dataview 看书单、用 Navigator 浏览文件夹——这就是「桌面写、移动读」的落地形态。


11. 排除规则

有些文件不该同步。在设置里的 Ignore Paths(忽略路径) 逐行添加:

.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/cache/
.trash/
路径 为什么排除
.obsidian/workspace.json 桌面端侧边栏布局,与手机布局不同,不同步才是正常的
.obsidian/workspace-mobile.json 手机端专属布局
.obsidian/cache/ 缓存,每台设备会重新生成
.trash/ 回收站,避免把本机删除的文件又从云端拉回来

以下路径不要排除

路径 原因
.obsidian/plugins/ 插件代码 + data.json 配置必须同步
.obsidian/community-plugins.json 记录启用了哪些插件
.obsidian/app.json Obsidian 通用设置
.obsidian/hotkeys.json 自定义快捷键(可选)

12. 自动同步设置

设置项 说明 建议
Auto Sync 按固定间隔自动同步 ✅ 开启
Auto Sync Interval 间隔(分钟) 5 分钟
Sync on Save 保存笔记时立即同步 ✅ 开启
Sync on File Open 打开笔记时拉取最新 新手建议开启

同步方向保持默认「双向同步」。删除相关:Delete Cloud Only Files 建议关闭(安全第一),Sync Deleted Files 建议开启。


13. 日常使用节奏

编辑前:Sync now(拉最新)
编辑 / 导入 / 写笔记
编辑后:Sync now(推上去)

养成这个习惯,基本不会遇到文件冲突。


14. 常见问题排查

找不到 Download / Upload 按钮

没有独立的上传/下载按钮,日常只用 Sync now,它会自动完成双向同步。

OneDrive 授权失败

新设备同步后插件没出现

大概率没开「同步配置文件夹」。主设备确认开启并 Sync 一次 → 新设备再 Sync → 重启 Obsidian。

出现 *.conflicted.* 冲突文件

同一文件在两台设备都被改过。手动打开两个文件合并,删掉冲突副本即可。

手机端布局混乱

workspace.json 被同步导致。把 .obsidian/workspace.json.obsidian/workspace-mobile.json 加进排除路径,两端各重启一次。

在 OneDrive 里找不到同步文件夹

默认在 应用 → remotely-save → 库名。若找不到,登录 OneDrive 网页版确认是否生成了 /Application/Graph 之类的目录,可将其重命名为 remotely-save 后重新同步。

首次同步特别慢

第一次要传整个 vault,速度取决于文件量和带宽。建议有线网络或信号好的 Wi-Fi;之后只传变化部分,会快很多。

空文件传不上去

OneDrive API 不允许上传空文件。可开启「跳过空文件」,或给需要保留的空文件加占位内容。


本章练习


← 上一章 蒸馏术 主页 下一章 →
第1章:环境 第3章:Claudian