OBSIDIAN SYNC GUIDE

Obsidian 同步操作手册 · 手机/平板端

Android

版本 0.4 · LiveSync 1.0.28更新于 2026-09-16
01

准备文件与应用

准备项操作
Obsidian从文末的 Obsidian 官方下载入口安装 Android 版。
MT 管理器从文末 MT 官方入口下载“本地下载(正式版)”,安装后按提示允许访问笔记所在的存储位置。也可使用支持隐藏文件操作和指定解压位置的其他文件管理器。
nomedia.zip下载入口在“用 MT 放置 .nomedia”一节的操作步骤前。保存到手机上容易找到的目录,用 MT 打开即可。
02

创建手机/平板笔记库

以下以新建空库为例,接收电脑端已经同步的笔记。

01

填写库名,选择设备存储

  • 在 Create new vault 中填写名称,例如“手机端同步测试”。
  • 选择 Device storage,点击 Create。
  • 按设备的文件选择界面选定保存位置,并记住笔记库路径。已经建好的空库可直接使用。
创建库页面:填写名称后选择 Device storage。

完成标志: 进入新建的笔记库,并知道它在手机中的保存位置。

03

用 MT 放置 .nomedia

在首次同步图片附件前完成此项。先下载下面的 nomedia.zip 并保存到手机,再按图操作。

02

左边打开压缩包,右边打开笔记库

  • 左边:找到并打开 nomedia.zip,里面有一个 .nomedia 文件。
  • 右边:进入刚创建的笔记库文件夹;图中的 .obsidian 位于这一层,不要点进它。
  • 长按左边的 .nomedia,点击“解压 →”。如出现确认框,核对目标为右边的笔记库路径后确认。
MT 实拍:左侧为压缩包内容,右侧为目标文件夹;点击“解压 →”将文件放入右侧。

完成标志: 右边出现 .nomedia(0 B),与 .obsidian 文件夹同级。

04

安装并启用 LiveSync

03

搜索 Self-hosted LiveSync

打开 Obsidian 设置,进入“第三方插件”。如提示受限模式,先允许使用第三方插件,再打开插件浏览页面,搜索 self-hosted livesync。

搜索结果:Self-hosted LiveSync,作者为 vrtmrz。

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

04

安装插件并启用

点开插件详情,点击“安装”,安装完成后点击“启用”。出现“已安装”标记,且按钮显示“禁用”,说明插件已启用。

实拍中插件已安装并启用,版本为 1.0.28。

完成标志: 可以点击“选项”进入插件设置。

05

打开“使用设置 URI 连接”

点击插件的“选项”,进入“快速设置”(向导图标),在“使用设置 URI 连接”下点击“使用”。

在快速设置中找到“使用设置 URI 连接”,点击其下方“使用”。

完成标志: 打开 Enter Setup URI 输入窗口。

05

导入电脑端配置

06

粘贴配置链接,填写解锁口令

  • Setup-URI:粘贴电脑端导出的完整配置链接。
  • 密码:填写导出这条链接时设置的解锁口令。
Enter Setup URI:上方填写配置链接,下方填写对应的解锁口令。

完成标志: 两项内容填写完整。

07

测试设置并继续

看到 The Setup-URI is valid and ready to use 后,点击 Test Settings and Continue,等待进入下一步。

链接有效提示出现后,点击 Test Settings and Continue。

完成标志: 进入服务器用途选择页面。

08

选择加入已有服务器

选择第二项“My remote server is already set up. I want to join this device.”,表示服务器已经配置好,现在让这台设备加入。然后点击“Proceed to the next step.”。

选中第二项“加入已有服务器”,再继续下一步。

完成标志: 进入准备获取服务器数据的页面。

09

重启并获取数据

点击 Restart and Fetch Data。应用重启后,继续完成下面的数据获取选项。

Restart and Fetch Data:重启并从已有服务器获取同步数据。

完成标志: 出现 Data retrieval scheduled 页面。

06

完成首次数据获取

10

选择保留较新的文件

在 Data retrieval scheduled 页面,点击 Compare time and take newer(比较修改时间,保留较新的文件)。

点击 Compare time and take newer。

完成标志: 进入删除处理选项。

11

确认首次获取时的删除处理

本流程使用新建空库,选择 Keep local files even if deleted on remote(远程已删除时仍保留本地文件),继续首次获取。

新建空库接入示例:选择 Keep local files even if deleted on remote。

完成标志: 开始获取笔记;如出现兼容性暂停,按下一步处理。

12

如出现兼容性暂停,查看后恢复

  • 点击 Review compatibility details,查看暂停原因。
  • 按详情提示,确认连接同一数据库的电脑、手机/平板所用插件版本兼容;需要更新时先完成更新。
  • 返回此窗口,点击 Resume synchronisation(恢复同步)。
兼容性提示:查看详情并确认各设备版本兼容后,点击 Resume synchronisation。

完成标志: 获取流程继续,等待正文和附件出现在笔记库中。

07

查看笔记并测试同步

13

打开笔记,确认新修改能互相收到

  • 打开电脑端已有的笔记,查看正文和图片;点击 PDF 附件,确认能够打开。
  • 首次获取完成后,在插件“同步设置”的“预设”中选择 LiveSync 同步并点击“应用”,确认“同步模式”为 LiveSync 同步。
  • 保持两端 Obsidian 联网并打开。在手机/平板追加“手机端测试”,到电脑确认自动收到;再在电脑追加“电脑端回复”,回到手机/平板确认收到。
手机端已显示示例笔记正文、图片和 PDF 链接。继续用新的测试文字检查两个方向。

完成标志: 两端都能自动收到对方的新修改,且图片与 PDF 可打开。

参考链接

  1. Obsidian 官方下载
  2. MT 管理器官方下载
  3. MT 官方双窗口操作说明