RU

Игровые серверы

Как диагностировать сбои и тормоза сервера FiveM

Найдите причину сбоя или замедления на вашем Linux-сервере FiveM: журналы, память, hitch warnings, resmon, профилировщик и изоляция виновного ресурса.

8 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

У сервера FiveM, который падает или тормозит, часто есть конкретная причина: ресурс, нехватка памяти или перегруженная машина. Это руководство предлагает метод, как её найти: определить симптом, прочитать нужные журналы, выполнить измерения, затем изолировать виновный ресурс.

Предварительные требования

  • Сервер, установленный по руководству Создание сервера FiveM: пользователь fivem, сервис fivem.service, консоль в /home/fivem/fxserver.log
  • SSH-доступ с sudo и доступ к 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: Ошибка в коде скрипта Сообщение указывает файл и строку: обновите ресурс или сообщите об ошибке его автору

При ошибке базы данных обратитесь к руководству Установка и настройка oxmysql на FiveM.

Шаг 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 мс Основной цикл, в котором выполняются серверные скрипты
network thread hitch warning 150 мс Сеть
sync thread hitch warning 100 мс Синхронизация 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: запись профиля сервера

Встроенный профилировщик показывает, какой ресурс потребляет время. Запустите его в 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, режим разработчика на вашем клиенте не включён. Запустите FiveM с аргументом +set moo 31337. В FiveM для GTA V Enhanced этого аргумента больше нет, и сервер должен задать sv_devMode true.

Страница Player Drops в txAdmin дополняет этот анализ: она показывает, покидают ли игроки сервер из-за сбоев своей игры, и с какого момента.

Шаг 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
  • момент инцидента и то, что изменилось незадолго до него
  • соответствующие строки консоли, профиль и результаты free -h и vmstat

Cfx.re напоминает, что Linux-версия FXServer — это порт, предлагаемый для удобства: если дефект связан с самим 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.