FiveM作为GTA5最流行的多人联机框架，让角色扮演（RP）玩法成为可能。不过搭建一个稳定运行的RP服务器并不是装个服务端就完事，尤其是当在线人数上来之后，高并发带来的性能压力和数据库瓶颈会集中爆发。这篇文章就从零开始讲解FiveM RP服务器的搭建流程，并重点分享高并发优化与数据库配置的实战方案。
FiveM服务器搭建基础流程
搭建FiveM服务器的第一步是申请服务器密钥。前往FiveM官方的Keymaster页面（ cider.mtxserv.com 已失效，正确入口是 keymaster.fivem.net），登录你的Cfx.re账号后绑定一台服务器，即可获得一串License Key。这个密钥绑定的是服务器IP，换机器时需要重新申请，建议提前规划好服务器位置。
接下来需要选择操作系统。大多数服务器管理员会选择Windows Server或Linux（推荐Ubuntu 22.04或Debian 12）。以Windows为例，先安装Git和Node.js环境，然后在某个盘符下新建目录，比如 D:\FXServer\，通过Git拉取 txAdmin（FiveM自带的管理面板）的启动文件。将 artifacts 下载解压后，整个目录结构大概是这样的：
D:\FXServer\ 存放服务端核心文件，D:\FXServer\server-data\ 存放资源配置和server.cfg配置文件。启动命令一般是这样的形式：D:\FXServer\FXServer.exe +set serverProfile default +exec server.cfg。第一次启动会进入txAdmin的初始化向导，按照提示设置管理员账号、端口（默认30120）、数据库连接信息即可。
RP服的核心资源与框架选择
RP服务器区别于普通服务器的地方在于脚本框架。目前主流的框架有两种：ESX和QBCore。ESX历史悠久、生态成熟、插件资源多，适合喜欢经典玩法的服务器；QBCore是后起之秀，代码结构更现代化、性能表现更好，社区更新也更活跃。新手建议从QBCore入手，文档齐全且问题容易搜到答案。
框架资源可以从GitHub上获取，例如QBCore官方仓库 qbx-framework。下载框架核心、qb-core、qb-inventory、qb-hud 等基础依赖资源后，放入 resources 目录，并在server.cfg中添加 ensure 语句逐行启动。注意启动顺序很重要，核心框架必须最先加载，否则依赖它的脚本会报错。
除了框架，RP服还需要一套原生身份系统、车辆系统、职业系统、房产系统等。这些脚本大多依赖数据库运行，这就引出了本文的重点：数据库配置不当是绝大多数RP服卡顿和数据丢失的根源。
高并发场景下的硬件与网络优化
所谓高并发，指的是同一时间大量玩家在线产生数据交互。一个50人在线的RP服，每秒可能产生数百次数据库读写操作，同时服务端要同步几十个玩家的位置、车辆、物品数据，CPU和网络压力都不小。
硬件选型方面，FiveM服务端是单线程为主的主循环架构，因此单核性能远比核心数量重要。推荐使用高主频CPU（如i9系列或锐龙9系列，主频5GHz以上），内存至少16GB起步，百人服建议32GB。硬盘务必使用NVMe固态，数据库读写对磁盘I/O非常敏感，机械硬盘会直接拖垮整个服务器。
网络方面，建议服务器带宽不低于100Mbps，且尽量选择延迟低的机房。如果玩家主要在国内，境外服务器延迟超过150ms体验会明显下降。另外，建议在server.cfg中合理设置以下参数：
- set onesync on：开启OneSync同步模式，支持更多玩家在线
- set onesync_population true：服务端控制NPC生成，减少客户端负担
- sv_maxclients：根据硬件情况设置，小型服设48，大型服可到128
脚本层面也要做减法。很多RP服卡顿的真正原因是资源过多、循环过密。检查各个脚本中的CreateThread或while true do循环，把等待时间过短（比如Wait(0)或Wait(100)）的循环改为合理间隔（Wait(1000)以上），能显著降低服务端CPU占用。
数据库配置方案详解
选择MariaDB还是MySQL
FiveM生态中最常用的数据库方案是MariaDB，它兼容MySQL协议且完全免费。Windows服务器推荐直接使用XAMPP集成环境快速部署，Linux服务器则通过apt或yum安装mariadb-server。也可以选择Docker部署，隔离性更好，方便后续迁移。
关键参数调优
默认安装的MariaDB配置是为小内存机器准备的，需要手动修改配置文件（Windows下一般是my.ini，Linux下是 /etc/mysql/mariadb.conf.d/50-server.cnf）。百人RP服建议参考以下参数：
| 参数 | 建议值 | 说明 |
|---|---|---|
| innodb_buffer_pool_size | 4G-8G | 缓冲池大小，设为物理内存的40%-60% |
| max_connections | 300 | 最大连接数，预留峰值余量 |
| innodb_log_file_size | 512M | redo日志大小，影响写入性能 |
| wait_timeout | 120 | 空闲连接超时，及时释放连接 |
修改后重启数据库服务生效。可以用 SHOW VARIABLES LIKE 语句验证参数是否生效，再用 SHOW PROCESSLIST 观察实际连接情况。
连接池设置
oxmysql（原名mysql-async）是目前FiveM最常用的数据库连接库。在config.js或server.lua中可以设置连接池大小，建议根据在线人数设置为最大玩家数的1.5到2倍。同时一定要开启连接复用，避免每次查询都新建连接，这是很多服务器数据库崩溃的直接原因。
慢查询与备份
开启慢查询日志（slow_query_log）并把 long_query_time 设为1秒，定期排查慢SQL。RP服中最常见的慢查询是玩家库存的逐条更新，应指导脚本开发者在更新物品时使用批量操作或事务，减少数据库往返次数。
数据备份方面，建议每天凌晨用mysqldump自动导出全量备份，保留最近7天的备份文件，并同步到另一台机器或对象存储上。RP服玩家数据丢失一次，损失的可能就是整个社区的信任。
日常运维与监控建议
服务器上线后不代表万事大吉。txAdmin自带服务器状态面板，可以实时查看在线人数、资源状态和性能图表。建议同时关注服务端控制台的resmon监控（按F8输入resmon），找出占用时间最长的资源，针对性优化。
建立完善的日志留存习惯，FiveM的日志存放在 server-data\logs\ 目录下，数据库日志则由MariaDB自身管理。遇到崩溃时，日志是定位问题的唯一线索。
最后提醒一点：任何资源上线前先在测试服验证，定期更新FiveM Artifact版本获取稳定性修复，重大版本更新前务必备份数据库和整个server-data目录。把这套流程坚持下来，你的RP服务器就能在高并发压力下保持稳定流畅，为玩家提供长期可靠的游戏体验。
FiveM服务器搭建RP服务器数据库GTA5角色扮演服务器修改时间：2026-09-03 04:04:57