@Cander_zhu: https://x.com/Cander_zhu/status/2066500295970959677

X AI KOLs Timeline 工具
syncthing obsidian sync tutorial mac android free

摘要

一份实测通过的 Syncthing 免费同步 Obsidian 的完整配置指南，涵盖 Mac 和 Android 端的安装、设备互联、文件夹共享及避坑经验。

https://t.co/jPMNdZrx0O
查看原文
查看缓存全文

缓存时间: 2026/06/15 21:09

我今天下午花半小时踩坑实测：Syncthing 免费同步 Obsidian（Mac + Android）终于走通了！

今天下午我狠下心，花整整半小时 把 Syncthing + Obsidian 同步从头到尾又跑了一遍。

结果第一遍就翻车了——文件夹路径设置错误，同步出来全是乱码，手机端打开一堆乱七八糟的文件，差点崩溃。

后来我直接把两边设备上的文件夹全部删掉，重新从零开始一步步配置……这次终于彻底走通了！下面是我亲测成功的最稳方案 + 避坑记录，Mac + Android 的朋友可以直接抄作业。

以下是完整、可直接复现的成功流程，附上我这次实测的避坑经验。

为什么推荐 Syncthing？

  • 完全免费

  • 实时双向同步

  • 数据完全在自己设备之间传输（不经过云服务器）

  • 支持 Mac / Windows / Linux / Android

  • 插件、主题、.obsidian 配置都能同步

核心架构： Mac Obsidian ↔ Syncthing（P2P）+ Git 做版本备份（双保险）（可选，但我当前暂未启用）

完整配置流程（已实测成功）

1. Mac 端安装

推荐使用 Homebrew 安装。

打开终端：

brew install syncthing

#安装完成后启动： brew services start syncthing

检查是否运行： brew services list

#查看 Syncthing 是否监听端口： lsof -i :8384

#正常会看到： syncthing xxxx TCP localhost:8384 (LISTEN)

备选方式（官网下载）：

  • 去 Syncthing 官网下载 Mac 对应压缩包

  • 解压后直接运行 syncthing 可执行文件

**💡注意：**当使用可执行文件启动的时候，需要你在系统设置 -> 隐私与安全性 这里设置“仍然打开”，不然启动不成功，属于临时运行，每次重启 Mac 都要重新启动。 浏览器打开：http://localhost:8384

这就是 Syncthing 的控制面板，后续所有配置都在这里完成。

2. Android 端安装

推荐安装 Syncthing-Fork（社区维护版，更稳定），在google play 直接搜索。

这是目前安卓社区最活跃的版本。安装后打开应用。

3. 设备互联

  • 电脑端：Actions → Show ID，复制 Device ID（也可手机扫二维码）

  • Android：添加设备 → 粘贴 ID/直接扫电脑端端设备二维码，就会看到电脑端有弹窗出现。

  • Mac 确认接受

到此，我们就完成了两台设备的互相信任。接下去就是创建同步目录了。

4.添加 Obsidian 文件夹

**这次踩的坑：**第一次我把整个 Documents 文件夹加进去了，同时在手机端设置目录路径时设置出错，导致同步出现大量乱码和隐藏文件冲突。

正确做法：

  • 在电脑端的 Syncthing 面板点击 Add Folder

  • **Folder Label：**Obsidian（随你自己）

  • **Folder Path：**只选择独立的 Vault 文件夹，（例如 /Users/你的用户名/Documents/Obsidian）

  • **重要：**不要把整个 Documents 或 iCloud 文件夹加进去，只同步独立的 Vault 文件夹！

5. 共享给 Android

编辑 Folder → Sharing → 勾选 Android 设备 → 保存

6. Android 接受并选择路径 接受共享后，选择保存位置（推荐新建 /storage/emulated/0/Obsidian），

如果你手机端已经安装了Obsidian并已创建Vault，那就直接使用路径填写。

提示：手机的路径都是/storage/emulated/0开始，后面就是你具体的文件路径，我的是在Documents/doc，所以填写的时候就是“/storage/emulated/0/Documents/doc”。

7. 等待首次同步

我这次重新配置后，30多篇笔记大概花了 10 秒左右 完成同步，之后就非常丝滑。

8. 在 手机端中打开Obsidian

选择你的Vault仓库，就可以看到从电脑端同步的内容了。

实测验证

  • Mac 新建笔记 → Android 几秒内出现

  • Android 编辑或新增 → Mac 自动更新

  • 插件和主题也正常同步

常见问题 & 我的避坑经验

Q：出现乱码或同步失败？ 最常见原因是文件夹路径设置错误。

解决办法：删掉两边对应文件夹，重新添加干净的 Vault 文件夹（我今天就是这么解决的）。

Q：必须同一 WiFi 吗？ 不需要。只要两台设备能上网即可。

Q：一台离线会怎样？ 会等对方上线后再同步，不会丢数据。

Q：安全吗？ 比云盘更安全（完全点对点）。重要 Vault 建议配合 Git + GitHub Private 仓库做版本控制。

最终推荐架构

  • **实时同步：**Syncthing

  • **版本控制 + 异地备份：**Git + GitHub Private Repo（可选，但我当前暂未启用）

花了半小时实测后，我更加确认：对于不想付费的用户，Syncthing 是目前 Mac + Android 上最稳、最自由的 Obsidian 同步方案。

虽然第一次配置可能会踩一两个坑，但走通之后真的很香。

你目前用什么方案同步 Obsidian？ 欢迎在评论区分享你的配置，或遇到过什么坑，我可以一起讨论。

相似文章

@AI_Jasonyu: 我觉得自己早上干了件超牛逼的事情，那就是把Obsidian和微信/Hermes打通了，和Github打通了，也同步了iCloud，增加了快捷指令的入口。 我目前能够实现的是： 1、我可以直接通过微信通信让Hermes直接记录我的想法，同步…

X AI KOLs Timeline

用户分享了自己打通Obsidian与微信、Hermes、GitHub、iCloud的工作流，实现了通过微信直接记录想法到Obsidian，并使用iCloud免费同步电脑和手机端的方案。