· Jeff · 教程 · 5 分钟阅读
Obsidian Git 三方同步手册
从零开始，搭建个人知识库
Obsidian + Git + 云端服务器 三方同步部署手册
来源：AtomCollide AI 实验室 · 飞书文档 版本：v2.2（2026-06-05）聚合权威版 贡献者：PR v2.1 + jkl 评审 + 陈宇锋 评审 链接：https://vcnvmnln7wit.feishu.cn/wiki/MQvjwAAp4iuc1Dk6tIacSlrxntc
一、架构说明
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ 本地电脑 │ ←→ │ Git平台 │ ←→ │ 云端服务器 │ │ (Obsidian) │ │ (私有仓库) │ │ (Linux) │ └─────────────┘ └─────────────┘ └─────────────┘ ↑ ↑ ↑ Git插件自动同步 中央存储仓库 定时同步脚本 (每5分钟pull/push) (24小时运行) (每5分钟git pull)同步流程：
- 本地 → Git：Obsidian Git 插件自动 push（每 5 分钟）
- Git → 服务器：定时同步脚本自动 pull（每 5 分钟）
- 服务器 → Git：AI 写入后自动 push（秒级）
- Git → 本地：Obsidian Git 插件自动 pull（每 5 分钟）
二、核心改进（v2.0 → v2.2）
维度 v2.0 原版 v2.2 改进版 小白 5 分钟成功率 50% 100% 数据丢失风险 高（—theirs 静默吃修改） 零（策略可配置 + 飞书告警） 凭证安全 永久明文 5 分钟缓存 / systemd-creds AI 同步延迟 5+ 分钟（等 cron） 秒级（写入即推） 文档一致性 分叉打架 唯一权威版本 隐私安全 冲突目录裸奔 月度自检 + 脱敏提醒 冲突预防 无架构 目录级隔离（90% 消除） 反向流程 手动 5 步拆解 一键脚本 同步可观测性 离线时黑盒 心跳 + 飞书 + 元数据 三、冲突策略配置（核心架构）
.sync-policy.json按目录配置冲突解决方式：策略 行为 适用场景 manual暂停同步，stash 本地修改，发飞书告警 核心知识、治理规则 ours以本地为准，保留服务器/AI 的修改 AI 工作区、同步元数据 theirs以远端为准，本地修改备份到 .conflict_backup/外部资源、归档文件 四、AI 写入权限矩阵
目录 AI 可写 人工可写 冲突策略 00-Foundations/❌ 否 ✅ 唯一 manual 01-Active/✅ 主要 ✅ 协作 ours 02-Archive/✅ 自动 ⚠️ 谨慎 theirs 03-External/Inbox/✅ 写入 ❌ 不写 theirs 03-External/references/✅ 自动 ⚠️ 校对 theirs 04-Governance/❌ 否 ✅ 唯一 manual 05-Sync/✅ 自动 ❌ 不写 ours _templates/❌ 否 ✅ 唯一 manual AGENTS.md⚠️ 提议 ✅ 拍板 manual 五、推荐目录结构
obsidian-vault/ ├── 00-Foundations/ # 基础层（冷记忆）— 人工专属 │ ├── who-we-are.md │ ├── tech-standards.md │ └── anti-patterns.md ├── 01-Active/ # 活跃层（热记忆）— AI + 人工协作 │ ├── index.md # Dataview 索引 + 健康度面板 │ ├── projects/ │ └── operations/ ├── 02-Archive/ # 归档层 — AI 自动归档 ├── 03-External/ # 外部资源 — AI 写入 │ ├── Inbox/ │ └── references/ ├── 04-Governance/ # 治理层 — 人工专属 ├── 05-Sync/ # 同步元数据 │ ├── sync-status.json │ └── conflict-log.md ├── _templates/ ├── AGENTS.md # AI 行为契约 ├── .sync-policy.json # 冲突策略配置 └── README.md六、AGENTS.md 写入铁律
AI 写入白名单：
01-Active/、02-Archive/、03-External/、05-Sync/AI 写入黑名单（需明确授权）：00-Foundations/、04-Governance/、_templates/AI 每次写完笔记后立即：
git add . && git commit -m "ai: ${TOPIC}" && git push origin master七、安全要点
- 仓库必须私有
- 服务器端凭证使用
git config credential.helper 'cache --timeout=300'（5 分钟内存缓存） - 严禁
git config credential.helper store（明文存储 token） .gitignore包含.obsidian/workspace*.json、.obsidian/plugins/*/data.json、.conflict_backup/- 月度脱敏自检：
grep -rE "(password|api_key|secret|token)" .conflict_backup/
八、改进点优先级（12 项）
改进 严重度 说明 P0-1 用户名替换陷阱 🔴 必修 用 $(whoami)变量替代硬编码路径P0-2 冲突策略可配置 🔴 必修 .sync-policy.json按目录配置P0-3 凭证安全 🔴 必修 cache --timeout=300替代storeP0-4 AI 写完不 push 🔴 必修 写入即推，不等 cron P1-1 文档分叉 🟡 建议 唯一权威版本 P1-2 隐私泄漏 🟡 建议 .gitignore + 脱敏自检 P1-3 目录级隔离 🟡 建议 写入权限矩阵 P1-4 一键卸载 🟡 建议 反向流程脚本 P2-1 自愈+告警 🟢 锦上添花 连续失败检测 + 飞书告警 P2-2 同步元数据 🟢 锦上添花 05-Sync/ 目录 P2-3 git stash 优化 🟢 锦上添花 避免空条目累积 P2-4 冷记忆刷新 🟢 锦上添花 新会话重读基础文件
Share:
☕ 如果这篇文章对你有帮助
欢迎请 Jeff 喝杯咖啡，支持我持续分享更多软件技巧～
打赏功能即将上线，先点个赞也是支持 ❤️
