Obsidian Sync Syncthing — Obsidian 同步 同步thing

Obsidian 跨平台同步方案（Mac ↔ iPhone）

零插件 · 零成本 · 智能过滤 · 离线优先

方案概述

本方案使用 同步thing（开源 P2P 同步工具）实现 Mac 与 iPhone 之间的 Obsidian vault 双向同步，无需 iCloud、无需 Obsidian 同步 订阅、无需任何 Obsidian 插件。

核心亮点 特性 本方案 Obsidian 同步 iCloud 费用 免费 $4/月 免费（5GB） 插件依赖 无 无 无 智能大文件过滤 ✅ 支持 ❌ ❌ 离线可用 ✅ ✅ ⚠️ 需预同步 去中心化 ✅ P2P直连 ❌ 云端中转 ❌ 应用le服务器 端到端加密 ✅ ✅ ❌ 跨平台 ✅ 全平台 ✅ 全平台 仅 应用le 架构图 ┌─────────────┐ 同步thing (P2P) ┌─────────────┐ │ Mac │◄──────────────────────────────►│ iPhone │ │ │ 端到端加密 · 局域网直连 │ │ │ 同步thing │ 无需第三方服务器 │ Möbius 同步 │ │ (服务端) │ │ (客户端) │ │ │ │ │ │ Obsidian │ │ Obsidian │ │ Vault/ │ │ 本地目录/ │ │ ... │ │ ... │ └─────────────┘ └─────────────┘

智能大文件过滤

同步时自动排除以下文件，节省手机空间：

压缩包：.7z、.zip、.rar 视频：.mp4、.mov、.avi 大 PPT：>50MB 的 .pptx / .ppt 前置要求 设备 要求 Mac macOS 11+，已安装 同步thing iPhone iOS 15+，安装 Möbius 同步（应用 Store 免费） 网络 两台设备在同一局域网，或配置远程发现 第一步：Mac 端配置 1.1 安装 同步thing # 使用 Homebrew 安装 brew 安装 同步thing

# 启动 同步thing（后台运行） brew 服务s 启动 同步thing

# 或前台运行（用于初次配置） 同步thing

1.2 打开 网页 管理界面

浏览器访问 http://127.0.0.1:8384

1.3 记录设备 ID

在 网页 界面 → 「操作」→ 「显示 ID」，复制你的设备 ID（稍后 iPhone 端需要）。

1.4 配置开机自启 # macOS 开机自启 brew 服务s 启动 同步thing

1.5 添加同步文件夹 网页 界面 → 「文件夹」→「添加文件夹」 文件夹标签：Obsidian Vault 文件夹路径：你的 Obsidian vault 路径，例如 ~/Documents/Obsidian Vault 版本控制：建议开启，保留最近 5 个版本（防误删） 保存 第二步：iPhone 端配置 2.1 安装 Möbius 同步

应用 Store 搜索「Möbius 同步」，免费下载。

注意：免费版限制同步 20MB。如 vault 超过 20MB，需内购买断（¥38）。

2.2 添加设备（配对 Mac） 打开 Möbius 同步 → 「Devices」→「+」 输入 Mac 的设备 ID（1.3 步骤中记录的） 设备名填你的 Mac 名称 保存，等待配对 2.3 Mac 上确认配对

回到 Mac 的 同步thing 网页 界面（http://127.0.0.1:8384），会看到 iPhone 的配对请求，点击「添加设备」。

2.4 添加同步文件夹

关键步骤：将同步目标指向 Obsidian 的本地目录

Möbius 同步 → 「Folders」→「+」→「添加 Folder」 Folder Label：Obsidian Vault Folder Path：选择 iPhone 上 Obsidian 的本地目录 路径：「文件」应用 →「我的 iPhone」→「Obsidian」→「Obsidian Vault」 分享d With：勾选你的 Mac 设备 保存 2.5 Mac 上确认共享

回到 Mac 的 同步thing 网页 界面，确认 iPhone 的文件夹共享请求。

2.6 确认同步状态 iPhone 上 Möbiing 同步 显示文件夹状态为 运行ning Obsidian 应用 打开即可看到所有笔记 第三步：智能大文件过滤 3.1 创建排除规则脚本

在 Mac 上创建同步脚本，自动排除大文件：

