Obsidian Sync 提供了多种元素来指示同步状态,主要包括[[#同步状态图标]]和[[#同步日志]]。有关 Obsidian Sync 版本控制的详细信息,请参阅[[版本历史]]页面。
## 同步状态图标
同步状态图标位于桌面版的[[状态栏]]中,以及移动端和平板设备的[[侧边栏#打开隐藏的侧边栏|右侧边栏]]中。该图标反映了各种同步状态:
- ![[obsidian-icon-sync-synced.svg#icon]] **已同步**:Obsidian Sync 已完全同步你的文件。此图标通常为绿色。
- ![[obsidian-icon-sync-syncing.svg#icon]] **同步中**:Obsidian 正在更新远程仓库。此图标通常为紫色。
- ![[obsidian-icon-sync-paused.svg#icon]] **已暂停**:同步已暂停,但 Obsidian 仍与远程仓库保持连接。此图标通常为紫色。
- ![[obsidian-icon-sync-disconnected.svg#icon]] **已断开**:同步核心插件已启用,但[[本地仓库与远程仓库|本地仓库]]未连接到远程仓库。此图标通常为红色。
点击或轻触图标会打开一个上下文菜单,包含以下选项:
- ![[obsidian-icon-sync-paused.svg#icon]] 暂停(如果已暂停则显示 ![[lucide-circle-play.svg#icon]] 恢复)
- ![[lucide-history.svg#icon]] [[版本历史]](如果未查看笔记则为灰色不可用)
- ![[lucide-align-left.svg#icon]] 打开[[#同步日志|同步日志]]
- ![[lucide-trash-2.svg#icon]] [[版本历史#恢复已删除的文件|已删除文件]]
- ![[lucide-cog.svg#icon]] [[同步文件和设置|同步设置]]
## 同步日志
Obsidian Sync 包含一个详细的同步日志,用于跟踪本地文件与远程仓库之间的所有交互。日志会显示上传、下载、删除以及合并冲突或连接问题等信息。
**访问同步日志:**
- 点击状态栏中的同步状态图标
- 前往**[[设置文件夹|设置]] → 同步 → 同步日志**
- 使用**命令面板 → 同步:打开同步日志**
日志为每个同步操作提供时间戳和详细信息,有助于排查同步问题。
> [!warning] 同步日志在关闭 Obsidian 后不会保留。如果你遇到了问题,请确保在关闭应用_之前_复制日志。
日志将消息分为以下类型:
- [[#常规消息]]
- [[#错误消息]]
- [[#已跳过消息]]
- [[#账户消息]]
你可以按**所有**、**错误**、**已跳过**和**合并冲突**筛选同步日志。此外,你还可以使用同步窗口中的搜索框搜索同步日志。
> [!summary] 我们在下方列出了一些你可能遇到的常见消息,但该列表并不详尽。如果你遇到问题且对某条同步日志消息不确定其含义,请[[帮助与支持#联系 Obsidian 支持团队|联系 Obsidian 支持团队]]。
### 常规消息
这些是你可能在日常使用中遇到的常见消息。
**Connecting to server**
Obsidian 正在尝试连接到你远程仓库的[[同步安全和隐私#如何查找当前的 Sync 服务器及其托管位置?|同步服务器]]。
**Connected to server. Detecting changes...**
Obsidian 已建立连接,正在比较本地仓库与远程仓库以确定是否需要同步更改。
> [!info] 此消息也可能表示其他潜在的同步问题。如果你反复看到此消息且认为仍有项目需要同步,请[[帮助与支持#联系 Obsidian 支持团队|联系 Obsidian 支持团队]]。
**Fully synced**
- 本地仓库与远程仓库已完全同步。
**Merging conflicted file**
同步过程中检测到冲突,文件已被合并而非覆盖。有关更多信息,请参阅[[官方同步故障排查指南#冲突解决方式|冲突解决方式]]。如果合并结果不符合预期,你可以通过[[版本历史]]或[[文件恢复]]恢复之前的版本。
**Rejected server change**
远程仓库上的更改比本地设备上的版本更旧,因此保留了本地版本,忽略了远程更改。
### 错误消息
这些消息详细说明了文件同步中的错误。
**Out of memory**
此问题通常发生在移动设备上,当没有足够的存储空间或内存来下载文件时会出现。这种情况最常见于较大的文件,例如视频。
### 已跳过消息
这些消息详细说明了哪些内容被跳过,以及可能的原因。
**Unable to download file with illegal name**
文件包含接收操作系统不允许的[特殊字符或命名约定](https://stackoverflow.com/questions/1976007/what-characters-are-forbidden-in-windows-and-linux-directory-names)。为方便起见,你可以在源设备上重命名文件,移除除 `-` 和 `_` 以外的所有特殊字符。
请注意,这也包括 Android 设备上文件名中含有多个句点 `.` 的文件。
### 账户消息
这些消息与你的订阅或账户变更相关。
**Vault limit exceeded**
你的账户已超出[[同步常见问题#每个远程仓库可以有多大|最大存储容量]]。附件和版本历史都会占用容量。即使你的仓库看起来小于限制,旧版本和文件也可能导致超出限制。
要减少仓库大小:
1. 打开**[[设置文件夹|设置]] → 同步**。
2. 使用**仓库过大**下的选项移除大文件。
**Vault not found**
`{"res":"err","msg":"Vault not found."}`
此错误可能在以下情况下出现:
1. 仓库已从其他设备删除。
2. 同步订阅超过 30 天未激活,导致远程仓库被移除。
3. 订阅已取消或退款,导致远程仓库被删除。
在这些情况下,你需要[[启动同步服务#断开远程仓库连接|断开远程仓库连接]]并[[启动同步服务#创建新的远程仓库|创建新的远程仓库]],同时确保本地数据得到保留。
**Failed to authenticate: Your subscription to Obsidian Sync has expired**
你的账户已完全过期,因为我们无法处理文件中的付款。
要继续使用 Obsidian Sync,你需要在[你的账户](https://obsidian.md/zh/account/sync)中重新订阅。
**Failed to authenticate: Not logged in**
Obsidian Sync 检测到你当前未登录。你需要在**[[设置文件夹|设置]]**的[[设置#General#Account|账户]]部分重新登录应用。
在某些情况下,社区插件也可能阻止 Obsidian Sync 确认你的账户登录状态。请进入**[[插件安全#受限模式|受限模式]]**后重试。
### 网络消息
**Disconnected from server**
`Unable to connect to server`
Obsidian Sync 因未知原因与同步服务器断开了连接。同步服务会定期尝试重新连接服务器。
在 iOS 上,此消息显示为以下错误:
`Null is not an object (evaluating 'this.socket.send')`
它与 `Unable to connect to server` 消息的含义完全相同,并不表示存在其他问题。