基于Git实现跨系统、多设备的Obsidian Vault同步（免费、高效、稳定）

已于 2024-11-12 17:27:39 修改
阅读量1.8k 收藏 20
点赞数 30
CC 4.0 BY-SA版权
文章标签： git github ubuntu
于 2024-11-12 17:20:10 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/Raphaeloyal/article/details/143718531

基于Git实现跨系统、多设备的Obsidian Vault同步（免费、高效、稳定）

文章目录

一、Motivation

研一rookie，使用Obsidian来管理包含日报、论文、阅读笔记等在内的工作流，希望在自己的笔记本和实验室的办公电脑上同步自己的Vault，获得随时可记、随处可读、设置一致的流畅体验。

二、基本情况

  • 笔记本电脑：Dell G3 ＋ Windows 10 Version 22H2
  • 实验室电脑：Intel NUC ＋ Ubuntu 20.04.6LTS
    在这里插入图片描述

注意：在Ubuntu下应使用Appimage的方式安装Obsidian，这是Obsidian-Git插件全面支持且推荐的安装方式

三、实现思路

  1. 使用Git进行版本控制
  2. 将Vault托管到远程仓库（如Github、Gitee等），通过跟踪（add）新文件、推送（push）修改和拉取（pull）更新等操作实现各设备间的同步
  3. 使用集成在Obsidian内的第三方插件’Git’实现便捷的自动备份等进阶的功能

四、操作步骤

以原设备为Windows设备，将Vault克隆到Ubuntu上并实现两设备的日常同步为例

（1）安装Git

a.在Windows上安装
方法一

从Git的官方网站下载最新的官方版本
在这里插入图片描述

方法二

习惯使用winget的朋友也可以在命令行或Powershell中输入如下代码来安装Git：
winget install --id Git.Git -e --source winget

b.在Ubuntu上安装

打开终端（Ctrl+Alt+T），输入如下代码：
$ sudo apt install git-all

（2）用Git对现有Vault进行版本控制

如果你是初次使用Git，需要配置用户基本信息，这不是本文主要讨论的内容，请参阅参考资料1。

  1. 在需要进行版本控制的文件夹单击右键打开Git Bash在这里插入图片描述
    在这里插试一下入图片描述

  2. 初始化Git仓库
    $ git init
    该命令将创建一个名为 .git 的子目录，这个子目录含有你初始化的 Git 仓库中所有的必须文件，这些文件是Git 仓库的骨干。 但在这个时候仅做了一个初始化的操作，项目里的文件还没有被跟踪。通过 git add 命令来指定所需的文件来进行追踪。然后执行git commit操作。

$ git add YOUR_FILE
$ git add YOUR_DIRECTORY/
$ git commit -m 'initial project version'

此时使用$ git status命令查看，会发现所有已跟踪文件在上次提交后都未被更改。现在可以将commit后的仓库推送至远程了。
在这里插入图片描述

（3）将本地项目提交至远程仓库

a.以Github为例创建远程仓库
  1. 点击页面右上角↗的➕选择“New repository”
    在这里插入图片描述
  2. 为自己的远程仓库填写一个名字，设置权限为私有（如果你不想让人人都可以共享你的仓库的话），最后点击右下角的创建即可。
    在这里插入图片描述
b.在本地添加远程仓库
  1. 获取远程仓库的链接
    在这里插入图片描述
  2. 在Git Bash中运行：
git remote add <shortname> <url>

其中shortname是你自己给远程仓库起的简洁的别名，url是你远程仓库的链接
然后运行$ git remote -v可以看到远程仓库添加成功
在这里插入图片描述

c.提交至远程仓库

我给远程仓库的别名是origin，我在远程仓库的默认分支是master，则我可以在Git Bash中运行如下代码来完成推送：

$ git push origin master

运行后会弹出身份验证，可以通过浏览器进行授权（可以使用移动端的Github，也可以使用账号密码认证，跟着提示做就好），也可以通过生成的Personal access token认证（后文会提到）
推送成功会有如下类似的显示：
在这里插入图片描述

（4）使用Obsidian中的Git插件来便捷操作

前述操作已经成功实现了远端同步，但并不简洁方便，使用插件来将Git的操作集成在Obsidian里

  1. 关闭安全模式，在第三方插件市场中搜索“Git"（作者为Vinzent)，安装并启用。
    在这里插入图片描述
  2. 重启Obsidian后，打开已经初始化为Git仓库的Vault，插件会自动识别并询问你是否链接到该仓库，选择是。（操作快捷简单以至于甚至没来得及截图）
  3. 在侧边栏打开”Git source control“，可以清晰、方便地进行版本控制了，比如现在：
  • 检查到如下更新（Changes)，点击➕，将所有变更都Stage
    在这里插入图片描述
  • 如果确认这些变更都没问题，都是你想要的，可以点击√将其全部Commit
    在这里插入图片描述
  • 最后点击Push将所有经过Commit的变更都推送到远程仓库
    在这里插入图片描述
  • 推送成功！
    在这里插入图片描述

