亿讯云-知识库

Appearance

如何开启幻兽帕鲁 REST API 在线管理？ ​

亿讯云专注于游戏服务器联机，为您带来更方便的幻兽帕鲁服务器管理体验！

教程前言 ​

INFO

开启 REST API 后，可以在亿讯云后台的 在线管理 页面查看服务器状态、在线玩家、服务器版本、运行时间等信息，并使用在线管理功能操作服务器。

TIP

本教程适用于第一次使用 幻兽帕鲁在线管理，或页面提示 REST API 无法连接的情况。

WARNING

配置 REST API 前，请先关闭服务器。管理员密码、REST 端口等配置保存后，需要重新启动服务器才会生效。

1. 关闭服务器 ​

INFO

进入服务器后台顶部菜单的 控制台，点击右侧的 停止 按钮，先将服务器完全关闭。

关闭幻兽帕鲁服务器

WARNING

请等待服务器状态显示为 Offline / 离线 后，再继续修改管理员密码和 REST 配置。

2. 在启动页面配置管理员密码 ​

INFO

服务器关闭后，点击顶部菜单的 启动，找到 管理员密码。

填写一个你自己设置的管理员密码，并保存启动变量。

在启动页面配置管理员密码

TIP

管理员密码用于 REST API 身份验证，后面在在线管理页面中需要填写相同的密码。

WARNING

请记住这里填写的管理员密码。在线管理页面填写的密码必须与启动页面中的管理员密码完全一致。

3. 在在线管理中一键开启 REST 并分配端口 ​

INFO

点击顶部菜单的 在线管理，进入 REST配置 页面。

进入在线管理的 REST 配置页面

INFO

请按照下面的顺序配置：

  1. 删除 REST 端口输入框中默认填写的 8212；
  2. 保持 REST 端口为空；
  3. 在密码输入框中填写刚才启动页面设置的 管理员密码；
  4. 确认 保存时自动确保翼龙端口存在 已勾选；
  5. 点击 一键开启并分配端口。

WARNING

这里不要继续使用默认的 8212 端口。

请先把端口内容删除并保持为空，让系统自动从当前服务器可用的网络端口中分配 REST 端口。

清空端口并填写管理员密码

INFO

操作成功后，页面会自动：

  • 开启 RESTAPIEnabled；
  • 自动分配一个可用的 REST 端口；
  • 将 REST 端口写入 PalWorldSettings.ini；
  • 将管理员密码写入 REST 配置；
  • 提示需要重启服务器后再连接。

REST 端口自动分配完成

TIP

图中自动分配的端口仅为示例。每台服务器实际分配到的 REST 端口可能不同，请以你自己后台显示的端口为准。

4. 返回控制台启动服务器 ​

INFO

REST 配置完成后，返回顶部菜单的 控制台，点击右侧的 开机。

返回控制台启动服务器

TIP

启动后请耐心等待控制台完成 SteamCMD 检查和幻兽帕鲁服务端启动。

不要在服务器刚开机时立即连续点击连接，建议等待服务器状态显示为 running 后再进入在线管理。

5. 查看 REST 是否连接成功 ​

INFO

服务器启动完成后，再次进入顶部菜单的 在线管理。

如果页面中的 连接状态 显示：

  • 已连接
  • REST API 工作正常

就说明 REST API 已经开启成功，可以正常使用在线管理功能。

REST API 已连接

TIP

连接成功后，可以在在线管理页面查看：

  • 服务器名称
  • 游戏版本
  • 在线人数
  • 服务器 FPS
  • 运行时长
  • 据点和游戏天数
  • 在线玩家
  • 服务器操作

常见问题 ​

1. 为什么在线管理提示无法连接 REST API？ ​

请依次检查：

  • 服务器是否已经正常启动；
  • 控制台状态是否已经显示为 running；
  • 启动页面是否填写了管理员密码；
  • 在线管理中填写的密码是否与启动页面一致；
  • 是否点击过 一键开启并分配端口；
  • REST 端口是否已经自动分配；
  • 修改配置后是否重新启动过服务器。

2. REST 端口为什么不能直接填写 8212？ ​

8212 是常见默认端口，但不一定已经分配给你的翼龙服务器。

如果直接使用一个没有在服务器网络设置中分配的端口，REST API 即使已经开启，也可能无法从外部连接。

因此本教程建议：

删除默认 8212 → 保持端口为空 → 点击一键开启并分配端口

由系统自动选择当前服务器可用的端口会更稳妥。

3. 为什么点击一键开启后还是不能连接？ ​

一键开启后，配置虽然已经写入，但服务器进程仍然在使用旧配置。

请返回控制台执行一次：

停止服务器 → 开机

或者在服务器正常运行时点击 重启，等待服务器重新启动完成后再连接。

4. 管理员密码可以随便填写吗？ ​

可以自行设置，但建议使用包含字母和数字的密码，并避免过于简单。

同时必须保证下面两个位置完全一致：

  • 启动 → 管理员密码
  • 在线管理 → REST 配置密码

5. 自动分配的 REST 端口需要复制吗？ ​

通常不需要手动复制。

系统自动分配后，会直接显示在在线管理页面，并写入服务器配置。服务器重启后，在线管理会使用该端口连接。

6. 服务器启动后多久可以连接？ ​

一般建议等待控制台状态显示为 running，并继续等待十几秒后再连接。

如果服务器刚启动、正在加载存档或 MOD，REST API 可能暂时还未完全就绪。

教程结束 ​

TIP

完整流程就是：

关闭服务器 → 启动页面设置管理员密码 → 在线管理进入 REST 配置 → 删除默认 8212 并保持端口为空 → 填写管理员密码 → 点击一键开启并分配端口 → 返回控制台开机 → 在线管理显示已连接

INFO

如果仍然无法连接，请复制控制台最后一段启动日志并提交工单联系我们：

联系我们