Rust 常见问题

Rust 服务器安装失败、一直启动中、内存不足、版本不一致、连不上、参数不生效、插件不加载等问题的排查方法。

Rust · 更新于

排查时先看哪里

位置 能看到什么
实例卡片下方的提示条 安装失败、服务器异常退出、因内存不足被终止等状态说明
「查看安装日志」 安装脚本的输出,安装阶段出错时看这里
「控制台」标签页 服务器运行日志,以及 CPU、内存、网络、磁盘占用
文件管理中的 oxide/logs/ Oxide 和插件的日志

安装失败

实例状态显示「安装失败」时:

  1. 点击提示条上的「查看日志」,看最后几行的错误信息。如果是「下载 Rust 服务端失败」「下载 Oxide 失败」这类下载错误,一般是临时网络问题。
  2. 点击 重新安装 再试一次。重新安装会保留数据目录。
  3. 多次重装都失败时,请联系客服,并附上安装日志的最后几行。

如果日志里只是提示「Oxide.Compiler 预下载失败」,安装本身已经成功,服务器首次启动时会再尝试下载编译器,见下一条。

一直显示「启动中」

Rust 首次启动需要生成地图,还要加载 Oxide,通常需要几分钟;地图尺寸越大越慢。打开「控制台」观察日志:

  • 日志还在不断输出:耐心等待,出现 Server startup complete 后状态会变为「运行中」。
  • 停在 Downloading Oxide.Compiler:说明安装时编译器没有下载成功,服务器正在自己下载,网络慢时会等较长时间。可以继续等待;如果长时间没有进展,可以关机后点 重新安装,安装脚本会再次预下载编译器。
  • 日志不再变化,CPU 占用也接近 0:尝试重启;仍然卡住时,按下文检查内存和最近修改过的参数。

服务器异常退出 / 因内存不足被终止

  • 提示「服务器因内存不足被终止」:服务器用光了套餐内存。可以调小「世界尺寸」、卸载不需要的插件、降低「最大玩家数量」,或者升级套餐。
  • 提示「服务器异常退出(退出码 …)」:到「控制台」查看退出前最后的日志。常见原因有:
    • 「自定义地图URL」无效或地图文件损坏:清空该变量后让变量生效,再开机;
    • 「附加参数」或启动参数填写有误:把最近的修改改回去;
    • 插件报错导致崩溃:在「模组」页或 oxide/plugins 中暂时移除最近装的插件。

改了环境变量没有效果

环境变量保存后不会自动应用到当前容器,需要到「启动设置」页点一次 保存启动参数 重建容器,再开机。详细步骤见 服务器参数与地图。

玩家连不上服务器

  1. 确认实例状态为「运行中」,而不是「启动中」。
  2. 确认客户端使用的是「概览」页的主端口地址,端口是外网端口,而不是 28015。
  3. 在游戏内按 F1,用 client.connect 地址:端口 直连,不要依赖公共服务器列表。
  4. 用「概览」页的「Steam 在线人数查询」查一下:能查到结果说明服务器在线,问题多半出在客户端或玩家本地网络。

提示版本不一致或协议错误

Facepunch 更新 Rust 后,客户端会自动升级,而服务器的版本由平台统一维护,在平台更新之前,玩家可能会因为版本不一致而进不了服务器。

  • 实例的版本号显示在开服页和「启动设置」页的运行镜像名称中(例如 Steam 26498655)。
  • 平台更新 Rust 服务端版本后,在实例详情页点击 重新安装,就能把服务器文件和 Oxide 更新到新版本。重新安装会保留数据目录,但建议先备份 server 和 oxide 目录。
  • Rust 大版本更新通常会强制清档,旧存档可能无法在新版本上使用。

Rust+ 无法配对

Rust+ 要求 app.port 在容器内外使用同一个端口号,需要先申请对等端口并修改启动参数,步骤见 连接 Rust 服务器。

插件不生效

  • 确认「模组」页已安装列表里有这个插件,文件名与插件类名一致;
  • 在「控制台」或 oxide/logs/ 中搜索插件名,查看是否有编译错误;
  • 插件通常需要先授予权限才能使用,见 uMod/Oxide 插件。

平台控制台输入命令没有反应

管理命令请通过 RCON 执行,见 管理员与 RCON。

如何备份和迁移存档

平台不提供自动备份。请在「文件管理」中把 server 和 oxide 目录压缩后下载,或者通过 SFTP 下载。恢复时把这些目录上传回数据目录的相同位置,然后开机即可。