泊远的博客

Appearance

peng_hao2026-04-22
1686
6.7m

Obsidian Git 同步配置指南：实现多端自动备份 ​

前言 ​

Obsidian 是一款强大的知识管理工具，支持 Markdown 格式，拥有丰富的插件生态。虽然 Obsidian 官方提供了 Sync 同步服务，但需要付费订阅。对于习惯使用 Git 进行版本控制的用户来说，通过 Obsidian Git 插件 实现免费、自动的多端同步是一个不错的选择。

本文将详细介绍如何配置 Obsidian Git 插件，实现电脑端自动同步和移动端配合使用。

一、为什么选择 Git 同步？ ​

相比 Obsidian 官方 Sync 服务，Git 同步方案有以下优势：

特性Obsidian SyncGit 同步
费用付费订阅免费
版本历史有限完整版本控制
存储空间官方限制依赖 Git 仓库
隐私性官方服务器自选平台
多端支持原生需配置

适用场景：

  • 熟悉 Git 操作的用户
  • 对版本历史有需求的用户
  • 希望免费实现多端同步的用户

二、电脑端配置 ​

2.1 准备工作 ​

安装 Git

确保电脑已安装 Git，终端执行：

bash
git --version

如未安装：

  • Windows：从 git-scm.com 下载安装
  • macOS：brew install git
  • Ubuntu/Debian：sudo apt install git

创建远程仓库

在 Gitee、GitHub 等平台创建新的私有仓库：

  • 不要勾选「初始化仓库」
  • 不要添加 README 文件
  • 保持仓库为空

推荐使用 Gitee

国内访问 Gitee 速度更快，稳定性更好。

2.2 初始化本地 Git 仓库 ​

打开 Obsidian 知识库（Vault）所在文件夹，在该目录下打开终端，执行：

bash
# 初始化 Git 仓库
git init

# 关联远程仓库（SSH 方式，推荐）
git remote add origin git@gitee.com:你的用户名/仓库名.git

# 或使用 HTTPS 方式
git remote add origin https://gitee.com/你的用户名/仓库名.git

2.3 创建 .gitignore 文件 ​

在知识库根目录创建 .gitignore 文件，避免同步不必要的文件：

gitignore
# Obsidian 配置目录
.obsidian/

# 回收站
.trash/

# 系统文件
.DS_Store
Thumbs.db

# 临时文件
*.tmp
*.temp

2.4 安装 Obsidian Git 插件 ​

  1. 打开 Obsidian → 设置 → 第三方插件
  2. 关闭「安全模式」
  3. 点击「浏览」搜索 Git
  4. 找到由 Vinzent 开发的插件，点击安装并启用

2.5 配置 Git 插件 ​

打开插件设置页面，按以下步骤配置：

认证信息配置（Authentication/Commit Author）

配置项说明
UsernameGit 用户名
EmailGit 邮箱
Personal access tokenHTTPS 方式必填，SSH 方式可跳过

HTTPS 方式需要 Token

GitHub/Gitee 已不再支持密码认证，需要创建 Personal Access Token：

  • GitHub：Settings → Developer settings → Personal access tokens
  • Gitee：设置 → 私人令牌 → 生成新令牌

自动同步配置（Automatic）

配置项推荐值说明
Auto commit-and-sync interval10-30 分钟自动提交同步间隔
Pull on startup✅ 开启启动时自动拉取最新
Push on commit-and-sync✅ 开启提交后自动推送
Commit messagevault backup: 提交信息模板

2.6 首次同步 ​

配置完成后，执行首次同步：

  1. 点击左侧边栏 Git 图标
  2. 打开源码控制视图
  3. 点击 Commit-and-sync 按钮
  4. 等待首次提交和推送完成

三、移动端同步方案 ​

Obsidian Git 插件在移动端支持有限，推荐使用专用 Git 客户端配合使用。

3.1 Android 设备 ​

推荐应用：GitSync 或 MGit

配置步骤：

bash
# 1. 安装 GitSync 应用

# 2. 克隆远程仓库到手机
# 在 GitSync 中选择 Clone，输入仓库地址

# 3. 设置同步目录
# 选择手机上的目标目录，如 /Documents/Obsidian/

# 4. 打开 Obsidian
# 选择「打开文件夹作为库」
# 导航到 GitSync 同步的文件夹

GitSync 配置要点：

  • 设置自动同步间隔
  • 编辑前后手动点击同步
  • 支持后台自动同步（需付费版）

3.2 iOS 设备 ​

推荐应用：Working Copy（付费）

配置步骤：

bash
# 1. 安装 Working Copy 应用

# 2. 克隆远程仓库
# 在 Working Copy 中添加仓库

# 3. 链接到文件 App
# 使用 Share 功能将仓库链接到「文件」App

# 4. 在 Obsidian 中打开
# 选择链接后的文件夹作为知识库

iOS 同步流程：

  1. 编辑前：Working Copy → Pull
  2. 在 Obsidian 中编辑笔记
  3. 编辑后：Working Copy → Commit & Push

3.3 移动端配置命令参考 ​

如果使用 Termux 或 iSH 等终端应用：

bash
# 初始化 Git
git init

# 设置分支
git branch -M main

# 添加远程仓库
git remote add origin https://gitee.com/你的用户名/仓库名.git

# 配置安全目录（Android）
git config --global --add safe.directory /storage/emulated/0/Documents/Obsidian/你的库名

# 配置用户信息
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 拉取远程代码
git pull origin main

四、常见问题与解决方案 ​

4.1 同步冲突处理 ​

问题：多端同时编辑同一文件导致冲突

解决方案：

  1. 养成「编辑前 Pull、编辑后 Push」的习惯
  2. 冲突时手动解决，Git 会标记冲突位置
  3. 使用 git mergetool 或编辑器解决冲突

4.2 大文件同步失败 ​

问题：附件或图片文件过大导致推送失败

解决方案：

bash
# 使用 Git LFS 管理大文件
git lfs install
git lfs track "*.pdf"
git lfs track "*.png"
git lfs track "*.jpg"

4.3 HTTPS 认证失败 ​

问题：HTTPS 方式推送提示认证失败

解决方案：

  1. 确认使用了正确的 Personal Access Token
  2. Token 需要有 repo 权限
  3. 在插件设置中重新填入 Token

4.4 中文文件名乱码 ​

问题：中文文件名在 Git 中显示乱码

解决方案：

bash
git config --global core.quotepath false

五、最佳实践建议 ​

5.1 同步频率设置 ​

使用场景推荐间隔
高频编辑5-10 分钟
日常使用10-30 分钟
低频编辑30-60 分钟或手动

5.2 分支策略 ​

对于重要笔记库，可以采用分支策略：

bash
# 创建备份分支
git checkout -b backup

# 主分支保持稳定
git checkout main

5.3 定期检查 ​

bash
# 查看同步状态
git status

# 查看提交历史
git log --oneline -10

# 查看远程仓库状态
git remote -v

六、总结 ​

通过 Obsidian Git 插件 + Git 同步方案，我们可以：

  • ✅ 免费实现多端笔记同步
  • ✅ 获得完整的版本控制能力
  • ✅ 自主选择存储平台
  • ✅ 保护笔记隐私安全

虽然配置稍显复杂，但一次配置，长期受益。对于重视数据安全和版本历史的用户来说，这是一个值得投入的方案。

参考资料 ​

最近更新