本指南涵盖在 Legion Hosting 上运行 Rust 专用服务器时可能遇到的常见问题及其解决方法。有关常规服务器配置，请参阅 Rust 服务器配置指南。
服务器未出现在服务器浏览器中
如果您的服务器正在运行但玩家在游戏内浏览器中找不到它：
- 服务器浏览器可能需要 10-20 分钟来索引新启动的服务器。在浏览器更新期间，使用 F1 控制台直接连接（
client.connect IP:PORT）来验证服务器是否可达。 - 确保
QUERY_PORT启动变量（在 GPanel 启动选项卡中）与 GPanel 网络选项卡中分配的查询端口一致。查询端口不正确是服务器无法出现在浏览器中最常见的原因。 - 确认服务器已完全启动 — 在测试连接之前，请在控制台中查找
Server startup complete行。 - 检查
server.cfg中是否设置了server.hostname。没有设置主机名的服务器可能无法在浏览器中正确显示。
如需帮助查找服务器的 IP 地址、游戏端口和查询端口，请参阅 如何查找服务器 IP 和端口。
无法连接到服务器
如果您在尝试加入时收到连接错误或超时：
- 在 GPanel 控制台选项卡中验证服务器正在运行且已完全启动。
- 仔细检查您使用的是 GPanel 网络选项卡中正确的 IP 地址和游戏端口。
- 如果服务器最近更新过（尤其是在每月第一个周四的强制擦档期间），请确保您在更新后已重启服务器。使用新版客户端的玩家无法连接到运行旧版本的服务器。
- 检查
server.maxplayers是否已达上限。如果服务器已满，新连接将被拒绝。 - 确认您是否被封禁。请联系服务器管理员或查看服务器上的
bans.cfg。
无法使用外部工具连接 RCON
如果 RustAdmin、RCON.IO 或其他 RCON 客户端无法连接：
- 确认
server.cfg中已设置rcon.web 1。大多数外部工具需要 WebSocket RCON 接口。 - 确认您使用的是 RCON 端口而非游戏端口。请在 GPanel 网络选项卡中查看分配给您的 RCON 端口。
- 仔细检查 RCON 密码与
server.cfg中设置的值完全匹配。密码区分大小写。 - 服务器必须完全启动后才能接受 RCON 连接。请在控制台中等待
Server startup complete。
有关完整的 RCON 设置说明，请参阅 Rust RCON 访问与管理员命令。
Oxide 插件未加载
- 确认 Oxide 已安装并处于活动状态。在 GPanel 启动选项卡中，
FRAMEWORK变量必须设置为oxide。控制台日志在启动期间应显示Loaded plugin Oxide.Core。 - 插件文件必须直接放置在
oxide/plugins/中，并使用确切的.cs扩展名。子目录中的文件或扩展名错误的文件将被忽略。 - 检查控制台和
oxide/logs/中的编译错误。存在语法错误的插件将无法加载，错误消息会描述具体问题。 - 部分插件依赖于其他插件（例如 Economics）。请先安装所有必需的依赖项。
- 确保插件版本与当前 Oxide 版本兼容。过时的插件可能无法在较新的 Oxide 版本上编译。
有关完整的插件安装说明，请参阅 Rust Oxide/uMod 插件安装。
服务器使用过多 RAM 或 CPU
如果您的服务器运行缓慢、出现延迟或超出资源限制：
- 缩小地图大小。降低
server.cfg中的server.worldsize。更大的地图需要更多的 RAM 和 CPU 来运行和维护。对于大多数服务器，3000的地图大小是一个不错的平衡点。 - 审查已安装的插件。一些编写不佳或过时的插件可能导致高 CPU 使用率或内存泄漏。使用
oxide.plugins列出活动插件，并逐个禁用以找出问题插件。 - 降低玩家数量。如果服务器对当前玩家数量配置不足，请降低
server.maxplayers。每个已连接的玩家都会增加资源开销。 - 检查实体堆积。在长时间运行的服务器上，废弃的基地和衰退的物品会不断累积。地图擦档可将实体数量重置为零。
如果您持续超出方案的资源限制，请考虑升级您的服务器套餐。联系支持团队了解升级选项。
世界更改未保存 / 重启后回档
如果玩家进度在服务器重启后丢失：
- 确认
server.cfg中的server.saveinterval设置为合理的值（默认为60秒）。将其设置为0或非常大的数字实际上会禁用自动保存。 - 在停止服务器之前，通过 GPanel 控制台或 RCON 手动运行
server.save以强制立即保存。 - 确保通过 GPanel 正常停止服务器，而不是强制终止。强制终止可能导致最近一次保存间隔内的更改丢失。
- 检查可用磁盘空间。如果服务器磁盘空间耗尽，将无法写入存档文件。
服务器启动时崩溃
如果服务器启动后立即崩溃或进入重启循环：
- 检查控制台输出中的错误消息。常见原因包括损坏的存档文件、不兼容的插件或缺失的框架文件。
- 如果崩溃发生在添加插件之后，请从
oxide/plugins/中移除最近添加的.cs文件并重启。 - 如果崩溃发生在游戏更新之后，请确保
FRAMEWORK变量设置正确。框架文件可能需要在 Rust 更新后重新下载 — 只需重启服务器，更新的框架应会自动获取。 - 尝试删除存档文件（
proceduralmap.*.sav和proceduralmap.*.map）并执行全新的地图擦档。损坏的存档文件可能会阻止服务器启动。
删除存档文件前请先备份。如果您希望保留恢复当前世界的可能性，请在删除之前通过 SFTP 下载存档文件。有关文件传输的帮助，请参阅 如何通过 SFTP 上传文件。
地图生成耗时很长
擦档后，服务器必须生成新的程序化地图。这是正常且预期的行为：
3000大小的地图通常需要 2-5 分钟生成。- 更大的地图（
4000-6000）可能需要 10 分钟以上。 - 在地图生成期间请勿重启服务器。请让其完全完成。控制台将在准备就绪时显示
Server startup complete。
需要帮助？
如果您的问题未在此处涵盖，我们的支持团队随时为您提供帮助。提交支持工单，并包含以下信息：
- 您的服务器 ID（显示在 GPanel 中）
- 问题描述及问题开始的时间
- 任何相关的控制台输出或错误消息
- 您已尝试过的步骤
