Obsidian 同步操作手册 · PC 端

打开 https://obsidian.md/download，点击 Download for Windows。下载完成后运行官方安装程序，按提示完成安装并打开 Obsidian。

完成标志： Obsidian 安装完成，可以打开。

如果已经进入某个笔记库，点击左下角的库名称，再点击“管理仓库…”。第一次打开 Obsidian 时会直接进入仓库选择界面。

完成标志： 显示仓库管理窗口。

在“新建仓库”一行点击“创建”。这里的仓库（Vault）就是保存笔记的本地文件夹。

完成标志： 显示库名称与保存位置填写页。

仓库名称可以填写“我的同步笔记”。点击“浏览”选择本机保存位置，再点击“创建”。请选择不受 OneDrive 等其他同步工具管理的普通文件夹。

完成标志： 进入刚创建的空笔记库。

点击左下角齿轮打开设置，选择“第三方插件”。如果出现受限模式或“信任仓库作者”的提示，请先确认这是你自己建立的库，再按界面提示允许社区插件。随后点击“浏览”。

完成标志： 可以打开社区插件市场。

在插件市场搜索框输入 Self-hosted LiveSync，打开同名结果。核对作者为 vrtmrz；已安装插件列表中的作者可能显示 vorotamoroz。

完成标志： 找到作者为 vrtmrz 的 Self-hosted LiveSync。

点击“安装”；如完成后显示“启用”，再点击“启用”。启用后回到设置，点击左侧 Self-hosted LiveSync；首次启用时也可能直接弹出设置向导。

完成标志： 插件已启用，可以进入首次设置向导或插件设置。

首次启用插件出现欢迎页时，两项都不要选择，点击底部“不，返回上一步”（No, please take me back）退出欢迎向导。

完成标志： 回到 Self-hosted LiveSync 设置页。

打开“设置 → Self-hosted LiveSync → 远程配置”，在 E2EE Configuration 区域点击 Configure And Change Remote，一起配置笔记加密与服务器连接。

完成标志： 出现 End-to-End Encryption（端到端加密）页面。

勾选 End-to-End Encryption，填写并妥善保存自己的笔记加密口令，勾选 Obfuscate Properties（混淆文件属性），加密算法保持默认，然后点击 Proceed。

完成标志： 进入服务器类型选择页面。

在服务器类型页面选择 CouchDB，确认该项处于选中状态，再点击 Continue to CouchDB setup（继续进行 CouchDB 设置）。

完成标志： 进入 CouchDB 连接信息填写页面。

逐项填写分配给你的 URL、用户名、同步账号密码和数据库名称。

• URL 使用完整 HTTPS 服务地址，端口也须一致；不在末尾自行加数据库名。
• 用户名和密码使用自己的同步账号，数据库名称照抄分配结果。
• Use Internal API 和高级设置先保持默认。截图中的 sync01 / obsidian_sync01 仅是示例，实际填写自己的信息。

完成标志： 四项连接信息填写完整，可以继续测试。

向下滚动，点击 Test connection and save（测试连接并保存），等待进入下一页。

完成标志： 测试成功，出现 Mostly Complete: Decision Required。

选择 My remote server is already set up. I want to join this device.（远端服务器已设置，接入这台设备），点击 Proceed to the next step，再点击 Restart and Fetch Data。

这里的“服务器已设置”指数据库已由服务方建好；这仍然是你第一台客户端的手动配置，不需要先有另一台设备或配置链接。

完成标志： 已安排重启并获取服务器数据。重启后继续检查是否需要启用 LiveSync。

首次重启后，进入“设置 → Self-hosted LiveSync”。如果“快速设置”仍显示“启用 LiveSync”，点击它；如果已直接出现 Data retrieval scheduled，跳到后面的获取数据步骤。

完成标志： 点击启用后，出现是否重启的确认框；已启用的设备可继续获取数据。

在重启确认框中点击 Yes, restart immediately（立即重启）。重启后等待 Data retrieval scheduled 弹窗。

完成标志： 重启后进入 Data retrieval scheduled。若没有弹窗，检查快速设置是否仍显示“启用 LiveSync”。

在 Data retrieval scheduled 中点击 Compare time and take newer（比较修改时间，保留较新的文件）。本指南以新建空库接入为起点，空库将获取服务器已有内容。

完成标志： 进入 Conflict & Deletion Options。

在 Conflict & Deletion Options 中点击 Keep local files even if deleted on remote（即使远端已删除，仍保留本地文件），继续首次获取。

完成标志： 继续读取服务器配置并初始化。

已有数据库可能出现如图提示：部分设置已按服务器的兼容配置调整。确认接入的是自己的数据库后点击 OK，等待获取完成。

