iPad Obsidian Git 同步 Gitee 仓库完整指南
整体思路
在 iPad 上同步已有的 Gitee 仓库需要：
-
**安装 Obsidian 和 Git 相关工具**
-
**克隆远程仓库到 iPad**
-
**配置 Obsidian Git 插件**
-
**设置认证信息**
第一步：安装必要工具
1. **安装 Obsidian**
-
从 App Store 安装 Obsidian
-
打开应用
2. **安装 Git 环境（关键步骤）**
方案一：使用 Working Copy（推荐）
```bash
Working Copy 是 iOS 上功能最完整的 Git 客户端
1. 从 App Store 安装 "Working Copy"
2. 它提供了完整的 Git 命令行环境
```
方案二：使用 iSH Shell
```bash
1. 安装 iSH Shell from App Store
2. 在 iSH 中安装 Git：
apk update
apk add git
```
方案三：使用 a-Shell
```bash
1. 安装 a-Shell from App Store
2. 内置了 Git 支持
```
**推荐使用 Working Copy**，因为它与 Obsidian 集成最好。
第二步：克隆仓库到 iPad
使用 Working Copy 克隆：
-
**打开 Working Copy**
-
**添加远程仓库**：
```
- → Clone Repository → Enter URL
URL: https://gitee.com/xxx/obsidianws.git
```
-
**选择克隆位置**：建议选择 "On My iPad"
-
**完成克隆**
或者使用 HTTPS 克隆：
```bash
如果在 iSH 或 a-Shell 中：
git clone https://gitee.com/xxx/obsidianws.git
```
📁 第三步：在 Obsidian 中打开仓库
方法一：直接打开（推荐）
-
**打开 Obsidian**
-
**打开其他库** → **打开文件夹**
-
**找到 Working Copy 中的仓库路径**：
```
通常路径：/private/var/mobile/Containers/.../Working Copy/obsidianws
```
方法二：通过文件 App 中转
- **在 Working Copy 中导出仓库**：
- 长按仓库 → 导出 → 存储到文件
- **在 Obsidian 中打开导出的文件夹**
⚙️ 第四步：配置 Obsidian Git 插件
1. **安装 Obsidian Git 插件**
```
Obsidian → 设置 → 社区插件 → 浏览
搜索 "Obsidian Git" → 安装并启用
```
2. **配置插件设置**
```yaml
自动拉取: ✅ 开启
自动推送: ✅ 开启
自动提交: ✅ 开启
提交消息: "iPad sync: {{date}}"
自动拉取间隔: 30 # 分钟
拉取更新启动时: ✅ 开启
```
3. **配置 Git 用户信息**
在 iSH 或 Working Copy 的终端中：
```bash
cd /path/to/your/obsidianws
git config user.name "你的用户名"
git config user.email "你的邮箱@gmail.com"
```
第五步：配置认证信息
对于 Gitee 的认证方案：
方案一：使用个人访问令牌（推荐）
```bash
1. 在 Gitee 生成访问令牌
设置 → 安全设置 → 私人令牌
2. 在 iPad 上配置 Git 使用令牌
git config --global credential.helper store
第一次推送时输入用户名和令牌（作为密码）
```
方案二：使用 SSH 密钥（复杂但安全）
```bash
1. 在 Working Copy 中生成 SSH 密钥
设置 → SSH 密钥 → 生成新密钥
2. 将公钥添加到 Gitee
设置 → SSH 公钥 → 添加公钥
3. 修改远程地址为 SSH
git remote set-url origin git@gitee.com:xxx/obsidianws.git
```
第六步：测试同步功能
测试推送：
-
**在 Obsidian 中做一些小修改**
-
**手动触发同步**：
```
命令面板 (Cmd+P) → 搜索 "Obsidian Git: Pull"
命令面板 → 搜索 "Obsidian Git: Push"
```
- **或等待自动同步**
检查状态：
```bash
在终端中检查 Git 状态
cd /path/to/your/obsidianws
git status
git log --oneline -3
```
完整工作流程
日常同步流程：
```markdown
- **开始工作前**：
-
打开 Obsidian
-
自动或手动执行 `Pull` 获取最新更改
- **工作期间**：
-
正常编辑笔记
-
自动提交会定期保存更改
- **结束工作时**：
-
手动执行 `Push` 确保同步到远程
-
或等待自动推送
```
冲突解决流程：
```markdown
- **发现冲突**：
-
状态栏显示冲突图标
-
手动解决冲突文件
- **解决冲突**：
-
编辑冲突文件
-
使用命令提交解决
- **完成同步**：
- 推送解决后的版本
```
🛠️ 针对 iPad 的优化配置
Working Copy 自动化配置：
- **设置自动拉取**：
- Working Copy → 设置 → 自动拉取 → 开启
- **配置 URL 回调**：
-
在 Working Copy 中配置 Obsidian URL 回调
-
实现一键打开仓库
Obsidian Git 插件优化：
```json
{
"commitMessage": "iPad: {{date}}",
"autoCommit": true,
"autoPull": true,
"autoPush": true,
"autoPullInterval": 30,
"disablePush": false,
"pullBeforePush": true
}
```
常见问题解决
问题 1：Git 命令找不到
```bash
确保使用 Working Copy 的终端
或者在 iSH 中正确安装 Git
apk update && apk add git
```
问题 2：认证失败
```bash
重新配置认证
git config --global --unset credential.helper
git config --global credential.helper store
或者使用令牌
git push https://username:token@gitee.com/xxx/obsidianws.git
```
问题 3：文件权限问题
```bash
在终端中修复权限
chmod -R 755 /path/to/your/obsidianws
```
问题 4：同步冲突
```bash
拉取最新并合并
git pull origin master
或者使用 Working Copy 的图形化冲突解决工具
```
💡 最佳实践建议
同步策略：
```yaml
推荐设置:
-
自动提交间隔: 30分钟
-
自动推送: 开启
-
拉取启动时: 开启
-
推送前拉取: 开启
```
备份策略：
```yaml
多重备份:
-
Gitee 远程仓库
-
Working Copy 本地副本
-
iCloud 同步（可选）
```
工作习惯：
```markdown
-
**开始工作**：先拉取最新更改
-
**重要修改**：手动提交并推送
-
**结束工作**：确认推送成功
-
**定期检查**：查看同步状态
```
🎯 快速开始清单
-
\] 安装 Obsidian
-
\] 在 Working Copy 中克隆仓库
-
\] 安装配置 Obsidian Git 插件
-
\] 配置认证（令牌或 SSH）