#!/usr/bin/env python3 """同步 Obsidian Vault 到 iCloud/Möbius，排除大文件""" 导入 subprocess, os, tempfile

SRC = "~/Documents/Obsidian Vault" # 替换为你的 vault 路径 DST = "~/库/移动 Documents/com~应用le~CloudDocs/Obsidian Vault" # 替换为目标路径

# 找出 >50MB 的 PPT 文件 结果 = subprocess.运行( ["find", os.path.expanduser(SRC), "-type", "f", "(", "-name", ".pptx", "-o", "-name", ".ppt", ")", "-size", "+50M"], capture_输出=True, text=True ) big_ppts = 结果.stdout.strip().split("\n") if 结果.stdout.strip() else []

# 生成 exclude-from 文件 exclude_tmp = tempfile.NamedTemporaryFile(mode='w', suffix='.txt', 删除=False) exclude_tmp.write(".7z\n.zip\n.rar\n.mp4\n.mov\n.avi\n") for f in big_ppts: if f: rel = f.replace(os.path.expanduser(SRC) + "/", "") exclude_tmp.write(rel + "\n") exclude_tmp.close()

# r同步 同步 cmd = ["r同步", "-av", "--更新", f"--exclude-from={exclude_tmp.name}", f"{os.path.expanduser(SRC)}/", f"{os.path.expanduser(DST)}/"] subprocess.运行(cmd) os.unlink(exclude_tmp.name)

print(f"✅ 同步完成，已排除 {len(big_ppts)} 个大PPT文件")

3.2 运行脚本 python3 同步-obsidian.py

第四步：配置优化 4.1 同步thing 网页 UI 密码保护 # 生成密码哈希 同步thing 生成 --password

# 编辑配置文件（~/.config/同步thing/config.xml） # 找到 <图形界面> 标签，添加： # admin # 哈希值

# 重启 同步thing brew 服务s re启动 同步thing

4.2 仅局域网同步（更省电）

网页 界面 → 「设置」→ 「连接」→「本地发现」开启，「全局发现」关闭。这样设备只在同局域网时同步。

4.3 版本控制

网页 界面 → 文件夹设置 →「版本控制」→ 选择「简易文件版本控制」，建议保留最近 5-10 个版本。

常见问题 Q: iPhone 上文件夹状态显示 停止ped

A: 检查 同步thing 引擎是否启用。Möbius 同步 → 设置 → 确认 同步thing 服务为 运行ning 状态。

Q: 免费版 20MB 限制

A: Obsidian vault 超过 20MB 时，Möbius 同步 免费版会禁用同步。需内购买断（¥38，一次性）。

Q: 同步延迟或不自动同步

A:

确认两台设备在同一局域网 检查 iPhone 是否允许 Möbius 同步 后台运行（设置 → 通用 → 后台 应用 刷新） 手动触发：Möbius 同步 → 文件夹 → Re扫描 Q: 冲突文件处理

A: 同步thing 会保留冲突版本（文件名加 .同步-conflict 后缀），不会覆盖。建议开启版本控制以防万一。

Q: Obsidian iPhone 打开的是空 vault

A: 确认 Möbius 同步 的同步路径指向的是 Obsidian 的本地目录（「我的 iPhone」→「Obsidian」→「Obsidian Vault」），而不是其他目录。

Q: 如何排除特定大文件

A: 在同步脚本的 exclude 列表中添加规则，如 .psd（设计文件）、.AI 等。

技术原理 为什么不用 Obsidian 插件方案？

现有方案（如 GitHub 上的 obsidian-同步thing-integration）需要在 Obsidian 内安装 同步thing 插件，存在以下问题：

依赖插件维护 — 插件停止维护则方案失效 增加 Obsidian 负担 — 插件运行占用 Obsidian 资源 兼容性风险 — Obsidian 更新可能导致插件失效

本方案在文件系统层同步，与 Obsidian 完全解耦，更稳定可靠。

为什么不用 iCloud？ iCloud 同步有延迟（尤其是大文件） 免费空间只有 5GB 不支持智能文件过滤 依赖 应用le 服务器，离线不可用 License

MIT License — 作者 KyleJia

Copyright (c) 2026 KyleJia

权限 is hereby granted, free of charge, to any person obtAIning a copy of this software and associated documentation files (the "Software"), to deal in the Software wi