全新数据库若显示 No Synchronisation Settings Found，确认库中尚无旧笔记后选择 Use this device's settings，使用本设备的设置。

完成标志： 获取流程结束且没有错误；若曾出现 flag_fetch 标记，它应由插件自动清除。随后设置持续同步模式。

首次数据获取完成后，打开“设置 → Self-hosted LiveSync → 同步设置”。在“预设”中选择 LiveSync 同步并点击“应用”，确认下方“同步模式”为“LiveSync 同步”。

每台设备完成初次获取后都检查一次。若手动 Sync now 可以传输，但新增内容不自动出现，优先核对这一项。

完成标志： 同步模式显示为 LiveSync 同步。

按 Ctrl + N 新建“我的第一篇同步笔记”，写入一句自己的测试文字，例如“A端测试”。需要附件时，把图片或 PDF 放进笔记库并在笔记中引用。

保持应用联网并打开，确认没有上传或加密错误，再导出配置链接。外部文件路径链接不会把原文件带到另一台电脑；另一端收到新写的测试文字后，才证明发生了传输。

完成标志： 测试笔记及附件保存在当前库内。

在已配置好的首台设备进入“设置 → Self-hosted LiveSync”，找到“设置其他设备”，点击“将当前设置复制为设置 URI”。请先确认账号信息最新、同步状态无错误。

完成标志： 出现配置链接加密口令弹窗。

在 Encrypt your settings 中设置一个用于保护配置链接的口令，点击 OK。随后在 Setup URI 弹窗中点击文本框右侧的 📋 复制按钮，看到 ✔️ 或 copied 提示后再点 OK。将完整链接粘贴到新电脑的 Setup-URI 输入框。

记住这次填写的链接解锁口令，新电脑导入时需要使用。同一条配置链接与对应口令配套使用。

完成标志： 已获得完整配置链接及其解锁口令。

首次启用插件时会出现欢迎向导。选择“我要将设备加入现有同步配置”，然后点击“是的，我要把这台设备加入现有同步”。

完成标志： 进入添加现有同步设备的设置流程。

在“设备设置方式”中选择“使用 Setup URI（推荐）”，点击“继续使用 Setup URI”。

完成标志： 出现 Setup-URI 和口令输入栏。

将完整配置链接粘贴到 Setup-URI，在“密码”一栏填入这条链接的解锁口令，点击 Test Settings and Continue。

按下面的顺序完成获取；获取结束后，再到同步设置应用 LiveSync 同步预设。

• 按向导选择 Restart and Fetch Data。若重启后“快速设置”仍显示“启用 LiveSync”，先点击启用并立即重启。
• 出现 Data retrieval scheduled 时，按前文的“选择保留较新的文件 → 确认首次获取时的删除处理 → 确认同步配置并等待获取完成”操作。
• 等待获取完成、flag_fetch 自动消失，再确认同步模式为 LiveSync 同步。
• 若出现兼容性暂停，先查看 Review compatibility details，确认所有使用同一数据库的设备版本兼容，再返回选择 Resume synchronisation。

完成标志： 首次获取完成，同步模式已确认；接着用下面的双向测试验收。

保持两端 Obsidian 都联网并打开。在第一台电脑新增“A端测试”，检查第二台是否自动出现；然后在第二台追加“B端回复”，回到第一台确认这句也出现。

同时打开图片和 PDF，确认附件内容可读。若只有手动 Sync now 后才收到，请在发送端核对 LiveSync 同步模式。

完成标志： 验收目标：两端的新修改均能自动到达，附件可以打开。

在左侧文件列表右键点击笔记，可以重命名、移动或删除。正常同步时，这些操作也会传到其他设备。重命名、删除或添加较多附件后，等待处理完成再关闭 Obsidian。

完成标志： 文件操作完成，待处理同步结束后再关闭应用。

进入“设置 → Self-hosted LiveSync → 远程配置”。Saved connections 下标有 Active 的是当前连接。点击这一行的扳手按钮（Configure）查看它的连接信息。

完成标志： 打开当前 Active 连接的编辑页。

将 URL、用户名、密码和数据库名称逐项与分配信息核对。同步账号密码更新后，每台设备都要在这里填写新密码。

核对完成后，向下滚动并点击 Test connection and save。成功返回后，验证新修改能否继续传输。

• URL 填管理员提供的服务地址，不在末尾自行拼数据库名。
• 用户名使用管理员提供给你的同步账号。
• 数据库名称照抄管理员给出的值，不按用户名自行猜测。

完成标志： 连接测试通过，新修改仍可正常传输。