（5）在其他设备克隆远程仓库

  1. 下载Obsidian（如果是在Linux系统上，一定要选择Appimage的安装方式！），安装好Git插件
  2. 生成Personal access tokens (classic)
  • 设置->最左下方的开发者设置->Personal access tokens (classic)
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述
  • 一定要记下这串Token，因其只显示一次
    在这里插入图片描述
  1. 打开Obsidian，使用Ctrl+P打开命令菜单，搜索并选择”Git:clone an existing remote repo“
    在这里插入图片描述
    按如下方法组合你的Token和url：
    在url的https://后插入你的Token＋@
    形如：https://ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX@github.com/YOUR_USERNAME/YOUR_PROJECT.git
  2. 按提示选择克隆的目标文件夹
  3. 静待克隆，直到出现克隆完成，重新启动的提示
    在这里插入图片描述
  4. 重启Obsidian，享受丝滑的同步体验！

五、参考资料

  1. Pro Git官方指南，简洁清晰，可免费下载或在线阅读，有简体中文版
  2. The Easiest Way to Connect Your Obsidian Vault with Github | Linked Blog Starter
  3. The Easiest Way to Setup Obsidian Git (4 Minutes)
_以北
关注
用git使obsidian多端笔记互联/同步保存笔记（基于gitee）
m0_56544579的博客
10-26 5818
最近一直使用obsidian来记笔记，有的时候用台式，有的时候用笔记本。最近研究了一些obsidian的同步方法，觉得最方便的就是使用git去管理obsidian，下面来进行详细的介绍，纯保姆级教程，新手小白用刚买回来的电脑也可配置成功。
【Obsidian笔记】使用Obsidian Git插件实现gitee平台自动同步_新手向
qq_62090093的博客
06-04 8927
记录利用Obsidian Git插件来实现Gitee 自动同步Obisidian笔记的过程以及在此过程中遇到的一些问题和解决方法。
Obsidian使用Git同步
weixin_47711503的博客
04-09 2488
在Obsidian仓库根目录右键单击执行。
Obsidian-Git插件核心功能详解：版本控制与自动化同步
最新发布
gitblog_00154的博客
06-05 381
Obsidian-Git插件核心功能详解：版本控制与自动化同步 概述 Obsidian-Git是一款为知识管理工具Obsidian设计的Git版本控制插件，它将专业开发者熟悉的Git工作流无缝集成到笔记应用中。本文将深入解析该插件的核心功能模块，帮助用户高效管理知识库的版本历史。 源码控制视图 源码控制视图是该插件的核心交互界面，相当于图形化的git status命令。通过"打开源码控制...
obsidian-git:使用git备份您的Obsidian.md保管库
03-19
黑曜石吉特 一个简单的插件，可让您将保管库备份到远程git存储库（例如GitHub上的私人存储库）。该插件假定您已经在本地初始化了现有的git存储库，并且已设置凭据。 关于使用git备份保险库的好处，我建议阅读这篇。您也可以在git储存库设置上找到“操作方法”，此插件未提供初始化git储存库的接口（尚未）。 与移动降价笔记应用程序协同效果很好。 如何使用 要求 初始化的git仓库 凭证已建立 远程仓库 上游/跟踪分支（运行git push push。Git应提示您一个命令） 至少一个推送的提交 特征 每X分钟自动进行保管库备份 在Obsidian启动时从远程存储库中提取更改 分配用于将更改拉入/推送到远程存储库的热键 注意：由于git历史记录中的潜在噪音，建议从存储库（甚至整个.obsidian目录）中排除黑曜石工作空间缓存文件。 如果您想这样做，请滚动至底部以获取简短指南。 兼容性 自定
手机端使用obsidian+第三方工具通过git同步笔记到github
neverSaynever_的博客
08-01 5278
因为笔者起初使用的是ssh 方式克隆到的本地，结果发现配置好obsidian git插件，自动推送和拉取代码后，报错UnknowTransportError: uses an unrecognized transport protocol: ssh。1）打开刚刚安装的Termux，输入下面的命令请求获取存储访问权限，此时弹窗一个请求访问存储权限的弹窗，找到Termux 应用，打开访问权限。下次操作时无需再次输入。1）安装obsidian-git插件，配置方式和PC端基本一致，需要注意的是。
Obsidian的Git插件设置配置全流程 -- 简单的电脑端多平台同步方案及常见问题
weixin_44370439的博客
11-06 7453
Git同步obsidian的保姆级教程和常见问题
通过Git同步Obsidian与IOS
测试游记
08-26 8100
Obsidian介绍下载地址：https://obsidian.md/Obsidian人脑是非线性的：我们一直在从一个想法跳到另一个想法。而Obsidian可以轻松的将知识进行网络化创建g...
obsidian在安卓终端使用git进行同步
KIIOU的博客
10-12 867
【代码】obsidian在安卓终端使用git进行同步。
obsidian-vault-template
05-08
rm -rf obsidian-vault-template/.git 然后将上面克隆的存储库作为黑曜石库打开 转到设置>社区插件，然后禁用“安全模式” 单击“社区插件”旁边的“浏览”，搜索并安装以下内容： 日历 资料检视 日程安排者 模板...
obsidian 多设备文件同步配置
03-22
Obsidian 是一款功能强大的笔记应用，支持通过多种方式实现多设备之间的文件同步。以下是几种常见的同步方案及其具体实施方法： #### 使用第三方云存储服务 许多用户倾向于利用现有的云存储解决方案来完成 Obsidian...
Obsidian-Vault-Template:现成的黑曜石库模板。上手即用Obsidian合并模板
03-09
黑曜石库模板 上手即用Obsidian合并模板 现成的黑曜石库模板。 使用方法 安装 Clone仓库到本地，把知识库文件夹放到合适的位置，如icloud中 ：知识库，知识库打开会提示安全模式，以便使用第三方插件，点击关闭安全模式 ：设置-第三方插件，打开已安装的第三方插件， Citations不用替换，不用zotero的可以直接删除掉 点击顶部边栏的管理工作区布局，加载布局 每日工作使用方法 不要修改日记插件的命名格式 每次从日历处点击新建日记（每日工作） 任务标签下的所有未完成任务会自动转移到新建每日工作中 新建后可以用前端边栏按钮快速打开 任务标签放置所有任务，正在做标签下的任务从任务中复制过来 模板可自行修改
如何在Windows与iOS之间同步Obsidian：一站式解决方案
2302_81141145的博客
12-14 2691
使用 Obsidian 官方同步（Obsidian Sync）是最简便的解决方案，但需要付费，适合需要高效同步的用户。对于iOS和Windows用户来说，使用iCloud 同步是一个免费的解决方案，但需要注意：国内 iCloud 版本的同步速度较慢，需要回退至14.1版本来确保稳定。配置好 iCloud 后，同步速度会非常快，适合日常使用。如果遇到同步问题，尤其是 " 同步被挂起 " 的情况，可以通过回退 iCloud 版本来解决。
【每周一个小技能】Obsidian配合Git实现笔记自动同步
Together
02-21 9639
一、码云创建私有库 二、关闭安全模式，安装 Ob Git 三、设置自动同步时间，单位为 分钟
【干货】使用 Obsidian 的 Git 插件将你的笔记同步到 GitHub 私有仓库
vortex5的博客
04-16 3005
Obsidian Git 在移动端的性能较差（由于使用 JavaScript 实现的 isomorphic-git），但仍可使用。通过以上步骤，你应该能够成功将 Obsidian Vault 同步到 GitHub 私有仓库，实现跨设备无缝同步和版本控制。GitHub 不再支持密码认证，因此需要 PAT 来进行身份验证。
Obsidian +Obsidian Git插件 + Gitee 自动同步笔记
weixin_55688821的博客
10-15 4224
然后再打开你的Obsidian，在Obsidian Git中设置你的提交模板和自动提交时间就好了。没有文字的那个是自动备份时间，自动备份时间和自动提交时间最好保持一样。然后在插件市场里面搜索并下载Obsidian Git 这个插件。可能会出现这个，要求你输入gitee的账号和密码。然后去你的Obsidian仓库文件夹里面。然后obsidian显示push的情况。然后在你的Gitee中，新建一个仓库。创建git文件 需要下载git。在你的obsidian仓库下。回到gitee仓库，可以看到。
无需其他软件，直接用git插件实现obsidian+git同步
mazamu的博客
03-04 926
第二步：clone远程仓库(https://xxx.git链接）第三步：选择远程仓库无.obsidian文件。第一步：init仓库。一直默认确定就可以了。
obsidian 使用 git 进行多终端同步
antsmall的专栏
05-11 1735
使用印象笔记（evernote 的中国版）已经好多年了，对它的持续可用性一直不放心，所以会定期手动对日志做备份。但最近我厌倦这么做了，于是打算试一下这两位老师提到的 obsidian，阮一峰：《最适合程序员的笔记软件》[1]，老C：《周刊（第18期）：网状的思考，线性的写作》[2]。
将Obsidian笔记同步至git
Sloent的博客
12-20 1193
补充：以下设置可以在提交时自动地把回车（CR）和换行（LF）转换成换行（LF），而在检出代码时把换行（LF）转换成回车（CR）和换行（LF）开启 commit and push，设置commint pull push等对应时间，设置后重启生效。1. 首先在git创建新的仓库，复制url后在git bash进行克隆（此步会得到一个空的文件夹。4. 第一次push要用以下命令，后面直接git push即可。下载Obsidian Git插件。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值