Rust 常见问题
Rust 服务器安装失败、一直启动中、内存不足、版本不一致、连不上、参数不生效、插件不加载等问题的排查方法。
Rust · 更新于
排查时先看哪里
| 位置 | 能看到什么 |
|---|---|
| 实例卡片下方的提示条 | 安装失败、服务器异常退出、因内存不足被终止等状态说明 |
| 「查看安装日志」 | 安装脚本的输出,安装阶段出错时看这里 |
| 「控制台」标签页 | 服务器运行日志,以及 CPU、内存、网络、磁盘占用 |
文件管理中的 oxide/logs/ |
Oxide 和插件的日志 |
安装失败
实例状态显示「安装失败」时:
- 点击提示条上的「查看日志」,看最后几行的错误信息。如果是「下载 Rust 服务端失败」「下载 Oxide 失败」这类下载错误,一般是临时网络问题。
- 点击 重新安装 再试一次。重新安装会保留数据目录。
- 多次重装都失败时,请联系客服,并附上安装日志的最后几行。
如果日志里只是提示「Oxide.Compiler 预下载失败」,安装本身已经成功,服务器首次启动时会再尝试下载编译器,见下一条。
一直显示「启动中」
Rust 首次启动需要生成地图,还要加载 Oxide,通常需要几分钟;地图尺寸越大越慢。打开「控制台」观察日志:
- 日志还在不断输出:耐心等待,出现
Server startup complete后状态会变为「运行中」。 - 停在
Downloading Oxide.Compiler:说明安装时编译器没有下载成功,服务器正在自己下载,网络慢时会等较长时间。可以继续等待;如果长时间没有进展,可以关机后点 重新安装,安装脚本会再次预下载编译器。 - 日志不再变化,CPU 占用也接近 0:尝试重启;仍然卡住时,按下文检查内存和最近修改过的参数。
服务器异常退出 / 因内存不足被终止
- 提示「服务器因内存不足被终止」:服务器用光了套餐内存。可以调小「世界尺寸」、卸载不需要的插件、降低「最大玩家数量」,或者升级套餐。
- 提示「服务器异常退出(退出码 …)」:到「控制台」查看退出前最后的日志。常见原因有:
- 「自定义地图URL」无效或地图文件损坏:清空该变量后让变量生效,再开机;
- 「附加参数」或启动参数填写有误:把最近的修改改回去;
- 插件报错导致崩溃:在「模组」页或
oxide/plugins中暂时移除最近装的插件。
改了环境变量没有效果
环境变量保存后不会自动应用到当前容器,需要到「启动设置」页点一次 保存启动参数 重建容器,再开机。详细步骤见 服务器参数与地图。
玩家连不上服务器
- 确认实例状态为「运行中」,而不是「启动中」。
- 确认客户端使用的是「概览」页的主端口地址,端口是外网端口,而不是 28015。
- 在游戏内按 F1,用
client.connect 地址:端口直连,不要依赖公共服务器列表。 - 用「概览」页的「Steam 在线人数查询」查一下:能查到结果说明服务器在线,问题多半出在客户端或玩家本地网络。
提示版本不一致或协议错误
Facepunch 更新 Rust 后,客户端会自动升级,而服务器的版本由平台统一维护,在平台更新之前,玩家可能会因为版本不一致而进不了服务器。
- 实例的版本号显示在开服页和「启动设置」页的运行镜像名称中(例如
Steam 26498655)。 - 平台更新 Rust 服务端版本后,在实例详情页点击 重新安装,就能把服务器文件和 Oxide 更新到新版本。重新安装会保留数据目录,但建议先备份
server和oxide目录。 - Rust 大版本更新通常会强制清档,旧存档可能无法在新版本上使用。
Rust+ 无法配对
Rust+ 要求 app.port 在容器内外使用同一个端口号,需要先申请对等端口并修改启动参数,步骤见 连接 Rust 服务器。
插件不生效
- 确认「模组」页已安装列表里有这个插件,文件名与插件类名一致;
- 在「控制台」或
oxide/logs/中搜索插件名,查看是否有编译错误; - 插件通常需要先授予权限才能使用,见 uMod/Oxide 插件。
平台控制台输入命令没有反应
管理命令请通过 RCON 执行,见 管理员与 RCON。
如何备份和迁移存档
平台不提供自动备份。请在「文件管理」中把 server 和 oxide 目录压缩后下载,或者通过 SFTP 下载。恢复时把这些目录上传回数据目录的相同位置,然后开机即可。
