База данных для сервера FiveM (MariaDB и oxmysql)

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 06:26, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: база данных для сервера FiveM (проверено на Ubuntu 24.04, со снимками экрана))
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Почти любой ролевой набор для FiveM — ESX, QBCore, Qbox — хранит игроков, деньги, машины и имущество в базе данных. В статье — установка MariaDB на тот же VDS, создание базы и подключение к ней сервера через ресурс oxmysql. Сервер должен быть уже установлен: Установка сервера FiveM (GTA 5) на Ubuntu 24.04. Проверено 17 ноября 2026 года на Ubuntu 24.04.4: MariaDB 10.11.14, oxmysql 2.14.3.

Нужна ли база

Что ставите База данных
Свободная игра на стандартных ресурсах Не нужна
Ролевой набор: ESX, QBCore, Qbox Обязательна
Отдельные ресурсы — банк, гараж, телефон Обычно нужна: автор пишет об этом в описании и прикладывает файл .sql

База данных работает в оперативной памяти: на VDS с ролевым сервером закладывайте под неё 1–2 ГБ сверх того, что нужно самому серверу. Если памяти впритык — возьмите тариф VDS на ступень выше.

1. Установка MariaDB и создание базы

sudo apt update
sudo apt install -y mariadb-server unzip
systemctl is-active mariadb

Создайте базу и пользователя. Вместо ПарольБазы придумайте свой пароль — длинный, из латинских букв и цифр: знаки @ : / ? # в пароле сломают строку подключения.

sudo mariadb -e "CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'ПарольБазы'; GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost'; FLUSH PRIVILEGES;"
mariadb -u fivem -pПарольБазы fivem -e "SELECT CURRENT_USER(), DATABASE(), VERSION();"
sudo ss -lntp | grep mariadbd | awk '{print $4}'

Что видно на снимке:

  • вторая команда вошла в базу под новым пользователем — значит, пароль и права заданы верно;
  • последняя строка — 127.0.0.1:3306: MariaDB принимает подключения только с самого VDS. Так и должно быть: сервер FiveM стоит рядом, а из интернета база недоступна. Открывать порт 3306 в файрволе не нужно.

Кодировка utf8mb4 нужна, чтобы в базе без искажений хранились русские имена и эмодзи.

2. Установка oxmysql

oxmysql — ресурс, через который остальные ресурсы обращаются к базе. Его используют все современные наборы; он же понимает запросы, написанные для старых mysql-async и ghmattimysql.

sudo -iu fivem
cd ~/FXServer/server-data/resources
mkdir -p '[standalone]' && cd '[standalone]'
curl -sL --retry 5 -o oxmysql.zip https://github.com/overextended/oxmysql/releases/latest/download/oxmysql.zip && unzip -q oxmysql.zip && rm oxmysql.zip
ls oxmysql

Скачивайте именно готовый выпуск (файл oxmysql.zip со страницы выпусков), а не исходный код: в исходном коде нет собранной папки dist, и ресурс не запустится.

3. Строка подключения

Откройте файл настроек:

nano ~/FXServer/server-data/server.cfg

Добавьте выше остальных строк ensure:

# База данных
set mysql_connection_string "mysql://fivem:ПарольБазы@localhost/fivem?charset=utf8mb4"
ensure oxmysql

Строка читается так: mysql://пользователь:пароль@адрес/база. Ресурсы запускаются в том порядке, в каком записаны, поэтому oxmysql должен стоять раньше всех, кому нужна база.

Проверка — сервер должен найти на один ресурс больше, чем раньше:

cd ~/FXServer/server-data
grep -A 2 "База данных" server.cfg
timeout 25 bash ~/FXServer/server/run.sh +exec server.cfg 2>&1 | grep -E "Found" | cut -c1-80

Было 20 ресурсов, стало 21. При запуске с настоящим лицензионным ключом oxmysql пишет в консоль строку о подключении к базе с версией MariaDB — её и ищите после перезапуска сервера:

exit
sudo systemctl restart fivem

4. Таблицы для ресурсов

К ресурсам, которым нужна база, приложен файл .sql с таблицами. Загрузите его в базу:

sudo mariadb fivem < /home/fivem/FXServer/server-data/resources/путь/к/файлу.sql

Проверить, что таблицы появились: sudo mariadb fivem -e "SHOW TABLES;".

Если ролевой набор разворачивается рецептом txAdmin, таблицы он создаёт сам — в мастере достаточно указать адрес localhost, пользователя fivem, пароль и базу fivem.

Как посмотреть и поправить данные

Не открывайте порт 3306 наружу и не ставьте ради этого phpMyAdmin на игровой VDS. Надёжнее подключаться программой с домашнего компьютера через SSH-туннель — так умеют HeidiSQL и DBeaver: в настройках подключения выбирается «SSH-туннель», указываются адрес VDS и вход по SSH, а адрес базы остаётся 127.0.0.1:3306.

Из консоли VDS:

sudo mariadb fivem

Выход — exit.

Что не проверено

Проверены: установка MariaDB, создание базы и вход под новым пользователем, загрузка oxmysql, строка в server.cfg, то, что сервер находит ресурс. Сервер без лицензионного ключа ресурсы не запускает, а ключ выдаётся только владельцу учётной записи Cfx.re — поэтому само подключение oxmysql к базе в работающем сервере не проверялось.

Если что-то пошло не так

Что видите Причина и решение
«Access denied for user 'fivem'@'localhost'» Неверный пароль в строке подключения. Проверьте его второй командой из шага 1
«Unknown database» Имя базы в строке подключения не совпадает с созданной
oxmysql не может разобрать строку подключения В пароле есть знаки @ : / ? #. Смените пароль: sudo mariadb -e "ALTER USER 'fivem'@'localhost' IDENTIFIED BY 'НовыйПароль';"
«Couldn't find resource oxmysql» Папка ресурса называется иначе или лежит не в resources. Должно быть resources/[standalone]/oxmysql/fxmanifest.lua
Ресурс пишет, что oxmysql не запущен Строка ensure oxmysql стоит ниже этого ресурса — поднимите её
«Table … doesn't exist» Не загружен файл .sql этого ресурса — шаг 4
Сервер «подвисает» при сохранениях Не хватает памяти или медленные запросы. Посмотрите free -h; если память занята полностью — нужен тариф с большим объёмом

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: