Obsidian 多设备同步配置指南

Obsidian 多设备同步配置指南：电脑端 Git 插件 + 手机端 GSync

本指南将帮助你实现电脑端（使用 Obsidian Git 插件）与手机端（使用 GitSync 等工具）的笔记同步，确保数据安全、版本可控。

一、电脑端配置（使用 Obsidian Git 插件）

1. 安装 Git

• Windows：访问 https://git-scm.com/download/win 下载安装包，默认设置安装即可。
• macOS ：可通过 Homebrew (brew install git) 或从官网下载安装。
• Linux ：使用包管理器安装（如 sudo apt install git）。

2. 创建远程 Git 仓库

• 推荐平台 ：国内用户建议使用 Gitee（码云） ，访问速度快；国际用户可使用 GitHub。
• 操作步骤 ：
  1. 注册并登录 Gitee/GitHub。
  2. 点击"新建仓库"，名称如 my-obsidian，选择"私有"仓库。
  3. 不要勾选"初始化仓库"，直接创建。

3. 生成访问令牌（Token）

• 在 Gitee/GitHub 的"设置"→"私人令牌"中，生成新令牌。
• 备注填写"Obsidian 同步"，勾选 projects 等必要权限。
• 立即复制并保存令牌（关闭页面后无法查看）。

4. 本地 Obsidian 仓库初始化

1. 打开 Obsidian，进入你的笔记库（Vault）根目录。

2. 打开终端/命令行，执行以下命令：

   git init
   git remote add origin https://gitee.com/你的用户名/仓库名.git
   git add .
   git commit -m "init vault"
   git push -u origin main

5. 安装并配置 Obsidian Git 插件

1. 在 Obsidian 中：设置 → 第三方插件 → 浏览 → 搜索"Git" → 安装并启用。
2. 进入插件设置，关键配置如下：

设置项	建议值	说明
Auto pull interval	10（分钟）	每10分钟自动拉取远程更新
Auto commit-and-sync interval	10（分钟）	每10分钟自动提交并推送
Commit message	vault backup:{``{date}}	自动提交信息，带时间戳
Pull updates on startup	开启	启动时先拉取最新内容
Push on backup	开启	自动提交后立即推送
Authentication/Commit Author	填写你的 Gitee/GitHub 用户名和邮箱	用于身份验证
Personal access token	粘贴之前复制的令牌	确保推送权限

3. 创建 .gitignore 文件（可选但推荐），排除不需要同步的文件：

   .obsidian/workspace.json
   .obsidian/.trash/
   .DS_Store

至此，电脑端配置完成。插件会在后台自动同步，你无需手动操作。

二、手机端配置（使用 GitSync + Obsidian）

由于 Obsidian 移动端的 Git 插件功能有限且体验不佳，推荐使用 GitSync （安卓）或 Working Copy（iOS）作为 Git 客户端，再由 Obsidian 打开仓库目录。

安卓端配置（GitSync）

参考链接

1. 安装所需应用

• Obsidian：从官方渠道或应用商店安装。
• GitSync ：在 Google Play 搜索"GitSync"安装，或从 https://gitsync.viscouspotenti.al ，https://github.com/ViscousPot/GitSync下载。
• Termux（可选）：用于执行 Git 命令，可从 F-Droid 或 Google Play 安装。

2. 克隆远程仓库到手机

• 方法一（使用 GitSync）：

  1. 打开 GitSync，选择"Clone repository"。
  2. 输入远程仓库地址（格式：https://oauth2:你的令牌@gitee.com/用户名/仓库名.git）。需要HTTPS认证账号和密码。还可以使用SSH方式登录，生成密钥把私钥复制到github的SSH密钥清单中即可自动登录。
  3. 选择本地存储路径（如 Documents/obsidian-mobile）。
  4. 等待克隆完成（首次可能较慢）。

• 方法二（使用 Termux）：

  1. 打开 Termux，执行：

     cd ~/storage/shared/Documents
     git clone https://oauth2:你的令牌@gitee.com/用户名/仓库名.git

3. 在 Obsidian 中打开仓库

1. 打开 Obsidian，选择"打开本地仓库"。
2. 导航到刚才克隆的目录（如 Documents/obsidian-mobile/仓库名）。
3. 确认打开，即可看到笔记内容。

4. 配置 GitSync 自动同步

1. 在 GitSync 中，进入"Auto Sync Settings"。
2. 点击"SELECT APP(S)"，选择 Obsidian。
3. 开启"开启软件时自动同步"和"关闭软件时自动同步"（可选，但可能产生过多提交）。
4. 建议手动同步：在 GitSync 主界面点击"Sync"按钮，或在 Obsidian 使用前后手动同步。

iOS 端配置（Working Copy）

1. 安装 Working Copy（付费 App，但功能完整）。
2. 在 Working Copy 中克隆你的远程仓库。
3. 将仓库链接到本地文件夹（Share → Link Repository to Folder）。
4. 在 Obsidian 中打开该文件夹作为 Vault。

三、同步流程与最佳实践

日常使用流程

1. 电脑端：正常编辑笔记，插件每10分钟自动提交并推送。
2. 手机端 ：
   • 使用前：打开 GitSync，点击"Pull"拉取最新笔记。
   • 使用后：点击"Commit & Push"推送修改。
3. 避免冲突 ：尽量不要同时在电脑和手机上编辑同一文件。如果出现冲突，Git 会高亮提示，手动选择保留版本即可。

高级建议

• 双库结构：可创建两个仓库，一个用于电脑端深度整理（主库），一个用于手机端闪念记录（移动库），定期合并。
• SSH 密钥认证：若熟悉 SSH，可配置密钥替代 Token，更安全便捷。
• 定期维护 ：偶尔检查 .gitignore，确保不同步临时文件；清理无用分支。

故障排除

• 同步失败：检查网络连接、Token 是否过期、仓库地址是否正确。
• 插件报错：确认电脑端 Git 已安装并重启 Obsidian；手机端如 Obsidian Git 插件不稳定，坚持使用 GitSync/Working Copy。

四、方案优势总结

• 免费：无需支付 Obsidian Sync（8美元/月）。
• 安全：私有仓库 + 版本历史，误删可回滚。如果跟icloud,坚果云，onedrive的云平台也可对接，但是没有版本管理。
• 可控：完全掌握数据，无第三方依赖。
• 跨平台：支持 Windows、macOS、Linux、Android、iOS。

五、其它技巧

• 启用obsidian内置浏览器： 好处是打开的页面可以直接保存到obsidian!
• 在外部浏览器中一定要安装Obsidian web Clipper 插件：它可以按照自定义模板保存地址和摘要到obsidian。

按照以上步骤，你即可搭建一套稳定、免费的多设备 Obsidian 同步系统。开始享受随时随地无缝记录与查阅笔记的体验吧！

也可参考：Obsidian多端同步终极指南：阿里云OSS+Remotely Save插件保姆级配置