Первичная настройка txAdmin

txAdmin уже входит в современные сборки FXServer и отдельно устанавливать его обычно не требуется.

Порядок первого запуска

1. Скачайте рекомендованные серверные артефакты.
2. Распакуйте их в отдельную папку.
3. Запустите FXServer.exe без параметров.
4. Откройте адрес, показанный в консоли.
5. Введите четырёхзначный PIN.
6. Свяжите панель со своим Cfx-аккаунтом.
7. Создайте резервный пароль.
8. Укажите название сервера.
9. Выберите готовый рецепт или собственный профиль.
10. Запустите Recipe Deployer.

Стандартный локальный адрес панели:

http://localhost:40120

Где находятся файлы профиля

Обычно txAdmin создаёт структуру:

txData\
└── ProfileName\
 ├── resources\
 ├── cache\
 └── server.cfg

Точный путь отображается в настройках профиля и зависит от выбранного каталога Recipe Deployer.

txAdmin не открывается

Проверьте:

• запущен ли FXServer без +exec;
• появился ли PIN в консоли;
• не используется ли порт 40120;
• не запущен ли второй экземпляр FXServer;
• разрешён ли локальный доступ в firewall;
• правильно ли указан адрес;
• не завершился ли процесс после ошибки;
• используются ли актуальные артефакты.

Проверка порта 40120 на Windows

netstat -ano | findstr :40120

Посмотреть процесс:

tasklist /FI "PID eq 1234"

Проверка на Linux

ss -lntp | grep 40120

Панель открывается только на сервере

localhost всегда указывает на текущий компьютер. Для удалённого администрирования требуется сетевой доступ к серверу, но не следует открывать txAdmin всему интернету без необходимости.

Безопаснее ограничить доступ своим IP, VPN-сетью или правилами firewall.

Ошибки профиля и Recipe Deployer

Recipe Deployer может остановиться из-за:

• отсутствия доступа к записи;
• неправильного каталога;
• недостатка места;
• ошибки загрузки файлов;
• недоступного GitHub-репозитория;
• неустановленной базы данных;
• ошибки YAML-рецепта;
• неверной строки подключения MySQL;
• антивирусной блокировки.

Не нажимайте Deploy несколько раз

Повторное развёртывание в уже заполненную папку может оставить дублирующиеся ресурсы и смешать файлы разных версий.

При неудачном развёртывании:

1. Сохраните журнал ошибки.
2. Проверьте доступное место.
3. Создайте новый пустой профиль.
4. Укажите новый каталог.
5. Повторите установку.
6. Не копируйте старый кэш в новый профиль.

Сервер запускает старый профиль

Проверьте активный профиль txAdmin, его путь к server.cfg и каталог данных. Удалять старый профиль до проверки нового не следует.

Какие порты использует FXServer

Стандартная конфигурация:

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

Изменение игрового порта

endpoint_add_tcp "0.0.0.0:30200"
endpoint_add_udp "0.0.0.0:30200"

После изменения обновите firewall, port forwarding, ссылку подключения, панель хостинга и настройки прокси.

Ошибка Address already in use

Пример:

Failed to bind to 0.0.0.0:30120
Address already in use

Windows

netstat -ano | findstr :30120

После определения PID:

tasklist /FI "PID eq 1234"

Linux

ss -lntup | grep 30120

или:

lsof -i :30120

Причиной может быть второй FXServer, тестовый сервер, Docker-контейнер или другая программа.

Не завершайте неизвестный процесс до проверки его назначения.

Открытие портов в Windows Firewall

Откройте PowerShell от имени администратора:

New-NetFirewallRule `
 -DisplayName "FiveM FXServer TCP" `
 -Direction Inbound `
 -Protocol TCP `
 -LocalPort 30120 `
 -Action Allow

New-NetFirewallRule `
 -DisplayName "FiveM FXServer UDP" `
 -Direction Inbound `
 -Protocol UDP `
 -LocalPort 30120 `
 -Action Allow

Для удалённого доступа к txAdmin создавайте отдельное ограниченное правило только при необходимости.

UFW на Linux

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw status

firewalld

sudo firewall-cmd --permanent --add-port=30120/tcp
sudo firewall-cmd --permanent --add-port=30120/udp
sudo firewall-cmd --reload

Облачный VPS

Помимо firewall операционной системы проверьте:

• security group;
• сетевой ACL;
• панель защиты хостинга;
• правила анти-DDoS;
• внешний firewall провайдера.

Настройка port forwarding на домашнем сервере

Направьте игровой порт на локальный IP компьютера:

Закрепите локальный IP через резервирование DHCP. После изменения адреса компьютера старые правила будут направлять трафик на другое устройство.

CGNAT

Признаки:

• сервер работает только в локальной сети;
• правила роутера не помогают;
• WAN-адрес роутера отличается от внешнего IP;
• провайдер выдаёт частный адрес;
• проверка порта всегда показывает закрытое состояние.

Варианты решения:

• заказать публичный IPv4;
• арендовать VPS;
• использовать игровой хостинг;
• настроить безопасный туннель с публичным входом.

Смена DNS не открывает входящие порты и не устраняет CGNAT.

Проверка прямого подключения

Запустите FiveM, нажмите F8 и введите:

connect IP:30120

Для локального сервера:

connect 127.0.0.1:30120

Проверка info.json

При работающем TCP-endpoint сервер может отдавать сведения по адресу:

http://IP:30120/info.json

Проверяйте внешний адрес с другого интернет-соединения, а не только с компьютера сервера.

FXServer отсутствует в списке серверов

Сначала проверьте прямое подключение. Если оно не работает, проблема не связана с отображением списка.

В server.cfg должны быть заполнены:

sets sv_projectName "My FiveM Project"
sets sv_projectDesc "Описание игрового проекта"
sv_hostname "My FiveM Server"

Проверьте:

• доступен ли порт 30120 извне;
• работают ли TCP и UDP;
• не включён ли sv_lan true;
• не установлен ли приватный режим;
• не блокирует ли хостинг исходящие соединения;
• не завершается ли FXServer после запуска;
• заполнены ли Project Name и Project Description;
• не используется ли неправильный внешний IP.

После запуска сервер может появиться в списке не мгновенно. Сначала убедитесь в стабильном прямом подключении.

Ошибки серверных артефактов FXServer

Артефакты содержат исполняемые файлы серверной платформы. Устаревшая версия может вызывать:

• End of Support;
• End of Life;
• Server artifact version is outdated;
• ошибки разбора современных скриптов;
• несовместимость с новым game build;
• проблемы Asset Escrow;
• ошибки Node.js или Lua API;
• несовпадение ревизии клиента и сервера.

Безопасное обновление артефактов

1. Остановите FXServer.
2. Сохраните старую папку server.
3. Скачайте рекомендованную сборку.
4. Распакуйте её в новый пустой каталог.
5. Не переносите старые DLL поверх новой версии.
6. Не удаляйте server-data или txData.
7. Запустите сервер с прежним профилем.
8. Проверьте ресурсы и подключение.
9. Только после проверки удалите старые артефакты.

Не обновляйте только FXServer.exe

Сборка содержит несколько связанных файлов. Частичная замена одного исполняемого файла может привести к несовместимости библиотек.

Latest или Recommended

Для рабочего проекта используйте рекомендованную стабильную сборку. Экспериментальные версии подходят для тестирования, но могут содержать новые изменения.

Подключение базы данных к FXServer

Для ресурсов ESX, QBCore и других framework часто используется oxmysql.

Строка подключения должна находиться перед запуском базы и framework:

set mysql_connection_string "mysql://fivem:ПАРОЛЬ@127.0.0.1:3306/fivem?charset=utf8mb4"

ensure oxmysql
ensure framework_core
ensure framework_resources

Альтернативный формат:

set mysql_connection_string "user=fivem;password=ПАРОЛЬ;host=127.0.0.1;port=3306;database=fivem"

ensure oxmysql

Правильный порядок запуска

ensure oxmysql
ensure es_extended
ensure esx_addons

или:

ensure oxmysql
ensure qb-core
ensure qb-resources

Если framework запускается раньше oxmysql, скрипты могут не получить объект базы или необходимые exports.

Основные ошибки MySQL и oxmysql

Unable to establish a connection

Проверьте:

• запущена ли MySQL или MariaDB;
• правильный ли host;
• правильный ли порт;
• существует ли база;
• верны ли пользователь и пароль;
• не содержатся ли специальные символы без правильного кодирования;
• разрешено ли подключение с FXServer;
• не блокирует ли соединение firewall.

ECONNREFUSED

По указанному адресу никто не принимает соединение. Если база находится на другом сервере, 127.0.0.1 использовать нельзя.

Проверка Windows:

Test-NetConnection 127.0.0.1 -Port 3306

Проверка Linux:

nc -vz 127.0.0.1 3306

Access denied for user

Проверьте пароль, разрешённый host пользователя и права на базу.

Учётные записи:

