同步
关于同步插件
同步插件是 Obsidian 官方提供的云端同步解决方案，用于在多个设备间安全地同步笔记数据。需要订阅 Obsidian Sync 服务使用。
为什么选择官方同步？
核心特点
| 特性 | 说明 |
|---|---|
| 端到端加密 | 数据在本地加密后上传，服务器无法读取内容 |
| 版本历史 | 保留笔记的历史版本，可随时恢复 |
| 实时同步 | 编辑后自动同步，无需手动操作 |
| 选择性同步 | 可指定同步特定文件夹或排除文件 |
| 跨平台支持 | 支持桌面端和移动端 |
其他同步方案
除官方同步外，还有 iCloud、Git、云盘、Remotely Save、Syncthing 等方案。详见 同步方案对比。
启用同步插件
订阅服务
同步插件需要 Obsidian Sync 订阅：
yaml
订阅方式:
单独订阅: $4/月 或 $48/年
包含于: Catalyst 或 Commercial 许可
订阅地址: https://obsidian.md/pricing启用步骤
yaml
步骤:
1. 打开「设置」→「核心插件」
2. 找到「同步」选项
3. 开启开关启用插件
4. 侧边栏会出现同步图标
5. 点击图标登录 Obsidian 账户配置远程仓库
创建远程仓库
首次使用需要创建远程仓库：
yaml
步骤:
1. 点击同步图标 → 选择「创建新仓库」
2. 输入仓库名称（如：我的笔记库）
3. 设置仓库密码（用于加密）
4. 确认创建密码安全
- 仓库密码用于端到端加密
- 请安全保管密码，丢失无法恢复数据
- 不同仓库可使用不同密码
连接现有仓库
在新设备上连接已有仓库：
yaml
步骤:
1. 创建或打开本地仓库
2. 点击同步图标 → 选择「连接远程仓库」
3. 从列表中选择仓库
4. 输入仓库密码
5. 等待同步完成管理远程仓库
yaml
操作:
查看仓库列表: 同步图标 → 管理仓库
删除远程仓库: 设置 → 同步 → 管理远程仓库
注意: 删除远程仓库会永久清除所有云端数据同步设置详解
基本设置
进入「设置」→「同步」：
| 设置项 | 说明 | 建议值 |
|---|---|---|
| 自动同步 | 编辑后自动同步 | 开启 |
| 同步状态显示 | 在状态栏显示同步状态 | 开启 |
| 同步确认 | 同步前确认操作 | 按需 |
选择性同步
yaml
配置路径: 设置 → 同步 → 选择性同步
同步的文件夹:
- 勾选需要同步的文件夹
- 未勾选的文件夹保持本地
- 可用于分离工作和个人笔记
排除的文件:
- 添加排除规则
- 支持通配符（如: *.tmp）
- 排除大型附件文件
附件大小限制:
- 默认: 无限制
- 建议: 根据网络情况设置
- 超限文件不会同步历史版本设置
yaml
配置路径: 设置 → 同步 → 历史版本
保留版本数量:
- 默认: 所有版本
- 可设置上限（如 100 个）
- 节省存储空间
版本保留时间:
- 默认: 1 年
- 可自定义时长
- 过期版本自动清理同步状态说明
状态图标
| 图标 | 状态 | 说明 |
|---|---|---|
| 🟢 绿色对勾 | 已同步 | 所有更改已同步完成 |
| 🟡 黄色圆圈 | 同步中 | 正在上传或下载 |
| 🔴 红色感叹号 | 同步错误 | 需要检查网络或配置 |
| ⚪ 灰色圆圈 | 未连接 | 未登录或网络断开 |
| ⏸️ 暂停图标 | 已暂停 | 同步已手动暂停 |
同步详情
点击同步图标可查看：
yaml
详情内容:
- 最后同步时间
- 待上传文件数
- 待下载文件数
- 同步速度
- 错误信息（如有）版本历史功能
查看历史版本
yaml
方法一: 右键菜单
1. 右键点击笔记文件
2. 选择「查看同步历史」
3. 浏览所有历史版本
方法二: 命令面板
1. Ctrl+P 打开命令面板
2. 输入「同步历史」
3. 选择对应命令版本信息
每个版本包含：
yaml
版本详情:
修改时间: 精确到秒
文件大小: 变化前后对比
修改者: 多用户协作时显示
预览: 可查看内容差异恢复历史版本
yaml
恢复步骤:
1. 选择要恢复的版本
2. 预览版本内容
3. 点击「恢复此版本」
4. 当前版本会保存为新历史版本
5. 笔记内容恢复为选定版本恢复机制
恢复操作不会丢失当前内容，当前版本会自动保存到历史记录中。
冲突处理
何时发生冲突
当两台设备同时编辑同一笔记时可能发生冲突：
yaml
常见场景:
- 离线编辑后同时上线同步
- 多设备快速切换编辑
- 网络不稳定导致同步延迟自动处理机制
yaml
Obsidian 处理方式:
非同时编辑:
- 自动合并更改
- 无需用户干预
同时编辑:
- 保留两个版本
- 创建冲突副本文件
- 文件名格式: 原文件名 (conflicting copy)手动解决冲突
yaml
解决步骤:
1. 打开冲突副本文件
2. 对比两个版本的差异
3. 手动合并需要的内容
4. 保存正确的版本
5. 删除冲突副本文件避免冲突的最佳实践
yaml
预防措施:
- 切换设备前确保同步完成
- 避免多设备同时编辑同一笔记
- 保持网络连接稳定
- 定期检查同步状态高级功能
加密密钥管理
yaml
位置: 设置 → 同步 → 加密
功能:
- 查看加密状态
- 验证密码正确性
- 导出备份密钥（高级）
注意:
- 密钥与密码相关联
- 重新生成会使旧数据无法解密
- 操作前确保完整同步同步日志
yaml
查看日志:
位置: 设置 → 同步 → 高级 → 查看日志
用途:
- 排查同步问题
- 查看详细同步记录
- 定位失败原因
- 导出日志供技术支持暂停与恢复
yaml
操作:
暂停同步: 点击同步图标 → 暂停
恢复同步: 点击同步图标 → 恢复
使用场景:
- 网络不稳定时
- 需要离线批量编辑时
- 进行大量本地操作时
- 节省网络带宽时仅下载模式
yaml
设置: 设置 → 同步 → 仅下载
用途:
- 创建只读副本
- 在多设备间单向同步
- 备份目的移动端同步
iOS 同步
yaml
注意事项:
- iOS 后台同步有时间限制
- 确保在前台完成重要同步
- 定期检查同步状态
- 大文件同步可能较慢
推荐操作:
- 打开 App 后等待同步完成
- 切换到其他 App 前确认同步状态
- 定期检查版本历史Android 同步
yaml
注意事项:
- 部分设备可能限制后台同步
- 检查电池优化设置
- 确保 Obsidian 在白名单中
推荐操作:
- 关闭电池优化
- 允许后台运行
- 定期手动检查同步故障排查
同步卡住不更新
解决方案
- 点击暂停，等待 10 秒后恢复
- 检查网络连接状态
- 重启 Obsidian
- 检查是否有大文件正在上传
- 查看同步日志定位问题
- 尝试重新登录账户
无法连接远程仓库
解决方案
- 确认已订阅 Obsidian Sync 服务
- 确认订阅未过期
- 检查账户登录状态
- 尝试重新登录账户
- 检查网络连接
- 检查防火墙设置
版本历史不显示
解决方案
- 确认同步已完成
- 检查历史版本设置是否开启
- 确认文件在同步范围内
- 等待几分钟让索引更新
- 检查是否选择了正确的时间范围
同步速度慢
解决方案
- 检查网络带宽
- 减少同步文件数量（选择性同步）
- 设置附件大小限制
- 压缩大型图片附件
- 避免同步
.obsidian缓存文件
仓库密码忘记
解决方案
无法恢复
仓库密码用于端到端加密，Obsidian 官方也无法获取。如果忘记密码：
- 无法解密现有云端数据
- 需要删除远程仓库重新创建
- 建议安全保存密码备份
存储与配额
存储限制
yaml
配额说明:
标准配额: 根据订阅计划而定
包含: 笔记文件 + 附件 + 版本历史
空间管理:
- 定期清理旧版本历史
- 排除大型附件文件
- 使用图片压缩
- 检查存储使用情况查看使用情况
yaml
位置: 设置 → 同步 → 存储使用
显示内容:
- 已用空间
- 总配额
- 各类型文件占比
- 版本历史占用