如何诊断 FiveM 服务器的崩溃和卡顿
找出 Linux FiveM 服务器崩溃或变慢的原因:日志、内存、hitch warnings、resmon、profiler,以及隔离出问题的资源。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
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然后在非高峰时段:
- 在 CFG Editor 中,在其
ensure行前加上#,以停用一半的可选资源。请保留框架及其依赖项。 - 重启服务器并尝试重现问题。
- 如果问题消失,则问题出在被停用的那一半。否则,问题出在仍处于启用状态的那一半。
- 对可疑的那一组重复此过程,直到只剩一个资源。
如果有多个资源由一个文件夹启动,例如 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 重新启动服务。