设置您的 FiveM 服务器：许可证密钥、server.cfg 和资源

一个 FiveM 服务器需要三样东西才能运行：一个免费的 Cfx.re 许可证密钥、一个正常工作的 server.cfg 文件以及您的资源（脚本、地图和框架）。本指南将帮助您正确设置这三项，以便您的服务器启动并显示在服务器列表中。

1. 生成 Cfx.re 许可证密钥

每个 FiveM 服务器都需要一个来自 Cfx.re keymaster 的许可证密钥 — 它是免费的。

1. 访问 keymaster.fivem.net 并使用您的 Cfx.re（论坛）账户登录。
2. 点击 New server key / Register。
3. 对于 IP，您可以将密钥注册到您的服务器 IP，或者生成一个未列出的密钥（适用于大多数设置）。注意：密钥与您注册它的方式绑定，因此如果您更换服务器，可能需要新的密钥。
4. 复制密钥 — 它看起来像一长串随机字符串。

2. 将密钥添加到 server.cfg

1. 打开您的服务器并点击文件管理器。

2. 打开根目录中的 server.cfg。

3. 找到 sv_licenseKey 行（或添加一行）并粘贴您的密钥：

   sv_licenseKey your_key_here
   

4. 保存并从控制台选项卡重启。

如果没有有效的密钥，控制台将打印 Invalid license key 并且服务器将无法上线。

3. 理解 server.cfg

server.cfg 是您服务器的核心。您最常修改的行包括：

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My ServerPrism FiveM Server"
sv_maxclients 32
sets locale "en-US"

# Load resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey your_key_here

• sv_hostname — 您的服务器在 FiveM 服务器浏览器中的名称。
• sv_maxclients — 玩家槽位（默认构建最多 48 个）。
• ensure <name> — 在启动时启动一个资源。这是您启用脚本的方式。

不要更改端点端口，除非您了解您的分配。FiveM 的游戏端口由您的 ServerPrism 分配设置 — 默认的 30120 对于大多数服务器来说是正确的。如果不确定，请检查启动/网络选项卡。

4. 添加资源

资源（脚本、地图、框架，如 ESX 或 QBCore）放在 resources/ 文件夹中。

1. 通过文件管理器或 SFTP 将资源文件夹上传到 resources/（SFTP 更适合大型框架 — 请参阅 文件管理器和 SFTP）。
2. 为每个您想要运行的资源在 server.cfg 中添加一行 ensure <resource-name>。
3. 重启。观察控制台 — 每个资源加载时都会打印 Started resource <name>。

对于完整的角色扮演框架，请按照其文档指定的顺序安装其基础资源（通常是数据库 + 核心框架优先，然后是依赖脚本）。

数据库 (ESX/QBCore)

角色扮演框架需要 MySQL 数据库。在数据库选项卡上创建一个，并将框架的配置（通常通过 server.cfg 中的 mysql_connection_string 或框架配置文件）指向凭据。请参阅 创建并连接到 MySQL 数据库。

**同节点数据库怪癖：**如果您的数据库和 FiveM 服务器在同一个节点上，并且框架无法通过公共 IP 连接，请提交支持工单 — 这是一个已知的网络情况，我们可以通过桥接容器快速修复。

常见问题

• **Invalid license key：**密钥错误、过期或注册到不同的 IP — 在 keymaster 中重新生成。
• **服务器未显示在浏览器中：**它仍在启动，sv_hostname 未设置，或者某个资源出错 — 阅读控制台中的第一个 error。
• **资源启动失败：**检查控制台中该资源下的第一行错误；通常是缺少依赖项或无法访问的数据库。
• **ghmattimysql/oxmysql 错误：**数据库连接字符串错误 — 从数据库选项卡重新复制凭据。

仍然遇到问题？

提交支持工单，并附上控制台中的第一行 error 以及它提及的资源。我们可以直接深入节点上的配置进行调查。