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

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

方案概述

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

核心亮点

架构图

┌─────────────┐         Syncthing (P2P)        ┌─────────────┐
│     Mac     │◄──────────────────────────────►│   iPhone    │
│             │     端到端加密 · 局域网直连      │             │
│  Syncthing  │     无需第三方服务器             │ Möbius Sync │
│  (服务端)   │                                 │  (客户端)   │
│             │                                 │             │
│  Obsidian   │                                 │  Obsidian   │
│  Vault/     │                                 │  本地目录/  │
│  ...        │                                 │  ...        │
└─────────────┘                                 └─────────────┘

智能大文件过滤

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

• 压缩包：*.7z、*.zip、*.rar
• 视频：*.mp4、*.mov、*.avi
• 大 PPT：>50MB 的 *.pptx / *.ppt

前置要求

第一步：Mac 端配置

1.1 安装 Syncthing

# 使用 Homebrew 安装
brew install syncthing

# 启动 Syncthing（后台运行）
brew services start syncthing

# 或前台运行（用于初次配置）
syncthing

1.2 打开 Web 管理界面

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

1.3 记录设备 ID

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

1.4 配置开机自启

# macOS 开机自启
brew services start syncthing

1.5 添加同步文件夹

1. Web 界面 → 「文件夹」→「添加文件夹」
2. 文件夹标签：Obsidian Vault
3. 文件夹路径：你的 Obsidian vault 路径，例如 ~/Documents/Obsidian Vault
4. 版本控制：建议开启，保留最近 5 个版本（防误删）
5. 保存

第二步：iPhone 端配置

2.1 安装 Möbius Sync

App Store 搜索「Möbius Sync」，免费下载。

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

2.2 添加设备（配对 Mac）

1. 打开 Möbius Sync → 「Devices」→「+」
2. 输入 Mac 的设备 ID（1.3 步骤中记录的）
3. 设备名填你的 Mac 名称
4. 保存，等待配对

2.3 Mac 上确认配对

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

2.4 添加同步文件夹

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

1. Möbius Sync → 「Folders」→「+」→「Add Folder」
2. Folder Label：Obsidian Vault
3. Folder Path：选择 iPhone 上 Obsidian 的本地目录
   • 路径：「文件」App →「我的 iPhone」→「Obsidian」→「Obsidian Vault」
4. Shared With：勾选你的 Mac 设备
5. 保存

2.5 Mac 上确认共享

回到 Mac 的 Syncthing Web 界面，确认 iPhone 的文件夹共享请求。

2.6 确认同步状态

• iPhone 上 Möbiing Sync 显示文件夹状态为 Running
• Obsidian App 打开即可看到所有笔记

第三步：智能大文件过滤

3.1 创建排除规则脚本

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

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