在 Ubuntu 上设置 Obsidian 并通过 Git 与 Android 同步（逐步指南）

I’m happy to translate the article for you, but I’ll need the full text of the post (the content after the source line) in order to do so. Could you please paste the article’s body here? Once I have that, I’ll provide a Simplified Chinese translation while preserving the original formatting, markdown, and code blocks.

为什么选择 Obsidian + Git？

• 基于 Markdown，面向未来的笔记
• 完整的版本历史（不同于云同步工具）
• 私有仓库 = 对数据的完全控制
• 跨 Linux、Windows 和 Android 工作

第一步：在 Ubuntu 上安装 Obsidian

从官方站点下载 .deb 包：
https://obsidian.md/download

使用 gdebi 安装（它会自动解决依赖）：

sudo apt-get update
sudo apt-get install gdebi

使用 GDebi 包安装器 打开下载的 .deb 文件并安装 Obsidian。

第2步：创建私有 GitHub 仓库

1. 前往 GitHub 并创建一个 新仓库。
2. 将其设置为 私有。
3. 不要 用 README 初始化（Obsidian 将会填充它）。

第3步：使用 SSH 克隆仓库（桌面）

cd ~/Documents
git clone git@github.com:DasDNS/Obsidian_Notes.git

你应该会看到类似以下的输出：

Cloning into 'Obsidian_Notes'...
Receiving objects: 100% (4/4), done.

验证远程仓库：

cd Obsidian_Notes
git remote -v

输出：

origin  git@github.com:DasDNS/Obsidian_Notes.git (fetch)
origin  git@github.com:DasDNS/Obsidian_Notes.git (push)

第4步：在 Obsidian 中打开 Vault（Ubuntu）

1. 打开 Obsidian。
2. 点击 Open folder as vault。
3. 选择 Obsidian_Notes。
4. 开始创建笔记。

第5步：安装并配置 Obsidian Git 插件（桌面版）

1. 前往 Settings → Community Plugins。
2. 禁用安全模式。
3. 安装 Obsidian Git 并启用该插件。

推荐设置

• 定时自动提交
• 启动时自动拉取
• （可选）提交信息模板

你的笔记现在会自动提交并同步。

Step 6: 为什么 Android 需要 HTTPS（Important）

• Obsidian Git 在 Android 上 不 支持 SSH。
• 它 支持 使用个人访问令牌 (PAT) 的 HTTPS。

我们在桌面上保留 SSH，并为 Android 创建一个兼容 HTTPS 的库副本。

第 7 步：创建 HTTPS 兼容的副本（桌面）

复制仓库：

cp -r ~/Documents/Obsidian_Notes ~/Documents/Obsidian_Notes_HTTPS
cd ~/Documents/Obsidian_Notes_HTTPS

将远程地址从 SSH 改为 HTTPS：

git remote set-url origin https://github.com/DasDNS/Obsidian_Notes.git

验证：

git remote -v

输出：

origin  https://github.com/DasDNS/Obsidian_Notes.git (fetch)
origin  https://github.com/DasDNS/Obsidian_Notes.git (push)

现在该仓库已兼容 Android。

第8步：将 Vault 复制到 Android

1. 通过 USB 连接手机并启用 文件传输 (MTP)。
2. 复制 整个文件夹，包括：
   • .git/
   • .obsidian/
   • 所有 markdown 文件

推荐的设备存放位置：

Internal Storage / Obsidian

注意： 复制整个文件夹，而不是仅复制其内容。

第9步：在 Android 上安装 Obsidian

• 从 Play 商店安装 Obsidian。
• 打开应用并选择 Open existing folder。
• 选择已复制的 Obsidian 文件夹。

第10步：在 Android 上进行 Git 同步（需要访问令牌）

1. 前往 Settings → Community Plugins 并启用 Obsidian Git。
2. 打开 Command Palette，运行 Obsidian Git: Pull。

系统会提示输入：

• Username → 你的 GitHub 用户名
• Password → Personal Access Token (PAT)

SSH 密钥在 Android 上 不可 使用；必须使用令牌。

输入令牌后，Obsidian Git 将拉取更新、提交更改并推送回 GitHub。

• Ubuntu → SSH Git（安全且快速）
• Android → HTTPS Git（基于令牌）
• 同一私有仓库
• 完整的版本历史
• 离线优先的笔记

最后思考

• 完全控制您的数据
• 无需付费同步服务
• 一个可从学生笔记扩展到研究档案的工作流

如果您对长期笔记记录很认真，Obsidian + Git 值得投入努力。

参考文献

• Obsidian + GitLab Setup (Andrew Wegner) – 一个详细的演练，为桌面 Git 步骤提供了参考。
• Obsidian Android Syncing via GitHub (Reddit) – 社区讨论了在 Android 上使用 GitHub 和个人访问令牌同步 Obsidian 的方法。