跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

使用 Obsidian 的 Git 插件将笔记同步到 GitHub 私有仓库

介绍如何使用 Obsidian 配合 Git 插件将本地笔记同步至 GitHub 私有仓库。内容包括环境准备（安装 Git、创建仓库、生成令牌）、本地仓库初始化、插件配置及多设备同步设置。同时涵盖常见故障排查，如所有权问题、认证错误及移动端限制，帮助用户实现跨设备的版本控制与无缝协作。

GopherDev发布于 2026/3/29更新于 2026/5/2729 浏览
使用 Obsidian 的 Git 插件将笔记同步到 GitHub 私有仓库
前置条件

在开始之前，请确保具备以下条件：

  1. Obsidian 安装：已在电脑或移动设备上安装 Obsidian。
  2. Git 安装：
    • Windows：从 git-scm.com 下载并安装。
    • Mac：使用 Homebrew 安装（brew install git）或从官网下载。
    • Linux：使用包管理器安装，例如 sudo apt-get install git（Debian/Ubuntu）。
  3. GitHub 账号：已注册账号，建议启用双重认证。
  4. 基本了解：对 GitHub 和 Obsidian 的基本操作有一定了解。
步骤一：创建 GitHub 私有仓库
  1. 登录 GitHub：访问 github.com 并登录。
  2. 创建新仓库：
    • 点击右上角 '+' 图标，选择 New repository。
    • 填写仓库名称，例如 Obsidian-Notes。
    • 选择 Private（私有仓库），确保笔记不公开。
    • 暂时不需要勾选 'Add a README file'。
    • 点击 Create repository。
  3. 获取仓库地址：
    • 复制仓库的 HTTPS 或 SSH 地址（例如 https://github.com/你的用户名/Obsidian-Notes.git）。建议使用 HTTPS。
步骤二：生成 GitHub 个人访问令牌（PAT）

GitHub 不再支持密码认证，需使用 PAT 进行身份验证。

  1. 进入设置：
    • 点击右上角头像，选择 Settings。
    • 左侧菜单点击 Developer settings。
  2. 创建令牌：
    • 点击 Personal access tokens > Fine-grained tokens（推荐）或 Tokens (classic)。
    • 点击 Generate new token。
    • Fine-grained token：命名令牌，设置过期时间，选择仅特定仓库访问，启用 Contents（读写权限）。
    • Classic token：勾选 repo 权限。
    • 点击 Generate token。
  3. 保存令牌：
    • 复制生成的令牌并妥善保存（仅显示一次），建议存储在密码管理器中。
步骤三：初始化本地 Obsidian 仓库
  1. 选择或创建 Vault：
    • 打开 Obsidian，选择笔记文件夹。假设路径为 ~/Obsidian-Notes。
  • 导航至目录： 
    cd ~/Obsidian-Notes
  • 初始化 Git 仓库： 
    git init
  • 添加 .gitignore 文件（可选但推荐）：
    • 排除临时文件或设备特定配置。
    echo '.obsidian/cache/' >> .gitignore
echo '.obsidian/workspace.json' >> .gitignore
echo '.trash/' >> .gitignore
  • 关联远程仓库： 
    git remote add origin https://github.com/你的用户名/Obsidian-Notes.git
  • 提交初始文件： 
    git add .
