Obsidian Sync 详细配置指南

Obsidian Sync 是 Obsidian 官方提供的端到端加密同步服务，本文档详细介绍其配置和使用方法。

概述

什么是 Obsidian Sync？

Obsidian Sync 是专为 Obsidian 设计的云同步服务：

特性	说明
端到端加密	数据在传输和存储时全程加密
版本历史	保存文件的历史版本，最长 1 年
选择性同步	可选择同步特定文件或排除文件
实时同步	自动同步更改，无需手动操作
跨平台	支持 Windows、macOS、Linux、iOS、Android

价格方案

方案	价格	存储空间	功能
Sync	$4/月	10GB	完整同步功能
Sync + Publish	$16/月	10GB	同步 + 发布服务
Sync 2 倍	$8/月	20GB	更大存储空间

快速开始

账户注册

访问 Obsidian 官网
点击「Sign in」
注册或登录账户

激活同步服务

登录 Obsidian 账户
进入账户设置
订阅 Sync 服务

首次配置

在主设备上

打开 Obsidian
设置 → 核心插件 → 启用「同步」
点击「登录」
输入账户信息登录
选择「创建新的远程仓库」
输入仓库名称
点击「开始同步」

在其他设备上

安装 Obsidian
设置 → 核心插件 → 启用「同步」
登录账户
选择「连接已有的远程仓库」
选择要同步的仓库
等待同步完成

同步设置详解

基础设置

进入设置 → 同步：

设置项	说明	推荐值
自动同步	自动同步更改	开启
同步已排除的文件	同步被排除的文件	按需
仅同步文本文件	不同步图片等二进制文件	按需
库版本历史天数	本地版本历史保留天数	7 天

远程仓库管理

创建多个仓库

可以为不同的笔记仓库创建不同的远程仓库：

yaml

场景示例:
  仓库 1: 工作笔记
  仓库 2: 个人笔记
  仓库 3: 学习资料

操作步骤：

设置 → 同步
点击仓库名称旁的下拉菜单
选择「创建新仓库」

切换仓库

在多个设备间切换同步的仓库：

设置 → 同步
点击仓库名称下拉菜单
选择要连接的仓库

删除远程仓库

危险操作

删除远程仓库会删除所有云端数据，操作前请确保本地有完整备份！

登录 Obsidian 账户网页
进入「远程仓库」页面
点击删除按钮
确认删除

选择性同步

排除特定文件夹

创建 .obsidian/plugins/sync/exclude.txt 文件：

text

# 排除大文件目录
attachments/
videos/
archives/

# 排除敏感信息
private/
secrets/

# 排除临时文件
.temp/
.cache/

排除特定文件类型

在同步设置中启用「仅同步文本文件」：

✅ 同步：.md、.txt、.json、.css 等文本文件
❌ 不同步：.mp4、.mp3、.pdf 等二进制文件

图片与附件同步

方案一：使用 Obsidian Sync 同步

yaml

配置:
  仅同步文本文件: 关闭
  
优点:
  - 配置简单
  - 自动同步
  
缺点:
  - 占用存储空间
  - 大文件影响同步速度

方案二：使用图床

将图片上传到图床，笔记中只保留链接：

yaml

图床选择:
  - 阿里云 OSS
  - 腾讯云 COS
  - GitHub
  - Imgur

优点:
  - 不占用 Sync 空间
  - 同步更快
  
缺点:
  - 需要额外配置
  - 离线时图片无法显示

方案三：混合方案

yaml

策略:
  小图片: 使用 Sync 同步（截图、图标）
  大文件: 使用图床（照片、视频）

版本历史功能

版本历史概述

Obsidian Sync 自动保存文件的版本历史：

版本类型	保留时间	说明
每次更改	1 年	所有更改记录
删除的文件	7 天	可从回收站恢复

查看版本历史

方法一：文件历史面板

打开右侧面板 → 文件历史
选择要查看的文件
浏览历史版本
点击「恢复」回滚到指定版本

