RU

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

Как установить ESX или QBCore на сервер FiveM

Выберите между ESX Legacy и QBCore, подготовьте базу данных MariaDB, разверните фреймворк с помощью txAdmin на вашем Linux-сервере, проверьте результат и при необходимости откатите изменения.

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

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

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

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

ESX Legacy и QBCore — это фреймворки для ролевой игры (roleplay): они добавляют в FiveM персонажей, профессии, деньги и инвентарь. Это руководство поможет выбрать один из них, а затем развернуть его с помощью txAdmin, не потеряв текущую конфигурацию.

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

  • Сервер, установленный по руководству Создание сервера FiveM: пользователь fivem, сервис fivem.service, скрипт /usr/local/sbin/backup-fivem.sh
  • Установленная MariaDB с базой данных fivem и пользователем fivem, созданными в разделе о MariaDB этого руководства
  • Пароль этого пользователя MariaDB
  • Ваш лицензионный ключ cfxk_ и основная учётная запись администратора txAdmin

Выбор между ESX и QBCore

Оба фреймворка решают одну и ту же задачу. Решающий критерий — список ресурсов, которые вы собираетесь использовать: ресурс, написанный для одного фреймворка, не работает как есть на другом.

Критерий ESX Legacy QBCore
Развёртывание в txAdmin Popular Recipes, рецепт ESX Legacy Remote URL Template, с адресом рецепта
Основной ресурс es_extended qb-core
Основные зависимости oxmysql, esx_lib oxmysql
Таблица игроков users players
Права игроков Группы хранятся в базе данных, изменяются командой setgroup Уровни god, admin и mod, управляемые правами ACE
OneSync Включается рецептом Включается рецептом
Документация docs.esx-framework.org qbcore.org/docs

Как принять решение:

  • Выбирайте ESX Legacy, если хотите пойти по пути, который txAdmin предлагает напрямую, или если нужные вам ресурсы написаны для ESX.
  • Выбирайте QBCore, если нужные вам ресурсы написаны для QBCore или если ваша команда уже с ним знакома.
  • Посмотрите также на Qbox, если вы сомневаетесь в пользу QBCore: txAdmin предлагает его рецепт в Popular Recipes и описывает его как совместимый с ресурсами QBCore. В этом руководстве его установка не рассматривается.

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

Шаг 1: резервное копирование сервера

Запустите скрипт резервного копирования и убедитесь, что архивы действительно созданы:

Терминал
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Запишите дату двух последних файлов, fivem_DATE.tar.gz и fivem_db_DATE.sql.gz. Они понадобятся для отката.

Шаг 2: подготовка базы данных

Убедитесь, что MariaDB работает, и подсчитайте таблицы в базе данных fivem:

Терминал
sudo systemctl is-active mariadb
sudo mariadb -N -e "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='fivem';"
  • Результат равен 0: база данных пуста, используйте fivem и переходите к шагу 3.
  • Результат больше 0: база данных уже содержит данные. Создайте для фреймворка другую, как показано ниже.
Терминал
sudo mariadb
SQL
CREATE DATABASE fivem_rp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON fivem_rp.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Затем укажите эту базу данных в скрипте резервного копирования, иначе она не будет сохраняться:

Терминал
sudo sed -i 's/^DB_NAME="fivem"$/DB_NAME="fivem_rp"/' /usr/local/sbin/backup-fivem.sh
sudo grep '^DB_NAME' /usr/local/sbin/backup-fivem.sh

Далее, когда речь идёт об имени базы данных, заменяйте fivem на fivem_rp.

Если вы потеряли пароль, сгенерируйте новый командой openssl rand -hex 16, затем примените его в sudo mariadb:

SQL
ALTER USER 'fivem'@'localhost' IDENTIFIED BY 'GENERATED_PASSWORD';

Если этот аккаунт уже использует какой-либо существующий сервер, обновите также его строку mysql_connection_string.

Шаг 3: возврат к мастеру txAdmin

Пропустите этот шаг, если сервер ещё не развёртывался: txAdmin уже показывает мастер настройки.

В противном случае откройте txAdmin через SSH-туннель, затем:

  1. Перейдите в Settings, вкладка FXServer.
  2. Скопируйте значение Server Data Folder и сохраните его: это путь к вашему текущему серверу.
  3. Нажмите Reset, затем подтвердите.

Это действие останавливает сервер и возвращает txAdmin к мастеру настройки. Оно не удаляет ни файлы ресурсов, ни базу данных.

Шаг 4: запуск развёртывания

В мастере задайте название сервера, затем выберите рецепт:

  • ESX Legacy: выберите Popular Recipes, затем ESX Legacy.
  • QBCore: выберите Remote URL Template, затем вставьте этот адрес:
Текст
https://raw.githubusercontent.com/qbcore-fivem/txAdminRecipe/main/qbcore.yaml

Оставьте предложенную папку назначения и перейдите к Recipe Deployer. Вставьте ваш ключ cfxk_, затем нажмите Show/Hide Database options (advanced) и заполните:

