База данных для сервера FiveM (MariaDB и oxmysql)
Почти любой ролевой набор для 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов