Obsidian电脑+手机端同步（github+MGit）

qq_62954268

已于 2025-03-15 11:36:53 修改

阅读量5.2k

点赞数 52

分类专栏： obsidian 文章标签：编辑器 github

于 2024-02-05 20:55:03 首次发布

本文链接：https://blog.csdn.net/qq_62954268/article/details/136047744

版权

obsidian 专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍了如何在华为HarmonyOS手机和Windows电脑之间使用Obsidian和Git进行版本控制和文件同步，包括安装MGit、设置SSH密钥、上传至GitHub及在手机端同步的操作步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

系统和软件版本

名称	版本
Obsidian	1.5.3
华为HarmonyOS	4.0.0
Git	2.43.0-64-bit
MGit	1.7.0(手机端)
F-Droid	apk(手机端)

安装F-Droid是因为我的手机是HarmonyOS系统，没有谷歌框架，无法通过google play安装MGit，所以下载F-Droid来安装MGit. F-Droid换源链接：https://help.mirrors.cernet.edu.cn/fdroid/

软件安装包

obsidian下载链接：https://forum-zh.obsidian.md/
git下载链接：https://git-scm.com/downloads/win，或者联想应用商店（速度快）
F-Droid下载链接：https://mirrors.tuna.tsinghua.edu.cn/fdroid/archive/org.fdroid.fdroid_1019052.apk
F-Droid换源：https://mirrors.tuna.tsinghua.edu.cn/help/fdroid/（换源后下载MGit速度快）
MGit下载：从F-Droid里面搜索下载

电脑端准备和操作

下载安装Obsidian

到官网或者Obsidian的中文论坛下载安装包，安装完成在本地新建一个仓库，我这里的仓库名字是obsidian，后续以这个仓库为例进行说明。

默认的插件市场是需要VPN的，如果有插件的需要可以用pkmer这个插件市场下载插件，这个不需要VPN

pkmer链接: PKMer

安装git

安装包可以去官网下载或者使用我上面给的链接

安装好后要找到这个应用，一会儿要用到

使用github

首先要注册一个github账号，记住自己的用户名和注册时使用的邮箱，这个注册的教程网上可以查阅，这里就不写了。

点击右上角的头像->再点击Settings，在这里可以看到和找到自己的用户名和邮箱。

使用git将本地仓库`obsidian`上传到github中

我这里只给出这个过程要用到的命令，如果需要了解git如何使用可以学习廖雪峰老师的教程

git教程（廖雪峰）：Git教程 - 廖雪峰的官方网站 (liaoxuefeng.com)

✨开始之前：

将本地仓库上传到github中需要进行身份认证，过程如下：

指定用户名和Email地址
在本地用命令行生成一对密钥（包括公钥和私钥）
将生成的公钥用记事本打开，复制后粘贴到github中存放公钥的地方

指定用户名和Email地址：

首先打开git bash, 然后进行命令行操作

$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

生成一对密钥：

$ ssh-keygen -t rsa -C "youremail@example.com"

你需要把邮件地址换成你自己的邮件地址，然后一路回车，使用默认值即可，由于这个Key也不是用于军事目的，所以也无需设置密码。

如果一切顺利的话，可以在用户主目录里找到.ssh目录，里面有id_rsa和id_rsa.pub两个文件，这两个就是SSH Key的秘钥对，id_rsa是私钥，不能泄露出去，id_rsa.pub是公钥，可以放心地告诉任何人。

将公钥id_rsa.pub用记事本打开，复制后粘贴到github中存放公钥的地方：

点击NEW SSH KEY进行粘贴

✨现在在github上创建一个仓库，用来存放我们要上传的文件：

点击右上角的+号->选择New repository

我这里的仓库名字是obsidian和本地仓库名相同，属性选择私有，点击Create repository

注意：这里除了这两个地方需要改动，不要动其他的选项

✨初始化本地仓库：

通过git init命令把这个目录变成Git可以管理的仓库

进入到刚刚创建的本地仓库obsidian

$ cd e:\obsidian

一定要进入obsidian仓库里面，再执行初始化命令

初始化obsidian仓库

$ git init

通过git init命令把这个目录变成Git可以管理的仓库.

✨将本地的obsidian仓库与github上的obsidian仓库进行关联：

$ git remote add origin git@github.com:你的用户名/仓库名.git

你的用户名是自己的github用户名，仓库名是刚刚在github上创建的仓库名字。
例子：
在这里插入图片描述

git remote add origin git@github.com:OrangeSunrise/A_ObsidianJianhui.git

✨将本地仓库的内容推送到GitHub仓库

在推送之前，我们需要先做一个提交申请，这是由于git的工作机理要求。具体可以参看git教程。

这里先创建一个txt格式文件，用记事本创建，并写入内容Here are my obsidian notes.

保存为叫readmetxt的txt格式文件。

添加文件到Git仓库，分两步：（这里要在obsidian本地仓库中进行）

第一步

$ git add readmetxt.txt

第二步

$ git commit -m "add files."

"add files."这个代表一个提交说明，可自定义，但要用引号。

将本地仓库的内容推送到GitHub仓库：

$ git push -u origin main

由于远程库是空的，我们第一次推送main分支时，加上了-u参数，Git不但会把本地的main分支内容推送的远程新的main分支，还会把本地的main分支和远程的main分支关联起来，在以后的推送或者拉取时就可以简化命令。

如果报错的信息如下：
在这里插入图片描述
这是由于将本地的obsidian仓库与github上的obsidian仓库进行关联这个步骤出现了问题，解决方法如下：

问题原因
你的 Git 远程仓库地址（Remote URL）配置错误，orangesunrise不是一个有效的主机名（如 GitHub 的正确主机名是 github.com）。需要将 URL 修正为 Git 服务商（如 GitHub、GitLab 等）提供的正确地址。

解决方法
1. 检查当前远程仓库地址
git remote -v
如果输出结果中的 URL 包含 orangesunrise（如 ssh://orangesunrise/... 或 git@orangesunrise:...），说明配置错误。
2. 修改为正确的远程仓库地址
如果是 GitHub，使用以下命令修正（替换 你的用户名 和 仓库名）：
SSH 协议（需要配置 SSH 密钥）：
git remote set-url origin git@github.com:你的用户名/仓库名.git
3. 验证 SSH 连接（仅限 SSH 协议）
如果使用 SSH 协议，需确保已配置密钥：
ssh -T git@github.com
若提示 You've successfully authenticated 表示连接成功。
若失败，需生成并添加 SSH 密钥。
4. 重新推送代码
git push -u origin main

这里你可能会遇到下面说的问题：