Obsidian 多设备同步配置指南

Obsidian 多设备同步配置指南电脑端 Git 插件 手机端 GSync本指南将帮助你实现电脑端使用 Obsidian Git 插件与手机端使用 GitSync 等工具的笔记同步确保数据安全、版本可控。一、电脑端配置使用 Obsidian Git 插件1. 安装 GitWindows访问 https://git-scm.com/download/win 下载安装包默认设置安装即可。macOS可通过 Homebrew (brew install git) 或从官网下载安装。Linux使用包管理器安装如sudo apt install git。2. 创建远程 Git 仓库推荐平台国内用户建议使用Gitee码云访问速度快国际用户可使用GitHub。操作步骤注册并登录 Gitee/GitHub。点击“新建仓库”名称如my-obsidian选择“私有”仓库。不要勾选“初始化仓库”直接创建。3. 生成访问令牌Token在 Gitee/GitHub 的“设置”→“私人令牌”中生成新令牌。备注填写“Obsidian 同步”勾选projects等必要权限。立即复制并保存令牌关闭页面后无法查看。4. 本地 Obsidian 仓库初始化打开 Obsidian进入你的笔记库Vault根目录。打开终端/命令行执行以下命令gitinitgitremoteaddorigin https://gitee.com/你的用户名/仓库名.gitgitadd.gitcommit-minit vaultgitpush-uorigin main5. 安装并配置 Obsidian Git 插件在 Obsidian 中设置 → 第三方插件 → 浏览 → 搜索“Git” → 安装并启用。进入插件设置关键配置如下设置项建议值说明Auto pull interval10分钟每10分钟自动拉取远程更新Auto commit-and-sync interval10分钟每10分钟自动提交并推送Commit messagevault backup:{{date}}自动提交信息带时间戳Pull updates on startup开启启动时先拉取最新内容Push on backup开启自动提交后立即推送Authentication/Commit Author填写你的 Gitee/GitHub 用户名和邮箱用于身份验证Personal access token粘贴之前复制的令牌确保推送权限创建.gitignore文件可选但推荐排除不需要同步的文件.obsidian/workspace.json .obsidian/.trash/ .DS_Store至此电脑端配置完成。插件会在后台自动同步你无需手动操作。二、手机端配置使用 GitSync Obsidian由于 Obsidian 移动端的 Git 插件功能有限且体验不佳推荐使用GitSync安卓或Working CopyiOS作为 Git 客户端再由 Obsidian 打开仓库目录。安卓端配置GitSync参考链接1. 安装所需应用Obsidian从官方渠道或应用商店安装。GitSync在 Google Play 搜索“GitSync”安装或从 https://gitsync.viscouspotenti.al https://github.com/ViscousPot/GitSync下载。Termux可选用于执行 Git 命令可从 F-Droid 或 Google Play 安装。2. 克隆远程仓库到手机方法一使用 GitSync打开 GitSync选择“Clone repository”。输入远程仓库地址格式https://oauth2:你的令牌gitee.com/用户名/仓库名.git。选择本地存储路径如Documents/obsidian-mobile。等待克隆完成首次可能较慢。方法二使用 Termux打开 Termux执行cd~/storage/shared/Documentsgitclone https://oauth2:你的令牌gitee.com/用户名/仓库名.git3. 在 Obsidian 中打开仓库打开 Obsidian选择“打开本地仓库”。导航到刚才克隆的目录如Documents/obsidian-mobile/仓库名。确认打开即可看到笔记内容。4. 配置 GitSync 自动同步在 GitSync 中进入“Auto Sync Settings”。点击“SELECT APP(S)”选择 Obsidian。开启“开启软件时自动同步”和“关闭软件时自动同步”可选但可能产生过多提交。建议手动同步在 GitSync 主界面点击“Sync”按钮或在 Obsidian 使用前后手动同步。iOS 端配置Working Copy安装 Working Copy付费 App但功能完整。在 Working Copy 中克隆你的远程仓库。将仓库链接到本地文件夹Share → Link Repository to Folder。在 Obsidian 中打开该文件夹作为 Vault。三、同步流程与最佳实践日常使用流程电脑端正常编辑笔记插件每10分钟自动提交并推送。手机端使用前打开 GitSync点击“Pull”拉取最新笔记。使用后点击“Commit Push”推送修改。避免冲突尽量不要同时在电脑和手机上编辑同一文件。如果出现冲突Git 会高亮提示手动选择保留版本即可。高级建议双库结构可创建两个仓库一个用于电脑端深度整理主库一个用于手机端闪念记录移动库定期合并。SSH 密钥认证若熟悉 SSH可配置密钥替代 Token更安全便捷。定期维护偶尔检查.gitignore确保不同步临时文件清理无用分支。故障排除同步失败检查网络连接、Token 是否过期、仓库地址是否正确。插件报错确认电脑端 Git 已安装并重启 Obsidian手机端如 Obsidian Git 插件不稳定坚持使用 GitSync/Working Copy。四、方案优势总结免费无需支付 Obsidian Sync8美元/月。安全私有仓库 版本历史误删可回滚。可控完全掌握数据无第三方依赖。跨平台支持 Windows、macOS、Linux、Android、iOS。按照以上步骤你即可搭建一套稳定、免费的多设备 Obsidian 同步系统。开始享受随时随地无缝记录与查阅笔记的体验吧