方法二：命令面板

按 Ctrl/Cmd + P 打开命令面板
搜索「同步：浏览文件版本」
选择文件查看历史

版本历史最佳实践

yaml

建议:
  重要文件:
    - 定期查看版本历史
    - 关键更改后手动创建版本备注
  
  大型仓库:
    - 减少版本历史保留天数
    - 定期清理旧版本
  
  协作场景:
    - 利用版本历史追踪更改
    - 解决冲突时参考历史版本

同步状态与故障排查

同步状态指示器

在状态栏可以看到同步状态：

图标	状态	说明
🔄 旋转	同步中	正在上传/下载更改
✓ 绿色勾	已同步	所有更改已同步
⚠️ 黄色感叹号	警告	存在冲突或错误
✗ 红色叉	错误	同步失败

常见问题排查

同步卡住不动

yaml

排查步骤:
  1. 检查网络连接
  2. 点击「暂停同步」再「继续同步」
  3. 重启 Obsidian
  4. 检查是否有大文件阻塞
  
解决方案:
  - 排除大文件后重试
  - 使用「选择性同步」减少同步内容

同步冲突

什么是同步冲突？

当两个设备同时修改同一文件时，会产生冲突。Obsidian 会保留两个版本。

冲突文件示例：

原文件：笔记.md
冲突后：笔记.md + 笔记 (冲突副本 2024-01-15).md

解决步骤：

打开两个版本对比内容
手动合并需要保留的内容
删除冲突副本
同步确认

存储空间不足

yaml

检查空间使用:
  1. 登录 Obsidian 账户网页
  2. 查看存储空间使用情况

解决方案:
  方案一: 清理大文件
    - 查找大文件并排除同步
    - 清理版本历史
  
  方案二: 升级存储空间
    - 购买更大存储方案
  
  方案三: 分仓库管理
    - 将笔记分散到多个仓库

同步速度慢

yaml

优化方法:
  1. 启用「仅同步文本文件」
  2. 排除不需要同步的目录
  3. 压缩图片后再保存
  4. 减少同时同步的设备数量
  
网络优化:
  - 使用稳定的网络连接
  - 避免在移动网络下同步大文件

与其他同步方案对比

详细对比

特性	Obsidian Sync	iCloud	Syncthing	Git
配置难度	简单	简单	中等	复杂
版本历史	✅ 1年	❌	❌	✅ 完整
端到端加密	✅	✅	✅	按需
大文件支持	一般	好	好	差
移动端支持	✅	iOS only	✅	需配置
冲突处理	自动	冲突副本	冲突副本	手动合并
离线可用	✅	✅	✅	✅
成本	$4/月	免费/付费	免费	免费

方案选择建议

yaml

推荐场景:
  Obsidian Sync:
    - 普通用户首选
    - 需要版本历史
    - 多平台使用
  
  iCloud:
    - Apple 生态用户
    - 只使用 iOS/macOS
    - 预算有限
  
  Syncthing:
    - 技术用户
    - 需要完全控制
    - 有自己的服务器
  
  Git:
    - 开发者
    - 需要完整版本控制
    - 愿意手动管理

混合同步方案

结合多种方案的优势：

mermaid

graph TB
    A[主仓库] --> B[Obsidian Sync]
    A --> C[Git 远程仓库]
    B --> D[iPhone]
    B --> E[Android]
    C --> F[GitHub 备份]
    A --> G[本地备份]

推荐组合：

层级	方案	用途
日常同步	Obsidian Sync	实时同步、版本历史
版本控制	Git	长期备份、协作
本地备份	Time Machine / rsync	快速恢复

高级配置

配置文件解析

同步配置存储在 .obsidian/plugins/sync/data.json：

json

{
  "vaultId": "xxx-xxx-xxx",
  "remoteVaults": [
    {
      "id": "xxx-xxx-xxx",
      "name": "我的笔记",
      "created": 1234567890
    }
  ],
  "syncInterval": 300000,
  "versionHistoryDays": 365
}