git commit -m "Initial commit"
  • 重命名分支（如需要）： 
    git branch -m master main
  • 推送到 GitHub： 
    git push -u origin main
    • 如遇认证提示，用户名输入 GitHub 用户名，密码输入 PAT。

    • 常见问题：所有权检测错误

    如果遇到 fatal: detected dubious ownership in repository 错误，可尝试以下方法：

    • 方法 1：添加安全目录 
      git config --global --add safe.directory "E:/新备份/Documents/Obsidian Vault"
    • 方法 2：修改目录所有权（Windows） 
      icacls "E:\新备份\Documents\Obsidian Vault" /setowner "当前用户" /t /c
    步骤四：在 Obsidian 中安装和配置 Git 插件
    1. 安装插件：
      • 进入 Settings > Community plugins。
      • 关闭 Safe mode（首次使用）。
      • 搜索 Obsidian Git，点击 Install 并 Enable。
    2. 配置插件：
      • 进入 Settings > Obsidian Git。
      • 基本设置：
        • Vault backup interval：设置自动提交间隔（如 5 分钟）。
        • Commit message：自定义提交信息。
        • Auto push：启用，提交后自动推送。
        • Pull updates on startup：启动时自动拉取更新。
      • 认证设置：
        • HTTPS 模式：输入 GitHub 用户名和 PAT。
        • SSH 模式：确保本地已配置 SSH 密钥。
    3. 测试同步：
      • 创建新笔记，等待自动提交或手动触发备份命令。
      • 检查 GitHub 仓库确认同步成功。
    步骤五：在其他设备上同步
    1. 克隆仓库：
      • 新设备安装 Git 和 Obsidian。
      • 运行 git clone https://github.com/你的用户名/Obsidian-Notes.git。
    2. 打开 Vault：
      • 在 Obsidian 中选择 Open folder as vault，指向克隆的文件夹。
    3. 配置插件：
      • 重复步骤四的安装与配置，确保设置一致。
    4. 同步测试：
      • 编辑笔记并等待推送，另一台设备启动时确认是否拉取最新更改。
    步骤六：移动端设置（可选）

    Obsidian Git 在移动端性能有限，但仍可使用。

    1. iOS：
      • 直接安装 Git 插件，配置与桌面端相同。
      • 或使用第三方客户端（如 Working Copy）克隆仓库，在 Obsidian 中打开该文件夹。
    2. Android：
      • 安装 Termux，在其中安装 Git 并克隆仓库。
      • 在 Obsidian 中打开克隆文件夹。
    3. 注意事项：
      • 移动端同步可能较慢，建议仅在桌面端进行复杂操作。
    高级设置（可选）
    1. 使用 SSH 认证：
      • 生成密钥：ssh-keygen -t ed25519 -C "[email protected]"
      • 将公钥添加到 GitHub。Settings > SSH and GPG keys > New SSH key。
      • 更新远程地址：git remote set-url origin [email protected]:你的用户名/Obsidian-Notes.git
    2. 处理冲突：
      • 多设备同时编辑同一文件可能导致冲突。
      • 运行 git pull 查看冲突，手动编辑解决后提交：git add . && git commit -m "Resolve conflict" && git push。
    3. 优化大仓库：
      • 启用插件的 Stage files individually 选项。
      • 定期清理 .gitignore 中的无关文件。
    注意事项
    1. 隐私保护：确保仓库为私有，PAT 不要存储在 Vault 中。
    2. 备份：GitHub 非完整备份方案，建议定期导出 Vault。
    3. 性能问题：文件过多时同步变慢，尽量精简 Vault。
    4. 学习曲线：Git 新手可能需要适应术语，遇到问题查阅官方文档。
    故障排除
    1. 推送失败（401/403 错误）：检查 PAT 是否正确或已过期，确认权限包含 repo 或 Contents。
    2. 插件没有自动提交：确保 Vault backup interval 已设置，检查终端是否有 Git 错误。
    3. 同步冲突：运行 git pull --rebase 尝试自动合并，失败则手动解决。
    4. 移动端卡顿：禁用自动提交，手动触发同步。
    推荐资源
    • Obsidian Git 插件文档：https://github.com/Vinzent03/obsidian-git
    • GitHub 文档：https://docs.github.com/
    • Obsidian 论坛：https://forum.obsidian.md/

    目录

    1. 前置条件
    2. 步骤一：创建 GitHub 私有仓库
    3. 步骤二：生成 GitHub 个人访问令牌（PAT）
    4. 步骤三：初始化本地 Obsidian 仓库
    5. 步骤四：在 Obsidian 中安装和配置 Git 插件
    6. 步骤五：在其他设备上同步
    7. 步骤六：移动端设置（可选）
    8. 高级设置（可选）
    9. 注意事项
    10. 故障排除
    11. 推荐资源
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫，关注极客日志

    微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • Python Wheel (.whl) 文件安装实战指南
    • 飞算 JavaAI 实战：本地化智能分析与代码生成流程
    • LLM 大模型入门项目推荐：多模态与 RAG 实战指南
    • 二分算法：8 道经典题目详解与实战
    • Python UV 工具介绍：Windows 安装方法与基础用法
    • 低代码平台 Microi 吾码的技术架构与集成实践
    • Spring AI 框架核心使用指南
    • 闲置小米 9 打造复古掌机及天马 G 前端配置指南
    • DataRoom 开源大屏设计器：基于 SpringBoot 快速构建数据可视化平台
    • 牛客 CM11：链表分割算法实战
    • C++ 标准库 string 类详解与模拟实现
    • 使用 Docker 部署 Apache Answer 并通过 cpolar 实现公网访问
    • PHP PDO SQL Server 分页 SQL 实现方案
    • 论文解读：Smart Agent-Based Modeling 与 LLM 在模拟中的应用
    • 什么样的人不适合学编程：行业现状与能力评估
    • 18 年政务系统实战：Java 自研框架架构决策复盘
    • 鸿蒙超级终端多设备协同开发
    • LeetCode 27 题：移除元素
    • BeyondCompare 安装与试用期重置配置指南
    • Java 核心基础：深入理解 Spring IoC 容器与依赖注入

    相关免费在线工具

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

    • Markdown转HTML

      将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online

    • HTML转Markdown

      将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online

    • JSON 压缩

      通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online

    • JSON美化和格式化

      将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online