# 实时协作故障排除

读懂同步状态，测试到协作服务器的连接，并解决等待中的更改、未发送的评论、登录问题和被阻止的网络。

先做两项检查：项目的同步状态，以及服务器的**测试连接**。两者合起来能告诉你，问题出在你的电脑、你的网络还是服务器。

## 读懂同步状态

把鼠标悬停在**实时协作**窗格顶部的状态图标上，或点击它。详情会用文字说明状态、项目共享所在的服务器及其地址、你的角色，以及有多少更改在等待。[同步状态](/docs/collaboration/working-together/#the-sync-status)列出了每种状态的含义。

## 测试连接

打开**设置 → 协作**，点击该服务器卡片上的**测试连接**。Oleafly 会从你的电脑运行这些检查，并指出它发现的第一个问题：

| 检查 | 测试什么 |
| --- | --- |
| **地址** | 服务器在这个地址上有响应。 |
| **安全连接** | 连接已加密，证书有效。 |
| **版本** | 此版本的 Oleafly 与服务器可以配合使用。否则它会说明哪一方需要更新。 |
| **实时连接** | 实时编辑可以正常传输。这里出现提示表示它们走的是较慢的通道，这仍然可以工作。 |
| **登录方式** | 服务器至少有一种登录方式。 |
| **电子邮件** | 服务器是否可以发送电子邮件。没有它时，添加人员不会发送邮件。 |
| **时钟** | 你电脑的时钟与服务器的时钟一致。 |

## 更改在等待

如果状态一直停留在**离线。等待同步的更改：** 加一个数字，说明服务器还没有收到这些更改。它们安全地保存在你的电脑上，即使你退出 Oleafly 也一样。

1. 确认你已联网，然后运行**测试连接**。
2. 如果地址没有响应，可能是服务器宕机了。请等一等，或者询问它的管理员。
3. 不要为了解决这个问题而退出登录。如果你尝试退出，Oleafly 会就未发送的更改询问你。选择**保持登录**，连接恢复后它们就会发出。

你不需要再做其他事。这些更改会自行发出。

## 评论没有发送

如果出现“此项目已关闭评论，所以你写的评论没有发送”的提示，意味着所有者或服务器管理员在你的评论到达服务器之前关闭了评论。你的其他更改已经发送。

点击**显示你写的内容**，再点击**复制文本**保存这段文字。如果你需要评论，请让所有者重新开启。[关闭评论](/docs/collaboration/comments/#turn-comments-off)中有详细说明。

## 文件没有共享

- **超过此服务器允许的大小**：该文件只保留在你的电脑上。请把它缩小后再次保存。
- **无法共享**：上传失败了。点击**重试**。
- **等待共享**：上传还没有进行，通常是因为你处于离线状态。它会自行发出。

## 登录问题

| 消息或现象 | 怎么办 |
| --- | --- |
| “你还不在此服务器的名单上。” | 请让服务器的管理员添加你。如果你是被邀请为访客的，请用收到邀请的那个地址登录。 |
| 浏览器始终没有回到 Oleafly | 使用**用登录码登录**。请阅读[用登录码登录](/docs/collaboration/get-started/#with-a-code)。 |
| “登录耗时过长。” | 重新开始。请在打开的浏览器窗口中完成登录。 |
| 电子邮件链接无法使用 | 链接只能使用一次，有效期 15 分钟，并且只能在请求它的那台电脑上使用。请重新申请一个。尝试几次之后，服务器会要求你等待 15 分钟。 |
| 登录码无法使用 | 登录码只能使用一次，10 分钟后失效。请在 Oleafly 中获取新的登录码。 |
| “已有其他人通过这台电脑上的此用户账户登录了此服务器。” | 每个人都需要在这台电脑上拥有自己的账户。请先登录你自己的电脑账户。 |
| “此地址未使用安全连接。” | 协作服务器需要 https 地址。请向管理员确认地址。 |
| “此服务器需要更新版本的 Oleafly。” | [更新 Oleafly](/docs/updates/)，然后再试一次。 |
| “此服务器需要更新后才能与此版本的 Oleafly 配合使用。” | 请让服务器的管理员更新它。 |
| “此地址现在属于另一台服务器。” | Oleafly 没有向新的服务器发送任何内容。如果你信任它，请移除旧条目，然后重新添加该服务器。 |
| “此服务器已在你的列表中，但使用的是另一个地址。” | 服务器迁移了。请先移除旧条目，再重新添加。 |
| “服务器繁忙。” | 等待一分钟后再试。 |
| 你的时钟与服务器的时钟相差很大 | 请正确设置你电脑上的日期和时间。 |
| 证书错误 | 你所在的机构可能使用自行签发的证书。你的电脑必须信任那家证书颁发机构。请询问你的 IT 人员。 |

## 网络、代理和防火墙

如果**实时连接**显示“你与服务器之间有东西阻止了实时编辑”，说明你网络上的防火墙或代理挡了路。请把这条消息给你的 IT 人员或服务器管理员看。

如果它显示实时编辑走较慢的通道，说明你的网络阻止了常规连接。无需修复任何东西：每个编辑仍然会送达，只是晚一点。请阅读[阻止实时连接的网络](/docs/collaboration/offline/#networks-that-block-live-connections)。

服务器管理员可以在[存储、备份与限制](/docs/collaboration/server-operations/#behind-a-reverse-proxy)中了解服务器前面的代理需要什么。

## 何时联系服务器管理员

在下列情况下，请询问运行你服务器的人：

- 你无法登录，或 Oleafly 说你不在服务器的名单上
- **测试连接**在**地址**、**安全连接**或**登录方式**上失败
- Oleafly 说服务器需要更新
- 你的账户被停用，或你的访问权限被终止，而你认为这是个错误
- 超过大小限制的文件需要共享，某个项目需要比服务器允许的更多人，或者你的账户需要比服务器给每个账户的更多存储空间或共享项目
- 你需要开启访客、链接共享、评论或项目访问日志

对于应用本身的问题，请按照[报告问题](/docs/faq/#report-a-problem)操作。
