手把手教你实现 Obsidian 全平台同步：Windows、iOS 与 GitHub 完美联动

很多刚接触 Obsidian 的朋友都会遇到一个头疼的问题：笔记存在本地，换个设备就得手动导来导去，太麻烦了。尤其是想要在 Windows 电脑和苹果手机之间无缝切换，更是难上加难。

虽然官方有同步服务，但对于喜欢折腾或者想省点钱的博主来说，通过 GitHub 同步无疑是性价比最高的方案（免费、私有、安全）。今天我就把这套经过验证的“Windows + iOS + GitHub”三端同步方案毫无保留地分享出来。

为什么选择 GitHub 做中转？

可能有人会说，用 iCloud、坚果云或者 OneDrive 不行吗？当然行，但它们各有局限。例如 iCloud 在 Windows 上经常抽风，速度慢；而 GitHub 作为开发者平台，不仅稳定，还能顺便给笔记库做个“版本控制”。万一你误删了重要笔记，还能在 GitHub 上直接“时光倒流”找回，这对于知识库来说简直太重要了。

在 GitHub 设置中生成 Personal access token 是连接的关键一步。

准备工作：账号与仓库

在开始之前，你需要准备几样东西：

1. GitHub 账号：如果没有，去注册一个，全程免费。
2. 创建一个新的仓库：名字随意（比如 my-obsidian-vault），注意一定要设为 Private（私有），防止个人隐私泄露。
3. 获取 Token（令牌）：这是后续连接的关键。
   • 进入 GitHubSettings -> Developer settings -> Personal access tokens -> Tokens (classic)。
   • 点击“Generate new token (classic)”。
   • 勾选 repo 权限下的所有选项，设置过期时间（建议选 90 天或 longer），最后点击生成。
   • 重要提示：生成的那个长字符串一定要复制下来保存好，刷新页面就看不到了！

Windows 端设置：核心步骤

PC 端是最容易出问题但也最关键的一步，我们主要依靠第三方插件 Obsidian Git 来实现自动同步。

1. 安装插件

• 打开 Obsidian Desktop 版，进入 设置 -> 第三方插件 -> 浏览。
• 搜索 Obsidian Git 并安装。
• 安装好后，在“已安装插件”列表中开启它。

2. 配置插件

• 在插件设置页面，找到 Auto commit interval，建议设置为 15 分钟或 30 分钟，这样你每隔一段时间笔记就会自动上传。
• 在 Git binary path 选项中，如果你的电脑已经安装了 Git，通常会自动识别。如果没有，你需要去 Git 官网下载安装器，安装一路 Next 即可，路径通常是 C:\Program Files\Git\bin\git.exe。

在 Obsidian 中安装并配置 Obsidian Git 插件以实现自动备份。

3. 连接 GitHub（免密登陆）

这是新手最容易卡住的地方。为了不用每次同步都输密码，我们需要配置刚才生成的 Token。

• 方法一（推荐）：在 Obsidian Git 设置中，直接将 Token 填入相应位置，并在远程仓库 URL 中使用 https://[email protected]/username/repo.git 的格式。
• 方法二（使用凭据管理器）：在 Git Bash 或 CMD 中，使用命令 https://你的[email protected]。下次同步时，Windows 就会记住你的凭据。

设置好后，点击插件左侧命令栏里的“Create backup (commit)”测试一下。如果看到右下角提示“Commit successful”，说明你成功了一大半！

iOS 端设置：移动端的福音

苹果手机上的操作相对依赖 Obsidian 官方客户端自身的“第三方同步”功能，或者是 Shortcuts（快捷指令）技巧，但这里介绍一种更直观、稳定性较好的方案。

使用 Working Copy 在 iOS 端克隆 GitHub 笔记仓库。

1. 复制仓库到手机

• 在手机上下载 Obsidian 官方 App。
• 另外，你需要一个能管理 GitHub 文件的 App。很多人推荐 Working Copy，它是 iOS 上最强大的 Git 客户端。

2. 使用 Working Copy 克隆

• 打开 Working Copy，点击“+”号克隆仓库。
• 输入你的 GitHub 仓库地址（记得带上 Token，格式类似：https://[email protected]/username/repo.git）。
• 克隆成功后，你就拥有了一个本地文件夹。

3. 与 Obsidian 关联

• 打开 Obsidian 手机版，点击“创建新仓库” -> “打开文件夹”。
• 在文件选择界面，找到“...”更多选项，选择 On My iPhone -> Working Copy -> 你的仓库名称。
• 选择该文件夹，你的所有笔记就会瞬间加载到手机上了。

4. 手机端同步逻辑

• 写笔记：直接在 Obsidian 里写，但此时并没有提交到 GitHub。
• 上传：写完后，打开 Working Copy，你会发现文件有变化。点击“Commit”并填写备注，然后点击“Push”。这样，你的修改就上传到 GitHub 了。
• 下载：如果电脑端有了新修改，手机端只要打开 Working Copy，点击“Pull”，然后再打开 Obsidian 就能看到最新内容。

常见问题与解决方案

Q1: Windows 端提示“Git not found”怎么办？ A: 说明你没装 Git 或者路径没填对。去 Git 官网下载安装包，安装完成后重启 Obsidian 试试。

Q2: 同步时提示“Authentication failed”？ A: 99% 是 Token 过期了或者输错了。去 GitHub 后台重新生成一个，更新到软件配置里即可。

Q3: 手机端能不能像 PC 那样自动同步？ A: 原生 Obsidian iOS 不支持直接后台 Git 同步，但你可以利用 iOS 的“快捷指令”编写一个简单的自动化脚本，通过 URL Scheme 唤起 Obsidian 和 Working Copy，实现“一键同步”。这个虽然稍微有点门槛，但用起来非常爽。

总结

虽然第一次配置这套 GitHub 同步流程有点繁琐，需要折腾 Token、SSH 之类的概念，但一旦搭建好，你就拥有了一个完全免费、极速且安全的个人知识库同步网络。

无论是写博客、记日记还是整理项目资料，再也不用担心数据丢失，随时随地都能拿出设备继续记录。如果你还没试过，不妨趁着周末动手搞一下，从此告别 U 盘传文件的日子！