'fivem'@'localhost'
'fivem'@'127.0.0.1'
'fivem'@'10.0.0.%'

могут рассматриваться MySQL как разные варианты доступа.

Unknown database

База с указанным именем не существует или строка подключения содержит ошибку.

Table doesn't exist

Подключение установлено, но SQL-структура ресурса не импортирована. Проверьте дамп, миграции и выбранную базу.

Unknown column

Версия ресурса ожидает другую структуру таблицы. Не добавляйте случайные столбцы без документации конкретного скрипта.

Too many connections

Проверьте утечки соединений, количество пулов и ресурсы, создающие отдельное подключение для каждого запроса.

FXServer не запускает ресурсы

Типичные сообщения:

Couldn't find resource my_resource
Failed to start resource my_resource
No resource manifest found
Could not find dependency
No such export
Error parsing script

Сначала найдите первую ошибку в консоли. Последняя строка Failed to start resource часто является только результатом предыдущего сбоя.

Правильная структура

resources\
└── [custom]\
 └── my_resource\
 ├── fxmanifest.lua
 ├── client.lua
 └── server.lua

Неправильно:

resources\
└── my_resource-main\
 └── my_resource\
 └── fxmanifest.lua

Повторное сканирование ресурсов

refresh
ensure my_resource

Если ресурс не находится, проверьте:

• активный каталог resources;
• лишнюю вложенную папку;
• точное имя каталога;
• наличие fxmanifest.lua;
• права чтения;
• регистр символов на Linux;
• дублирующую копию ресурса.

Подробное исправление скриптов, fxmanifest.lua, ESX, QBCore, карт и автомобилей находится в статье об ошибках ресурсов FiveM.

Неправильный порядок запуска ресурсов

Общие зависимости запускаются раньше framework и дополнений:

# База данных
ensure oxmysql

# Библиотеки
ensure ox_lib

# Framework
ensure es_extended

# Системы framework
ensure esx_addonaccount
ensure esx_society
ensure esx_jobs

# Собственные скрипты
ensure custom_resources

Для QBCore:

ensure oxmysql
ensure qb-core
ensure qb-menu
ensure qb-input
ensure qb-target
ensure qb-inventory
ensure custom_qb_resources

Признаки неправильного порядка

• No such export;
• attempt to index a nil value;
• framework object не найден;
• MySQL object отсутствует;
• не зарегистрированы предметы или профессии;
• ресурс работает после ручного restart, но не при старте сервера.

Если ресурс начинает работать после ручного restart, его зависимость могла запускаться слишком поздно.

FXServer закрывается или аварийно завершается

Запускайте сервер из CMD или терминала, чтобы сохранить сообщение.

Проверьте:

• код завершения процесса;
• последний загружаемый ресурс;
• недавно обновлённые артефакты;
• сторонние DLL;
• плагины;
• доступную оперативную память;
• свободное место;
• ошибки накопителя;
• антивирус;
• права пользователя.

Проверка без сторонних ресурсов

1. Создайте резервную копию.
2. Отключите framework и дополнения.
3. Оставьте стандартные Cfx-ресурсы.
4. Запустите FXServer.
5. Возвращайте категории небольшими группами.
6. Найдите ресурс, после которого процесс завершается.

Нужно ли удалять серверный кэш

Кэш FXServer можно пересоздать при:

• повреждении временных данных;
• неправильном обновлении артефактов;
• запуске старой версии ресурса;
• ошибке после переноса профиля;
• конфликте старых серверных данных.

Перед очисткой:

1. Остановите FXServer.
2. Сохраните папку кэша.
3. Переименуйте:

cache → cache_backup

4. Запустите сервер.
5. Проверьте ресурсы.

Не удаляйте resources, server.cfg, txData или базу данных под видом очистки кэша.

Клиентский кэш игроков очищается отдельно. Инструкция находится в статье о папках cache, server-cache и server-cache-priv FiveM.

FXServer долго запускается

Причины:

• сотни ресурсов;
• антивирус проверяет каждый файл;
• ресурсы находятся на медленном HDD;
• в папке resources хранятся резервные копии;
• крупные карты и автомобили;
• медленные SQL-миграции;
• ресурсы скачивают внешние данные;
• ошибки вызывают повторные попытки подключения;
• недостаточно оперативной памяти;
• повреждённый накопитель.

Не храните архивы в resources

Перенесите из активного каталога:

• ZIP и RAR;
• резервные копии ресурсов;
• папки с суффиксами -old и -backup;
• исходные PSD и Blender-проекты;
• дампы базы;
• логи старых запусков.