环境变量配置

可通过环境变量配置同步：

bash

# 设置代理
OBSIDIAN_PROXY=http://127.0.0.1:7890

# 设置同步服务器（企业版）
OBSIDIAN_SYNC_SERVER=https://sync.yourcompany.com

API 访问

Obsidian Sync 提供 API 用于自动化：

javascript

// 检查同步状态
const syncPlugin = app.plugins.plugins['sync'];
const status = syncPlugin.instance.status;

console.log(status); // 'syncing' | 'synced' | 'error'

安全与隐私

加密机制

yaml

加密详情:
  传输加密: TLS 1.3
  存储加密: AES-256
  密钥管理: 用户设备本地存储
  服务端可见: 无法查看内容

隐私保护

Obsidian 无法读取你的笔记内容
只有你能解密数据
即使服务器被入侵，数据仍然安全

安全建议

yaml

最佳实践:
  - 使用强密码保护账户
  - 启用两步验证（如支持）
  - 定期导出备份
  - 不在公共电脑保存登录状态

企业/团队使用

多人协作

Obsidian Sync 主要为个人设计，团队协作建议：

yaml

方案一: 多账户 + 共享仓库
  - 每人使用自己的账户
  - 共享同一个远程仓库
  - 注意冲突处理

方案二: 结合 Git
  - 使用 Git 进行协作
  - Obsidian Sync 用于个人设备同步

方案三: Obsidian Publish
  - 使用 Publish 发布共享内容
  - 敏感内容保持本地

使用限制

yaml

限制:
  - 单个账户支持有限数量的设备
  - 同时同步设备数量有限制
  - 存储空间有上限

Obsidian Sync 详细配置指南 ​

概述 ​

什么是 Obsidian Sync？ ​

价格方案 ​

快速开始 ​

账户注册 ​

激活同步服务 ​

首次配置 ​

在主设备上 ​

在其他设备上 ​

同步设置详解 ​

基础设置 ​

远程仓库管理 ​

创建多个仓库 ​

切换仓库 ​

删除远程仓库 ​

选择性同步 ​

排除特定文件夹 ​

排除特定文件类型 ​

图片与附件同步 ​

方案一：使用 Obsidian Sync 同步 ​

方案二：使用图床 ​

方案三：混合方案 ​

版本历史功能 ​

版本历史概述 ​

查看版本历史 ​

方法一：文件历史面板 ​

方法二：命令面板 ​

版本历史最佳实践 ​

同步状态与故障排查 ​

同步状态指示器 ​

常见问题排查 ​

同步卡住不动 ​

同步冲突 ​

存储空间不足 ​

同步速度慢 ​

与其他同步方案对比 ​

详细对比 ​

方案选择建议 ​

混合同步方案 ​

高级配置 ​

配置文件解析 ​

环境变量配置 ​

API 访问 ​

安全与隐私 ​

加密机制 ​

隐私保护 ​

安全建议 ​

企业/团队使用 ​

多人协作 ​

使用限制 ​

相关资源 ​

Obsidian Sync 详细配置指南

概述

什么是 Obsidian Sync？

价格方案

快速开始

账户注册

激活同步服务

首次配置

在主设备上

在其他设备上

同步设置详解

基础设置

远程仓库管理

创建多个仓库

切换仓库

删除远程仓库

选择性同步

排除特定文件夹

排除特定文件类型

图片与附件同步

方案一：使用 Obsidian Sync 同步

方案二：使用图床

方案三：混合方案

版本历史功能

版本历史概述

查看版本历史

方法一：文件历史面板

方法二：命令面板

版本历史最佳实践

同步状态与故障排查

同步状态指示器

常见问题排查

同步卡住不动

同步冲突

存储空间不足

同步速度慢

与其他同步方案对比

详细对比

方案选择建议

混合同步方案

高级配置

配置文件解析

环境变量配置

API 访问

安全与隐私

加密机制

隐私保护

安全建议

企业/团队使用

多人协作

使用限制

相关资源