如何搭建 FiveM 服务器

开始之前你需要准备什么

FiveM 是驱动自定义 GTA V 多人游戏的修改框架。服务器软件（FXServer）是免费的；玩家从免费的 FiveM 客户端加入，但他们每个人都需要一份正版 GTA V。在你搭建任何东西之前，先准备好这些：

• 一个 Cfx.re 账户和一个服务器许可密钥。可从 keymaster 免费获取，并且是启动服务器所必需的。我们将在下一步介绍。
• 一台保持开机的机器。FiveM 必须在公网连接上全天候运行。一台闲置的游戏 PC 可用于 LAN 测试，但真正的社区需要一台持久运行的 Linux 主机或托管服务——下面详述原因。
• 一个框架决定。大多数服务器运行 ESX 或 QBCore（角色扮演的职业、金钱、库存系统）；自由漫游和竞速服务器通常更接近独立模式。你以后可以改变主意。
• 一点时间。为你的第一次自行托管启动预留一个小时；托管服务器几分钟内就绪。

FiveM 比大多数游戏服务器更耗资源——RAM 和 CPU 单线程速度决定了它运行得多流畅，远比单纯的玩家数量重要。一个轻量或原版服务器用 6 GB 就够了；一个拥有 30-80 个资源的活跃 ESX/QBCore 服务器需要 8 GB；一个拥有 200 多个资源、自定义 MLO 和流式载入车辆的繁忙角色扮演服务器需要 12-16 GB。

第 1 步：获取免费的 Cfx.re 许可密钥

每个 FiveM 服务器都需要一个许可密钥。它是免费的，只需两分钟。

1. 登录 keymaster。前往 keymaster.fivem.net，用你的 Cfx.re（论坛）账户登录。
2. 注册一个新的服务器密钥。选择一个标签，选择“我将在专用机器上运行服务器”（也适用于托管），然后输入服务器将要运行的 IP 地址——如果你的 IP 可能变化，则生成一个可移植密钥。
3. 复制密钥。你将在接下来的步骤中把它作为 sv_licenseKey 粘贴到 server.cfg 中。

路径 A：使用 FXServer 和 txAdmin 自行托管 FiveM

这是完整的免费软件路径。现代 FXServer 直接启动进入 txAdmin，一个为你设置和运行服务器的网页面板，所以大部分工作都在浏览器中完成。这些步骤针对 Linux 主机（公共服务器的现实选择）；Windows 遵循相同的流程，使用 Windows 构件。

1. 下载 FXServer 构件。从 FiveM 构件页面获取最新的推荐版本（Linux 或 Windows），并将其解压到一个空文件夹中——这是服务器运行时。
2. 获取基础资源。在构件旁边克隆官方入门数据，这样服务器就有一套基础资源可供加载：

   git clone https://github.com/citizenfx/cfx-server-data.git server-data

3. 启动 FXServer 以打开 txAdmin。从构件文件夹中，运行服务器并指向一个数据文件夹。它会启动 txAdmin 并打印一个一次性 PIN 码和一个网址（默认端口 40120）：

   ./run.sh +set serverProfile default +set txAdminPort 40120

   在浏览器中打开该地址，输入 PIN 码，然后创建你的管理员账户。
4. 运行安装部署器。在 txAdmin 中，开始一个新的部署：将其指向你的 server-data，粘贴第 1 步中的 Cfx.re 许可密钥，让它构建你的 server.cfg。设置你的服务器名称、sv_maxclients（免费密钥最多 32）以及数据库连接（如果你的框架需要）。
5. 确认端点和许可证。你的 server.cfg 应包含这些要点——txAdmin 会管理它，但了解它写入了什么是值得的：

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"
   sv_licenseKey "your_key_here"
   sv_hostname "My FiveM Server"
   sv_maxclients 32
   ensure mapmanager
   ensure chat
   ensure spawnmanager
   ensure sessionmanager

6. 转发端口 30120。FiveM 在 TCP 和 UDP 上都使用端口 30120。在家庭连接上，登录你的路由器，找到端口转发（Port Forwarding），然后将 TCP 和 UDP 30120 转发到运行服务器的机器（先给它一个静态本地 IP）。
   注意：开放端口会公开你的家庭 IP，而 FiveM 服务器是攻击的热门目标。单个 booter 就能让你整个家庭断网，而家庭线路前面什么防护都没有。只有在你理解这个风险的情况下才公开自行托管。

   