Антивирус замедляет запуск

Проверьте загрузку диска и историю защиты. Не отключайте антивирус полностью на постоянной основе. При необходимости создайте точечное исключение только для проверенной серверной папки.

Hitch warning и высокая нагрузка

Пример:

server thread hitch warning: timer interval of 500 milliseconds

Сообщение означает, что серверный поток был заблокирован дольше ожидаемого.

Проверяйте:

• медленные SQL-запросы;
• бесконечные циклы;
• циклы без Wait;
• массовое сохранение игроков;
• обработку всех сущностей каждый тик;
• синхронное чтение больших файлов;
• внешние API-запросы;
• неоптимизированный framework;
• нагрузку процессора VPS.

Плохой цикл

CreateThread(function()
 while true do
 UpdateAllPlayers()
 end
end)

Цикл с интервалом

CreateThread(function()
 while true do
 Wait(1000)
 UpdateAllPlayers()
 end
end)

Интервал выбирается по задаче. Не каждое действие требует выполнения каждый кадр.

Проверка ресурсов

Отключайте необязательные категории небольшими группами и сравнивайте:

• время запуска;
• нагрузку CPU;
• память;
• время SQL-запросов;
• частоту hitch warning;
• пинг игроков.

Как читать журнал FXServer и txAdmin

Ищите первую ошибку, после которой появилась цепочка других сообщений.

[script:oxmysql] Unable to establish a connection
[script:framework] No such export query in resource oxmysql
[resources] Failed to start resource framework

Основная проблема — соединение oxmysql, а не последняя строка о framework.

Полезные данные

Сохраняйте:

• время ошибки;
• название ресурса;
• полный стек;
• номер строки;
• версию артефактов;
• активный профиль txAdmin;
• путь server.cfg;
• последнее успешное действие;
• результат чистого запуска;
• результат прямого подключения.

Не публикуйте полный server.cfg без очистки

Удалите лицензионный ключ, пароль базы, токены, webhook и административные идентификаторы.

FXServer не имеет доступа к файлам

На Windows проверьте:

• не находится ли сервер в защищённом системном каталоге;
• не включён ли контролируемый доступ к папкам;
• может ли пользователь изменять txData;
• не удерживает ли файл другой процесс;
• не блокирует ли архив антивирус.

Не устанавливайте рабочий сервер в:

C:\Windows\
C:\Program Files\

Проще использовать:

C:\FXServer\

Linux

Проверка прав:

ls -la ~/FXServer

Изменение владельца:

sudo chown -R fivem:fivem ~/FXServer

Не выдавайте всем файлам права 777 как постоянное решение.

Безопасность FXServer

• не публикуйте лицензионный ключ;
• не используйте стандартные пароли;
• не открывайте MySQL всему интернету;
• ограничивайте доступ к txAdmin;
• создайте отдельного пользователя базы;
• проверяйте сторонние ресурсы;
• не устанавливайте слитые платные скрипты;
• регулярно обновляйте артефакты;
• создавайте резервные копии базы;
• проверяйте клиентские события на серверной стороне;
• не запускайте процесс от root;
• храните резервные копии вне resources.

Резервная копия должна включать

• server.cfg и подключаемые конфигурации;
• resources;
• профиль txData;
• дамп MySQL;
• административные разрешения;
• конфигурацию голосового чата;
• файлы framework;
• актуальный список версий ресурсов.

Безопасный порядок обновления FXServer

1. Предупредите игроков о технических работах.
2. Остановите автоматические перезапуски.
3. Создайте дамп базы.
4. Сохраните txData и resources.
5. Скачайте рекомендованные артефакты.
6. Распакуйте их в отдельный каталог.
7. Подключите копию рабочего профиля.
8. Запустите сервер без игроков.
9. Проверьте oxmysql и framework.
10. Проверьте основные ресурсы.
11. Подключитесь через F8.
12. Проверьте список сервера.
13. Проверьте txAdmin.
14. Выполните тестовый рестарт.
15. Только затем обновляйте рабочий путь запуска.

Не обновляйте одновременно артефакты, framework, базу и все сторонние ресурсы. При одновременной замене сложно определить источник ошибки.

Быстрая диагностика FXServer

Проверка процессов

Windows:

tasklist | findstr /I FXServer

Linux:

ps aux | grep -i fxserver

Проверка игрового порта

Windows:

netstat -ano | findstr :30120

Linux:

ss -lntup | grep 30120

Проверка MySQL

Windows:

