云端服务器故障排除

云端服务器故障排除

当你在运行云端服务器遇到困难时，可以参考本指南中的一些故障排除技巧。

从简单开始

如果你遇到问题，特别是当你第一次使用云端服务器软件（Headless Server Software）时，我们建议尝试使用 最小配置文件 来运行服务器。该文件使用了启动房间所需的最基本属性。如果这个配置无法运行，那么你尝试的其他复杂配置也不太可能成功。

检查日志文件

云端服务器软件输出的日志与普通 Resonite 客户端相同。因此，第一步应该是检查云端服务器生成的任何相关 日志文件 (Log Files)。

查看日志时，请检查以下项目：

• Error Logging In（登录错误）
• Error（错误）
• Exception（异常）

等等。

如果你发现了问题但不知道如何处理，可以继续阅读本文，或者在我们的 Discord 上发帖求助。

登录问题

云端服务器软件目前 不支持显示登录错误的本地化字符串。因此，定位登录错误可能比较困难，以下是一些提示：

1. 在 日志文件 中搜索 "Error logging in:"。
   • 如果你找到了这句话，说明你的云端服务器无法工作是因为登录问题。
2. 获取 "Error logging in:" 冒号 (:) 后面的文本，并在我们的 Locale 文件（语言文件） 中搜索该文本。
   • 这将为你把错误代码翻译成一条可读的消息，你可以根据该消息进行后续操作。

如果不确定，你也可以尝试在普通的 Resonite 客户端上登录该云端服务器账号，这也能验证你的 Resonite 账号是否正常工作。

配置文件格式

非常有必要将你的 配置文件 复制到 JSON Linter 中，以检查它是否为有效的 JSON 文件。

你也可以将你的 配置文件 粘贴到 JSON Schema Validator 右侧的文本框中，以检查是否有错误。

你还可以通过其他能够读取 Schema 的 工具 来使用 Schema 本身。我们推荐 Visual Studio 或 Visual Studio Code，它们原生支持 JSON Schema。

世界问题

云端服务器用户的一个常见目标是加载特定的世界。

在执行此操作遇到问题时，请检查以下项目：

1. 世界是否已保存且为最新版本。
2. 该世界是否能被任何用户打开。
   • 你也可以将世界存储在群组文件夹（Group folder）中，只要云端服务器用户在该群组中，就应该能加载。
3. 你是否拥有该世界有效的 resrec:/// URL。

如果你需要关于世界问题的更多帮助，请遵循 加载特定世界指南。

云记录版本冲突 (Conflicting cloud record version)

这是一个 同步冲突 (Sync Conflict)，请参阅相关故障排除页面以获取更多信息。

下一步去哪里？

如果你仍然遇到问题，可以在我们的 Discord 提问，或者在我们的 问题追踪器 (Issue Tracker) 上发布 issue。