iPad 使用 Obsidian 配合 Git 同步 Gitee 仓库指南
整体思路
在 iPad 上同步已有的 Gitee 仓库需要:
- 安装 Obsidian 和 Git 相关工具
- 克隆远程仓库到 iPad
- 配置 Obsidian Git 插件
- 设置认证信息
第一步:安装必要工具
1. 安装 Obsidian
- 从 App Store 安装 Obsidian
- 打开应用
本文介绍在 iPad 上使用 Obsidian 笔记软件配合 Git 工具将本地知识库同步至 Gitee 远程仓库的完整流程。主要步骤包括:安装 Obsidian 及 Git 客户端(推荐 Working Copy),克隆远程仓库到本地,配置 Obsidian Git 插件实现自动拉取推送,设置 Gitee 个人访问令牌进行认证。文中还涵盖了冲突解决、权限修复及最佳实践建议,帮助用户实现跨设备笔记安全备份与同步。
在 iPad 上同步已有的 Gitee 仓库需要:
# Working Copy 是 iOS 上功能最完整的 Git 客户端
# 1. 从 App Store 安装 "Working Copy"
# 2. 它提供了完整的 Git 命令行环境
# 1. 安装 iSH Shell from App Store
# 2. 在 iSH 中安装 Git:
apk update
apk add git
# 1. 安装 a-Shell from App Store
# 2. 内置了 Git 支持
推荐使用 Working Copy,因为它与 Obsidian 集成最好。
+ → Clone Repository → Enter URL
URL: https://gitee.com/xxx/obsidianws.git
# 如果在 iSH 或 a-Shell 中:
git clone https://gitee.com/xxx/obsidianws.git
通常路径:/private/var/mobile/Containers/.../Working Copy/obsidianws
Obsidian → 设置 → 社区插件 → 浏览
搜索 "Obsidian Git" → 安装并启用
自动拉取:✅ 开启
自动推送:✅ 开启
自动提交:✅ 开启
提交消息:"iPad sync: {{date}}"
自动拉取间隔:30 # 分钟
拉取更新启动时:✅ 开启
在 iSH 或 Working Copy 的终端中:
cd /path/to/your/obsidianws
git config user.name "你的用户名"
git config user.email "你的邮箱@gmail.com"
# 1. 在 Gitee 生成访问令牌
# 设置 → 安全设置 → 私人令牌
# 2. 在 iPad 上配置 Git 使用令牌
git config --global credential.helper store
# 第一次推送时输入用户名和令牌(作为密码)
# 1. 在 Working Copy 中生成 SSH 密钥
# 设置 → SSH 密钥 → 生成新密钥
# 2. 将公钥添加到 Gitee
# 设置 → SSH 公钥 → 添加公钥
# 3. 修改远程地址为 SSH
git remote set-url origin [email protected]:xxx/obsidianws.git
命令面板 (Cmd+P) → 搜索 "Obsidian Git: Pull"
命令面板 → 搜索 "Obsidian Git: Push"
# 在终端中检查 Git 状态
cd /path/to/your/obsidianws
git status
git log --oneline -3
1. **开始工作前**:
- 打开 Obsidian
- 自动或手动执行 `Pull` 获取最新更改
2. **工作期间**:
- 正常编辑笔记
- 自动提交会定期保存更改
3. **结束工作时**:
- 手动执行 `Push` 确保同步到远程
- 或等待自动推送
1. **发现冲突**:
- 状态栏显示冲突图标
- 手动解决冲突文件
2. **解决冲突**:
- 编辑冲突文件
- 使用命令提交解决
3. **完成同步**:
- 推送解决后的版本
设置自动拉取:
配置 URL 回调:
{
"commitMessage": "iPad: {{date}}",
"autoCommit": true,
"autoPull": true,
"autoPush": true,
"autoPullInterval": 30,
"disablePush": false,
"pullBeforePush": true
}
# 确保使用 Working Copy 的终端
# 或者在 iSH 中正确安装 Git
apk update && apk add git
# 重新配置认证
git config --global --unset credential.helper
git config --global credential.helper store
# 或者使用令牌
git push https://username:[email protected]/xxx/obsidianws.git
# 在终端中修复权限
chmod -R 755 /path/to/your/obsidianws
# 拉取最新并合并
git pull origin master
# 或者使用 Working Copy 的图形化冲突解决工具
推荐设置:
- 自动提交间隔:30 分钟
- 自动推送:开启
- 拉取启动时:开启
- 推送前拉取:开启
多重备份:
- Gitee 远程仓库
- Working Copy 本地副本
- iCloud 同步(可选)
1. **开始工作**:先拉取最新更改
2. **重要修改**:手动提交并推送
3. **结束工作**:确认推送成功
4. **定期检查**:查看同步状态

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online