这是一个可用的服务器。在你让它永久运行之前，权衡一下自行托管实际上让你付出了什么：

路径 B：租用托管的 FiveM 服务器（几分钟内上线）

托管服务器就是同样的 FXServer，只不过运行在数据中心而非你的家里——始终在线，有真正的 DDoS 防护，txAdmin 和最新构件都已就位。路径 A 中所有繁琐的事情（构件、端点、保持机器唤醒）都已处理好。以下是整个搭建过程：

1. 选择一个规格。在 FiveM 托管页面上，按 RAM 选择套餐：6 GB 用于轻量或起步服务器，8 GB 用于活跃的 ESX/QBCore 社区，12-16 GB 用于重度角色扮演。套餐每月几欧元起，每个都包含一个 MySQL 数据库。
2. 结账。付款后几分钟内服务器会自动配置完成——FXServer、txAdmin 和最新的 FiveM 构件都为你安装好了。你的面板详情会通过电子邮件送达。
3. 打开 txAdmin。登录面板，粘贴第 1 步中的 Cfx.re 许可密钥，设置你的服务器名称和槽位，然后启动服务器。无需下载任何东西，也无需转发任何端口。
4. 添加你的框架。通过文件管理器或 SFTP 上传或安装 ESX 或 QBCore，将它连接到附带的数据库，并在你的配置中 ensure 它——面板让数据库和文件访问变成一键操作。
5. 邀请玩家。分享你的地址，让人们可以在 FiveM 客户端中 connect 到它，或者发放你的 cfx.re join 链接。帮助运行服务器的朋友可以获得他们自己的面板子用户登录，而不必用你的密码。

具体来说，你所付费换来的是：无论你的 PC 是否开机，服务器都以 99.9% 的目标正常运行时间保持在线，Voxility 1 Tbps+ DDoS 防护吸收那些会击垮家庭线路的攻击，文件存放在配备高主频 CPU（FiveM 赖以运行的单线程速度）的 NVMe SSD 上，EU 节点让罗马尼亚、摩尔多瓦和巴尔干地区的延迟保持在低位，实时聊天支持在上午 8 点至晚上 11 点（基希讷乌时间）提供。迁移现有服务器是免费的。

框架和资源：ESX、QBCore 以及添加脚本

一个空白的 FiveM 服务器就是一座空城。框架和资源才是把它变成角色扮演世界、漂移服务器或竞速联赛的东西。

• ESX——历史悠久的角色扮演框架：职业、金钱、库存、庞大的社区脚本库。成熟且文档丰富。
• QBCore——新角色扮演服务器的现代宠儿，积极开发，结构清晰，拥有庞大的现成职业和系统生态。
• 独立模式——完全没有框架。最适合不需要金钱和职业系统的自由漫游、竞速或小游戏服务器。

添加资源始终是同一个模式：把资源文件夹放入服务器的 resources/ 目录，然后在 server.cfg 中用一行加载它：

ensure resource-name

重启服务器（或从 txAdmin 刷新并启动该资源），它就上线了。存储数据的框架——金钱、角色、车辆——需要一个 MySQL 数据库和 oxmysql 资源来与之通信，这正是我们的 FiveM 套餐包含数据库的原因。

让你的服务器保持在线和安全

有几件事把能长久运行的 FiveM 服务器和在第一周就夭折的服务器区分开来：

• 认真对待 DDoS。FiveM 服务器经常受到攻击，尤其是竞技性角色扮演服务器。家庭连接没有防护；数据中心托管在互联网和你的服务器之间放置专用过滤（在我们这里是 Voxility）。
• 备份你的数据库和资源。你的 MySQL 数据库保存着每一个角色、职业和车辆——这是唯一一样你无法重新下载的东西。在添加或更新大型资源之前给它做个快照。
• 了解你真正的槽位上限。sv_maxclients 可以设得更高，但免费的 Cfx.re 密钥无论如何都把你限制在 32 名玩家——只有在升级你自己的 Element Club 密钥之后才提高它。
• 保持构件最新，但不要用最尖端的。坚持使用推荐的构件版本；全新的版本可能破坏资源。在托管套餐上，这会为你处理好。