万圣节促销 使用优惠码 享终身 9 折

使用 MySQL 设置 选项卡设置 FiveM 数据库

添加您的许可证密钥,从您的套餐中免费创建 MariaDB 数据库,创建数据库用户并将连接字符串写入 server.cfg。

Last updated November 6, 2026

大多数 FiveM 框架,例如 QBCore、Qbox 和 ESX,都需要 MySQL 数据库。在 ServerPrism 上,MySQL 设置选项卡会引导您完成操作:它会设置您的许可证密钥,从您当前的套餐中创建 MariaDB 数据库服务器,创建数据库用户,并将连接字符串写入您的 server.cfg。本指南将逐步介绍该选项卡。

打开您的 FiveM 服务器,然后点击侧边栏中的MySQL 设置(在 FiveM 下)。页面顶部显示还剩下多少步骤。您可以随时跳过设置,稍后恢复设置。

步骤 1:FiveM 许可证密钥

FiveM 需要一个来自 keymaster.fivem.net 的免费许可证密钥。在此处登录,创建服务器密钥,复制它,将其粘贴到许可证密钥中,然后点击保存。

该密钥已保存到启动设置选项卡上的 FxServer 许可证密钥设置中,因此您也可以稍后在此处更改它。

如果您看到服务器端口需要注意,请点击自动修复端口。带有 txAdmin 的 FiveM 服务器需要三个连续的端口,并且 txAdmin 端口必须是其中之一;该修复程序会为您设置。没有 txAdmin 的服务器(参见步骤 5)会跳过此检查。

步骤 2:数据库服务器

您的数据库作为自己的小型服务器在您的 FiveM 服务器旁边运行。

  1. 选项卡显示您的套餐将如何拆分,例如“FiveM(此服务器)”和“MariaDB(新建)”,每个都带有其 RAM。没有额外费用:您的套餐资源在两者之间分配。
  2. 点击创建 MariaDB 服务器并确认。

您的 FiveM 服务器在拆分运行时会短暂重启。然后新的数据库服务器会自行启动。如果它稍后显示为离线,请点击启动数据库。

所有者还可以选择自定义拆分以在拆分服务器选项卡上选择大小。您也可以在此处撤消拆分。

步骤 3:数据库用户

点击配置数据库用户。我们创建一个用户和一个名为 fivem_db 的数据库,并使用一个强大的随机密码,并保存详细信息,这样您只需执行一次此操作。

然后您会看到txAdmin 设置的数据库详细信息:主机、端口、数据库名称、用户名和密码,每个都带有一个复制按钮。全部复制 (txAdmin 格式) 会一次性复制所有内容,可以直接粘贴到 txAdmin 的数据库步骤中。在没有 txAdmin 的服务器上,该卡片名为数据库详细信息,按钮名为全部复制;在您的资源中使用这些详细信息,或者让步骤 4 将它们写入 server.cfg。

同一张卡片上有一个重置密码按钮,用于在您需要新数据库密码时(参见下面的“更改数据库密码”)。

步骤 4:应用于 .cfg 文件

点击重新扫描,然后点击应用连接字符串。我们会检查您的 .cfg 文件并将类似这样的一行写入正确的文件中:

set mysql_connection_string "mysql://USER:PASSWORD@HOST:PORT/fivem_db?charset=utf8mb4"

如果尚不存在任何行,则会将其添加到您的服务器实际加载的 server.cfg 中。FXServer 加载的文件标记为活动;资源文件夹或配方模板中的其他 server.cfg 文件只是示例。

应用后重启您的服务器,以便 oxmysql 等资源获取新的连接。

步骤 5:启动服务器(并打开 txAdmin)

当所有步骤都完成(或跳过)后,会出现最后一张卡片,告诉您一切都已准备就绪。

  1. 点击启动服务器。FXServer 需要 30 到 60 秒才能上线。
  2. 点击打开 txAdmin。txAdmin URL 显示在卡片上,带有一个复制按钮。
  3. 第一次,txAdmin 会要求输入 PIN。您可以在控制台中找到它。
  4. 创建您的 txAdmin 管理员帐户,然后选择一个配方(QBCore、ESX 等)。当 txAdmin 要求提供数据库详细信息时,粘贴您在步骤 3 中复制的内容。

txAdmin 设置好您的配方后,返回MySQL 设置并再次运行步骤 4。配方通常会创建自己的 server.cfg,并且选项卡会使其连接字符串与它保持同步。

FiveM Enhanced 上没有 txAdmin,或者 txAdmin 已关闭。 FiveM Enhanced 服务器,以及启动设置上启用/禁用 TxAdmin 设置为 0 的 FiveM 服务器,直接从 server.cfg 启动,不运行 txAdmin。最后一张卡片会显示您的服务器直接从 server.cfg 启动。并且没有打开 txAdmin按钮。只有上面的步骤 1 适用:在文件管理器中添加您的资源,在 server.cfg 中列出它们并重启。

管理数据库

从您的服务列表中打开 MariaDB 服务器,并使用数据库管理器进行表、查询、导入和导出。打开数据库管理器会在新选项卡中打开它;访问链接在 5 分钟后过期。要从另一个主机移动数据库,请参阅备份、导入和导出数据库。

更改数据库密码

如果其他人看到了密码,请您自己为数据库用户设置一个新密码:

  1. 如果数据库服务器未运行,请启动它。该按钮仅在它在线时才有效。
  2. 在MySQL 设置上,点击数据库详细信息卡片上的重置密码。
  3. 在重置数据库密码?中,点击重置密码。旧密码会立即失效。
  4. 新密码窗口会显示新密码一次。点击复制并将其保存在安全的地方:为了您的安全,我们只在此处显示它,绝不会通过电子邮件发送。
  5. 点击应用连接字符串(步骤 4),以便 server.cfg 获取新密码,然后重启您的 FiveM 服务器。在此之前,服务器会一直尝试旧密码。

同时更新任何其他连接此数据库用户的应用程序。您也可以从 MariaDB 服务器上的数据库管理器中重置它。

常见问题

您看到什么 怎么做
脚本无法连接到数据库(例如 ECONNREFUSED) 检查 MariaDB 服务器是否正在运行,然后转到步骤 4 并将应用连接字符串应用到标记为活动的文件。重启 FiveM。
数据库 fivem_db 丢失 点击创建 fivem_db,然后重启您的 FiveM 服务器。
MariaDB 服务器必须运行才能配置用户 首先启动数据库服务器(启动数据库),等待它在线,然后重试。
在拆分之前支付您的待处理发票 在发票未结清时,拆分会被阻止。支付它,然后返回。
试用服务器上无法进行拆分 数据库步骤需要付费套餐。
txAdmin URL 不可用 首先启动服务器;txAdmin 只有在运行后才会响应。FiveM Enhanced,以及关闭 txAdmin 的 FiveM,根本没有 txAdmin。
密码重置后脚本丢失了数据库 点击MySQL 设置上的应用连接字符串并重启服务器。

有关 FiveM 的一般设置,请参阅GTA V:FiveM 入门。如果此页面上的内容与您所看到的不符,请提交支持工单,我们将与您一起解决。