Поле Значение
Database Host 127.0.0.1
Database Port 3306
Database Username fivem
Database Password Пароль пользователя fivem
Database Name fivem (или fivem_rp)
Delete Database Отключено

Нажмите Run Recipe. Развёртывание загружает множество ресурсов и может занять несколько минут. По окончании нажмите Save & Run Server.

Шаг 5: проверка установки

Подождите около минуты, затем найдите в консоли подключение к базе данных и запуск фреймворка:

Терминал
sudo grep -a -E 'Database server connection established|Started resource (es_extended|qb-core)' /home/fivem/fxserver.log

Вы должны увидеть строку о подключении к базе данных и строку о es_extended или qb-core. Затем проверьте, что сервер объявляет эти ресурсы:

Терминал
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"(oxmysql|es_extended|qb-core)"'

Наконец, убедитесь, что рецепт создал таблицу игроков:

Терминал
# ESX Legacy
sudo mariadb fivem -e "SHOW TABLES LIKE 'users';"

# QBCore
sudo mariadb fivem -e "SHOW TABLES LIKE 'players';"

Затем подключитесь к игре командой connect IP_СЕРВЕРА:30120 и создайте персонажа. После этого в этой таблице должна появиться строка.

Шаг 6: получение прав администратора

  • ESX Legacy: подключитесь к серверу, найдите свой номер игрока в списке подключённых игроков txAdmin, затем введите в Live Console setgroup 1 admin, заменив 1 этим номером. Группа сохраняется в таблице users.
  • QBCore: добавьте свой идентификатор в группу qbcore.god, как описано в руководстве Управление правами ACE на FiveM.

Создайте также новую резервную копию: теперь это ваша основная точка возврата.

Терминал
sudo /usr/local/sbin/backup-fivem.sh

Откат

Эта процедура восстанавливает сервер и базу данных в том состоянии, в котором они были на шаге 1. Замените DATE записанной датой.

Терминал
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.framework
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
sudo mariadb -e "DROP DATABASE fivem; CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
zcat /home/fivem/backups/fivem_db_DATE.sql.gz | sudo mariadb fivem
sudo systemctl start fivem.service

Если вы создавали fivem_rp, архив шага 1 содержит исходную базу данных fivem, которая не изменялась: не выполняйте строки DROP DATABASE и zcat. Вместо этого удалите fivem_rp командой sudo mariadb -e "DROP DATABASE fivem_rp;", затем верните DB_NAME="fivem" в скрипте резервного копирования.

Папка /home/fivem/txData.framework сохраняет результат пробной установки. Удалите её, когда она больше не нужна.

При возникновении проблем

Database connection failed

Это сообщение появляется в Recipe Deployer и сопровождается причиной:

  • connect ECONNREFUSED 127.0.0.1:3306: MariaDB не запущена. Проверьте командой sudo systemctl status mariadb.
  • Access denied for user 'fivem'@'localhost': пароль неверен.
  • Access denied for user 'fivem'@'127.0.0.1': добавьте эту учётную запись по руководству Установка и настройка oxmysql на FiveM.

Access denied for user 'fivem'@'localhost' to database

Поле Database Name содержит имя, отличное от fivem. По умолчанию txAdmin подставляет туда идентификатор развёртывания, а у пользователя fivem нет никаких прав на эту базу данных. Исправьте поле.

Table 'addon_account' already exists

Рецепт ESX уже запускался на этой базе данных, например при прерванном развёртывании. Если в базе нет ничего полезного, очистите её, затем запустите рецепт снова:

Терминал
sudo mariadb -e "DROP DATABASE fivem; CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

Развёртывание останавливается во время загрузки

Рецепты загружают много файлов с GitHub, который может временно ограничивать запросы. Подождите несколько минут, затем перезапустите развёртывание. Проверьте также свободное место на диске командой df -h /home.

Рецепт не отображается или txAdmin считает его несовместимым

QBCore отсутствует в Popular Recipes: используйте Remote URL Template. Если txAdmin сообщает Some recipes are not compatible with your txAdmin version, обновите FXServer: txAdmin входит в его состав.

Could not find dependency oxmysql for resource es_extended

Ресурс oxmysql отсутствует или находится не на своём месте. То же сообщение существует для qb-core и для esx_lib. Проверьте его наличие по руководству Установка и настройка oxmysql на FiveM.

Resource 'oxmysql' can't run

Если следующая строка содержит server needs to be 12913 or higher, ваша версия FXServer слишком старая для этой версии oxmysql. Обновите FXServer.

Table 'fivem.users' doesn't exist

Строка подключения указывает на другую базу данных, а не на ту, в которую выполнялось развёртывание, либо импорт SQL не завершился. Сравните mysql_connection_string в CFG Editor с результатом команды sudo mariadb -e "SHOW DATABASES;".

Сервер запускается, но работает нестабильно

Обратитесь к руководству Диагностика сбоев и тормозов сервера FiveM, чтобы найти ресурс, вызывающий проблему.