中文

游戏服务器

如何诊断 FiveM 服务器的崩溃和卡顿

找出 Linux FiveM 服务器崩溃或变慢的原因:日志、内存、hitch warnings、resmon、profiler,以及隔离出问题的资源。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

FiveM 服务器崩溃或变慢,通常有明确的原因:某个资源、内存不足或机器负载饱和。本指南提供一套查找原因的方法:判断症状、查看正确的日志、测量,然后隔离出问题的资源。

前提条件

  • 已按照指南创建 FiveM 服务器安装服务器:fivem 用户、fivem.service 服务、控制台日志位于 /home/fivem/fxserver.log
  • 具有 sudo 权限的 SSH 访问,以及 txAdmin 的访问权限
  • 一份最新的备份,请在修改任何内容之前使用 sudo /usr/local/sbin/backup-fivem.sh 创建

判断症状

您观察到的现象 主要线索 参阅章节
服务器自行重启,所有玩家都被断开连接 进程停止或卡死 步骤 1 至 3
服务器无法再启动,或在加载时停止 资源或配置 步骤 4
玩家看到卡顿,载具瞬移 服务器过载 步骤 5 和 6
只有一位玩家的帧率很低 客户端问题 步骤 7
问题是在添加内容或更新之后开始的 最近的更改 步骤 8

步骤 1:保存日志

文件 /home/fivem/fxserver.log 在每次服务启动时都会被清空。请在重启任何内容之前先复制它:

终端
sudo install -o fivem -g fivem -m 640 /home/fivem/fxserver.log "/home/fivem/fxserver-incident-$(date +%F_%H-%M).log"

txAdmin 也会在 /home/fivem/txData/default/logs/ 中保存它自己的日志,并进行轮转:

文件 内容
fxserver.log 服务器控制台。旧文件的名称中带有日期
admin.log 管理员的操作和自动重启
server.log 游戏内事件:连接、死亡、消息、命令

这些文件包含玩家数据。请勿原样公开发布。

步骤 2:了解服务器为何重启

查找 txAdmin 做出的决定:

终端
sudo grep -a 'Restarting server' /home/fivem/txData/default/logs/admin.log | tail -n 20
显示的原因 含义 处理方法
Server process close detected FXServer 进程已停止 查看控制台末尾和内存(步骤 3)
Server is not responding FXServer 在运行,但不再响应 查找卡死的原因:步骤 5 和 6
Server is taking too long to start 启动超过了允许的时限 转到步骤 4
Resource "name" failed to start within the ... time limit 该资源阻塞了启动 在不加载它的情况下测试(步骤 8)

然后在步骤 1 所做的副本中,查看事件发生之前控制台的最后几行:

终端
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'

同时查看服务的历史记录:

终端
sudo systemctl status fivem.service --no-pager
sudo journalctl -u fivem.service --since "2 days ago" --no-pager | tail -n 40

步骤 3:检查内存和磁盘

内存不足时,Linux 内核会终止某个进程。请查找其痕迹:

终端
sudo journalctl -k --since "2 days ago" --no-pager | grep -iE 'out of memory|oom-kill|killed process'
free -h
df -h /home /var/lib/mysql
  • 出现 Out of memory: Killed process 这一行:服务器内存不足。请找出内存占用不断增长的资源,然后降低负载或增加机器的内存。
  • 某个磁盘已 100% 占满:请释放空间。MariaDB 和日志将无法再写入。

要追踪 FXServer 的内存随时间的变化,请在不同时间点运行以下命令。txAdmin 和游戏服务器会显示为两个进程,其中较大的通常是游戏服务器:

终端
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110

如果 RSS 列持续上升而从不回落,而玩家数量保持稳定,则说明某个资源可能存在内存泄漏。

步骤 4:分析启动失败

显示最近的加载事件:

终端
sudo grep -a -E "Started resource|Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log | tail -n 30
消息 原因 解决方法
Couldn't find resource name. 文件夹不存在,或名称与 ensure 行不一致 修正 server.cfg 或文件夹,然后输入 refresh
Couldn't start resource name. 启动失败 查看紧挨在它上面的几行
Could not find dependency x for resource y. 缺少资源 x 安装它
Could not start dependency x for resource y. 资源 x 存在但无法启动 先处理 x
Resource 'name' can't run: 某个条件未满足,例如 server needs to be 12913 or higher 更新 FXServer
Failed to load script file. 文件缺失或无效 重新安装该资源
SCRIPT ERROR: 脚本代码中的错误 消息会指出文件和行号:请更新,或向其作者反馈

如果是数据库错误,请参阅在 FiveM 上安装和配置 oxmysql。

步骤 5:找出服务器的卡顿

FXServer 通过 hitch warnings 报告其内部循环的延迟:

终端
sudo grep -a -c 'hitch warning' /home/fivem/fxserver.log
sudo grep -a 'hitch warning' /home/fivem/fxserver.log | tail -n 20
消息 触发阈值 涉及
server thread hitch warning 150 ms 主循环,服务器脚本在此运行
network thread hitch warning 150 ms 网络
sync thread hitch warning 100 ms OneSync 同步

启动时或资源重启时出现的单个警告不必担心。游戏中定期出现的警告则需要关注。Cfx.re 通常将其归因于性能不佳的资源,例如开销过大的循环或缓慢的 SQL 查询。

在怀疑某个资源之前,请先确认机器没有饱和:

终端
uptime
vmstat 1 10

在 vmstat 中,请查看三列:

列 值偏高时
id 偏低:处理器几乎被完全占用
wa 处理器在等待磁盘
st 部分处理器时间被虚拟机管理程序占用

然后查看各线程的详细情况,并将 PID 替换为步骤 3 中查到的最大进程的编号。使用 q 退出:

终端
top -H -p PID

如果只有一个线程接近 100%,说明服务器的某个循环已经饱和,即使机器还有其他空闲核心。这种情况下,增加核心帮助不大:更好的做法是减轻脚本的负担。如果服务器负载不高而 wa 或 st 仍然偏高,请通过客户区联系支持团队,并附上您的测量数据。

还要检查 oxmysql 报告的慢查询:

终端
sudo grep -a 'to execute a query' /home/fivem/fxserver.log | tail -n 20

步骤 6:记录服务器的性能分析文件

内置的 profiler 会显示哪个资源占用了时间。请在问题出现时,在 Live Console 中启动它,如有可能,最好有玩家在线:

文本
profiler record 500
profiler status

等到 profiler status 显示 Recording: No,然后保存结果:

文本
profiler saveJSON server-profile.json

该文件会创建在服务器文件夹中,其名称以 .base 结尾。请在服务器上将其复制到您的个人文件夹,并替换 FOLDER_NAME:

终端
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'
sudo install -o "$USER" -m 600 /home/fivem/txData/FOLDER_NAME.base/server-profile.json "$HOME/server-profile.json"
sudo rm /home/fivem/txData/FOLDER_NAME.base/server-profile.json

然后在您的电脑上获取它:

终端
scp 您的用户名@服务器IP:server-profile.json .

打开 Google Chrome,然后用 F12 打开开发者工具。在 Performance 选项卡中,使用 Load profile 加载该文件。找出活动曲线上的峰值,放大查看,然后阅读耗时最长的资源和函数的名称。

步骤 7:使用 resmon 在玩家端测量

resmon 显示每个资源在客户端的开销。它有助于排查帧率下降,而不适用于服务器的延迟。

在游戏中,用 F8 打开控制台并输入:

文本
resmon true

按 CPU msec 或 Time % 排序,找出开销大的资源,并查看 Memory 了解内存情况。输入 resmon false 关闭。

如果控制台返回 Access denied for command resmon,则说明您的客户端未启用开发者模式。请使用参数 +set moo 31337 启动 FiveM。对于 GTA V Enhanced 版的 FiveM,该参数已不存在,需要由服务器设置 sv_devMode true。

txAdmin 的 Player Drops 页面可以补充这项分析:它会显示玩家是否因其游戏崩溃而离开服务器,以及从何时开始。

步骤 8:隔离出问题的资源

先从最近更改的内容入手。如果没有任何更改,则采用二分法。

在已启动的服务器上快速测试

对于次要资源,请在 Live Console 中停止它,然后观察大约十分钟内的警告:

文本
stop resource_name

然后使用 ensure resource_name 重新启动它。请勿这样停止 oxmysql、es_extended、qb-core 或其他有大量资源依赖的资源:这会引发与问题无关的错误。

二分查找

请先备份配置,并替换 FOLDER_NAME:

终端
sudo -u fivem cp /home/fivem/txData/FOLDER_NAME.base/server.cfg /home/fivem/txData/FOLDER_NAME.base/server.cfg.before-diagnostic

然后在非高峰时段:

  1. 在 CFG Editor 中,在其 ensure 行前加上 #,以停用一半的可选资源。请保留框架及其依赖项。
  2. 重启服务器并尝试重现问题。
  3. 如果问题消失,则问题出在被停用的那一半。否则,问题出在仍处于启用状态的那一半。
  4. 对可疑的那一组重复此过程,直到只剩一个资源。

如果有多个资源由一个文件夹启动,例如 ensure [addons],请暂时将这一行替换为每个资源各一行 ensure。测试期间出现 Could not find dependency 错误,仅表示您停用了某个依赖项:请重新启用它。

找到该资源后,请更新它、修正其配置,或连同您的性能分析文件和日志一起向其作者反馈问题。然后还原原来的配置,并在 txAdmin 中重启服务器:

终端
sudo -u fivem cp /home/fivem/txData/FOLDER_NAME.base/server.cfg.before-diagnostic /home/fivem/txData/FOLDER_NAME.base/server.cfg

寻求帮助

对于资源问题,请联系其作者或前往 Cfx.re 论坛。请准备好:

  • FXServer 的构建号和 txAdmin 的版本,查看方法见更新 FXServer artifacts
  • 事件发生的时间,以及紧接着之前发生了哪些更改
  • 相关的控制台行、性能分析文件,以及 free -h 和 vmstat 的结果

Cfx.re 指出,FXServer 的 Linux 版本是出于便利而提供的移植版本:如果某个缺陷出自 FXServer 本身,在 Windows 下复现时更有可能得到修复。在报告之前,也请确认该问题在最新的推荐版本上仍然存在。

诊断过程中遇到问题

profiler saveJSON 返回 Invalid path

请使用不含文件夹的简单文件名,并确认 fivem 用户可以写入服务器文件夹。

A recording is already taking place

已有录制正在进行。请使用 profiler status 等待其结束,或使用 profiler record stop 停止它。

fxserver.log 文件是空的

服务刚刚重启过。请使用 /home/fivem/txData/default/logs/fxserver.log,以及同一文件夹中带日期的文件。

测试期间服务器不断重启

使用 sudo systemctl stop fivem.service 停止它,用上面的命令还原 server.cfg.before-diagnostic,然后使用 sudo systemctl start fivem.service 重新启动服务。