Test-NetConnection 127.0.0.1 -Port 3306

Linux:

nc -vz 127.0.0.1 3306

Прямое подключение FiveM

connect IP:30120

Пересканирование ресурсов

refresh

Запуск конкретного ресурса

ensure resource_name

Последовательность исправления FXServer

1. Создайте резервную копию сервера и базы.
2. Запустите FXServer через CMD или терминал.
3. Найдите первую ошибку.
4. Проверьте рабочий каталог.
5. Проверьте параметр +exec server.cfg.
6. Убедитесь, что редактируется активный server.cfg.
7. Проверьте sv_licenseKey.
8. Проверьте синтаксис конфигурации.
9. Запустите сервер без сторонних ресурсов.
10. Проверьте TCP- и UDP-endpoints.
11. Найдите процесс, занимающий порт.
12. Откройте порт 30120 в firewall.
13. Проверьте port forwarding.
14. Исключите CGNAT.
15. Выполните Direct Connect через F8.
16. Проверьте Project Name и Project Description.
17. Обновите устаревшие артефакты.
18. Проверьте строку подключения MySQL.
19. Запустите oxmysql раньше framework.
20. Импортируйте обязательные SQL-файлы.
21. Выполните refresh.
22. Запустите ресурсы через ensure.
23. Исправьте порядок зависимостей.
24. Проверьте права на файлы.
25. Проверьте нагрузку и hitch warning.
26. После теста настройте постоянный запуск.

Частые вопросы

Почему FXServer сразу закрывается?

Запустите его через CMD или терминал. Проверьте рабочий каталог, server.cfg, лицензию, порт и первую ошибку ресурсов.

Почему FXServer не видит server.cfg?

Файл находится в другом каталоге, имеет расширение .txt или сервер запущен без +exec server.cfg.

Почему появляется No license key specified?

Строка sv_licenseKey отсутствует, закомментирована или загружается другая конфигурация.

Почему лицензионный ключ недействителен?

Проверьте ключ в Cfx Portal, полноту копирования и активную регистрацию сервера.

Как открыть txAdmin?

Запустите FXServer.exe без +exec и откройте локальный адрес панели на порте 40120.

Почему txAdmin не показывает PIN?

Проверьте версию артефактов, способ запуска, занятый порт и предыдущий процесс FXServer.

Какой порт использует FiveM Server?

Стандартно используется 30120 TCP и UDP. txAdmin обычно использует отдельный TCP-порт 40120.

Нужно ли открывать порт 40120 игрокам?

Нет. Это административная панель, а не игровой endpoint.

Почему сервер работает локально, но недоступен друзьям?

Проверьте Windows Firewall, port forwarding, публичный IP и CGNAT.

Почему появляется Connection Refused?

FXServer не запущен, не слушает указанный endpoint либо соединение отклоняется firewall.

Почему появляется Timed Out?

Проверьте UDP-порт, NAT, потерю пакетов, нагрузку сервера и доступность хостинга.

Почему сервер не отображается в списке?

Проверьте прямое подключение, внешний порт, sv_projectName, sv_projectDesc и режим LAN.

Что означает Server artifact version is outdated?

Сервер использует устаревшую платформу. Владелец должен обновить полный комплект артефактов.

Можно ли заменить только FXServer.exe?

Не рекомендуется. Серверная сборка содержит связанные библиотеки, которые следует обновлять вместе.

Почему oxmysql не подключается?

Проверьте mysql_connection_string, службу базы, адрес, порт, пользователя, пароль и порядок запуска.

Почему framework работает только после restart?

Вероятно, зависимость или oxmysql запускается позже framework. Исправьте порядок ensure.

Почему ресурс не найден?

Проверьте активную папку resources, лишнюю вложенность, имя каталога и наличие fxmanifest.lua, затем выполните refresh.

Можно ли удалить серверный cache?

Да, после остановки FXServer. Безопаснее сначала переименовать папку и не трогать resources, txData и базу.

Почему FXServer долго запускается?

Проверьте число ресурсов, антивирус, скорость диска, резервные копии внутри resources и ошибки базы данных.

Что означает hitch warning?

Серверный поток был заблокирован тяжёлой операцией. Проверяйте циклы, SQL-запросы и ресурсы с высокой нагрузкой.

Нужно ли запускать FXServer от администратора?

Обычно нет. Серверу нужны права на собственные каталоги и порты, а не постоянные максимальные права системы.

Нужно ли запускать FXServer от root на Linux?

Нет. Используйте отдельного системного пользователя с ограниченным доступом.