# Obsidian 双机同步与备份方案

> 记录时间：2026-08-18
> 适用范围：MacBook Air（本机，配置标准机）+ Mac mini（10.10.10.21）

## 一、架构总览

两台机器跑两套同步系统，并行不冲突：

- **LiveSync** — 笔记实时同步，两台机器连同一个 CouchDB 数据库
- **Git 备份** — 全库备份到 Gogs 私有仓库，两台机器各自独立自动提交

## 二、LiveSync 配置

- 两台机器使用**同一个 CouchDB 数据库**（配置文件 md5 完全一致）
- 连接配置加密存储（配置名 legacy-couchdb，看不到明文地址）
- 数据库名后缀：806fd73e7e83a3b0
- 模式：实时同步（liveSync: true），后台常驻
- 同步排除：`.git`、`node_modules`、`obsidian-livesync` 自身 → git 仓库不会被 LiveSync 动
- E2E 加密：未开启
- 冲突策略：新文件覆盖旧文件

## 三、Git 备份配置

- 服务器：princess（84.235.240.199）上的 Gogs，SSH 端口 **2222**
- 仓库地址：`ssh://git@84.235.240.199:2222/zhensolid/obsidian`（master 分支）
- 插件：obsidian-git，每 10 分钟自动 pull → commit → push
- 提交信息格式：`vault backup: {{date}}`
- Git 身份：zhensolid / zhensolid@vip.qq.com
- Gogs 上的 SSH 密钥（2 把，均属 zhensolid 账号）：
  - `hermes-mac` → MacBook Air（2026-06-15 添加）
  - `mac` → Mac mini（密钥注释 obsidian-vault-backup，2026-08-18 添加）

## 四、原则

- **以本机（MacBook Air）配置为准**，mini 对齐本机
- LiveSync 管笔记内容，git 管全库备份，各机器独立、互不干扰

## 五、已知坑（重要）

1. 仓库地址**必须带 git@** —— 不带会用本机用户名去认证，直接 Permission denied
2. 家宽到 Gogs 的国际链路慢（全量拉取几十 KB/s），日常增量同步无感
3. git init / 插件重新初始化会清空 refs，恢复方法：
   ```bash
   git fetch origin
   git reset --mixed origin/master
   git branch --set-upstream-to=origin/master master
   ```
4. 对象缺失（fsck 报 missing）的快速修复：从另一台完整机器打 bundle 走局域网：
   ```bash
   # 完整机器上
   git bundle create /tmp/full.bundle origin/master
   # 传到损坏机器后
   git bundle unbundle /tmp/full.bundle
   ```
5. 两台机器同时编辑同一笔记会冲突，先 pull 再写
6. Mac mini 重置插件后恢复方式：`git checkout -- .`（以本机提交的版本为准，能恢复全部插件）

## 六、2026-08-18 故障修复记录

- **现象**：两机 git 仓库被重置（master 分支消失、1400+ 文件被当作新文件暂存）
- **原因**：重置过程中 git init / 插件重新初始化（非 LiveSync，LiveSync 已排除 .git）
- **修复过程**：
  1. 确认 Gogs 服务器仓库完好（权威源）
  2. MacBook Air：fetch 拉回历史 → reset 重建 master → 7 个丢失文件恢复（2 个对象直接从服务器提取）
  3. Mac mini：续传 fetch → 接上 origin/master → 打 bundle 走局域网传回 MBA 补齐缺失对象
  4. mini 上 `git checkout -- .` 对齐远端，恢复 13 个插件目录
- **结果**：两机 git 仓库完整同步，LiveSync 同库同步，全部恢复正常