如何创建 FiveM 服务器

拥有您自己的 FiveM 服务器可以让您：

• 打造属于您自己的 GTA V 多人服务器：角色扮演、竞速、死亡竞赛或自由模式。
• 通过脚本、车辆、地图（MLO）和职业系统，完全自定义游戏玩法。
• 根据您的配置与托管方案，容纳 32 至 128 名玩家乃至更多。
• 围绕完全属于您的世界与规则，经营一个忠实的社区。

进入 2026 年，FiveM 依然是 GTA V 最活跃的多人游戏场景，由角色扮演以及 GTA V Enhanced 的到来共同推动。创建服务器从未如此简单：txAdmin 如今可直接在浏览器中完成从头到尾的整个安装流程。

FiveM（FXServer）主要是单线程运行的：处理器的主频比核心数量更为重要。请确认您的机器满足以下要求：

• ✔ RAM : 小型服务器至少 8 GB；脚本丰富的 ESX/QBCore 角色扮演服务器需 16 至 32 GB
• ✔ 处理器 : 4 个高主频核心（3.5 GHz 及以上）：单核速度比核心数量更关键
• ✔ 系统 : 64 位 Windows 或 Linux（生产环境服务器推荐 Linux）
• ✔ 连接 : 稳定的带宽与良好的延迟；服务器通过 TCP 和 UDP 监听 30120 端口
• ✔ 托管 : 本地 PC 用于测试，24/7 运行的公开服务器则使用配备 SSD/NVMe 存储的 VPS 或专用服务器

在安装之前，请先确定服务器的基础框架。它决定了您的玩家能够做些什么：

CFX Default（无数据库）

FiveM 的默认模板：自由模式，无需配置数据库。非常适合入门、测试，或搭建非角色扮演服务器（竞速、死亡竞赛、沙盒）。

ESX

经典的角色扮演框架：职业、经济、库存、公司系统。脚本生态极其庞大。需要 MySQL/MariaDB 数据库。

QBCore / Qbox

广受欢迎的现代角色扮演替代方案，模块化且维护活跃（Qbox 是其社区分支）。同样需要 MySQL/MariaDB 数据库。

FiveM 服务器依托于「artifacts」（FXServer），即 Cfx.re 官方的服务端软件。自较新的版本起，txAdmin 已内置其中：无需单独安装。

1. 前往 artifacts 页面（runtime.fivem.net），选择您的系统：Windows 或 Linux
2. 下载 Recommended 版本（稳定版，推荐用于生产环境），而非 Latest 版本
3. 将压缩包解压到一个专用于您服务器的文件夹（例如 server/）

Linux :

mkdir -p ~/fxserver && cd ~/fxserver
# Téléchargez l'archive .tar.xz depuis runtime.fivem.net, puis :
tar xf fx.tar.xz

txAdmin 是 FXServer 内置的网页管理面板。它可让您直接在浏览器中完成服务器的安装、启动与管理。

FXServer.exe

./run.sh

server.cfg 文件是整个配置的核心。txAdmin 会在部署时生成一份；以下是您需要了解的关键指令：

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

sv_hostname "Mon serveur FiveM"
sv_maxclients 48

# Ressources de base
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

# Base de données (ESX / QBCore)
set mysql_connection_string "mysql://user:password@localhost/fivem?charset=utf8mb4"

sv_licenseKey "VOTRE_CLE_KEYMASTER"

• sv_hostname - 显示在 FiveM 服务器列表中的服务器名称
• sv_maxclients - 最大玩家数（最高 2048；角色扮演服务器常见 32 至 64）
• sv_licenseKey - 您的 Keymaster 授权密钥，启动时必填
• endpoint_add_tcp / endpoint_add_udp - 监听地址与端口（默认 30120，TCP 和 UDP）
• ensure - 每个资源通过 ensure 加载；基础资源（mapmanager、chat、spawnmanager、sessionmanager、hardcap）必不可少
• mysql_connection_string - 对于 ESX/QBCore，请通过 oxmysql 填写 MySQL 连接字符串

您服务器的所有内容（脚本、地图、车辆、职业）都以资源的形式存在。管理方法如下：

ensure es_extended
ensure esx_menu_default

数据库（角色扮演框架）

ESX 和 QBCore 会将玩家、车辆和库存存储在 MySQL/MariaDB 数据库中。请创建数据库，导入框架的 .sql 文件，然后通过 oxmysql 资源进行连接。没有数据库，这些框架将无法启动。

FiveM 默认通过 TCP 和 UDP 使用 30120 端口。要让您的服务器能从互联网访问，必须开放该端口。

需要开放的端口

• TCP + UDP 30120 （默认，TCP 和 UDP，可在 server.cfg 中修改）
• txAdmin 的网页界面使用 40120 端口：请将其保留用于管理，切勿公开暴露

防火墙规则示例

Windows Defender :

New-NetFirewallRule -DisplayName "FiveM Server" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM Server UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow

Linux UFW :

sudo ufw allow 30120

Linux iptables :

sudo iptables -A INPUT -p tcp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30120 -j ACCEPT

txAdmin 让您可以在浏览器中集中管理服务器的方方面面：

• 实时查看并管理在线玩家（踢出、封禁、警告）
• 访问实时控制台，一键重启服务器
• 安排自动重启与公告
• 监控性能与稳定性，并具备防崩溃保护

• ✔ 备份：定期将您的数据库和 resources/ 文件夹备份到机器之外。请设置自动化：手动备份最终总会被遗忘。
• ✔ 更新：定期用较新的 Recommended 版本替换 artifacts，并让您的资源保持最新，以修复漏洞与 bug。

• ✔ 使用 resmon 命令监控每个资源的计算耗时：单单一个优化不佳的资源，就可能拖垮整个服务器的性能。
• ✔ 限制活跃资源的数量：每个脚本都会占用主线程的 CPU 时间。请逐个添加并测试。
• ✔ 使用 oxmysql（异步）与经过优化的查询：处理不当的数据库访问是角色扮演卡顿的常见原因。
• ✔ 将服务器托管在高主频 CPU 与 NVMe 存储上，并通过 txAdmin 安排定期重启，让服务器从干净的状态重新开始。