<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ru">
	<id>https://wiki.ark-hoster.ru/index.php?action=history&amp;feed=atom&amp;title=%D0%91%D0%B0%D0%B7%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0_FiveM_%28MariaDB_%D0%B8_oxmysql%29</id>
	<title>База данных для сервера FiveM (MariaDB и oxmysql) - История изменений</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.ark-hoster.ru/index.php?action=history&amp;feed=atom&amp;title=%D0%91%D0%B0%D0%B7%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0_FiveM_%28MariaDB_%D0%B8_oxmysql%29"/>
	<link rel="alternate" type="text/html" href="https://wiki.ark-hoster.ru/index.php?title=%D0%91%D0%B0%D0%B7%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0_FiveM_(MariaDB_%D0%B8_oxmysql)&amp;action=history"/>
	<updated>2026-11-17T19:04:56Z</updated>
	<subtitle>История изменений этой страницы в вики</subtitle>
	<generator>MediaWiki 1.43.9</generator>
	<entry>
		<id>https://wiki.ark-hoster.ru/index.php?title=%D0%91%D0%B0%D0%B7%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0_FiveM_(MariaDB_%D0%B8_oxmysql)&amp;diff=3356&amp;oldid=prev</id>
		<title>Maintenance script: Новая статья: база данных для сервера FiveM (проверено на Ubuntu 24.04, со снимками экрана)</title>
		<link rel="alternate" type="text/html" href="https://wiki.ark-hoster.ru/index.php?title=%D0%91%D0%B0%D0%B7%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0_FiveM_(MariaDB_%D0%B8_oxmysql)&amp;diff=3356&amp;oldid=prev"/>
		<updated>2026-11-17T06:26:36Z</updated>

		<summary type="html">&lt;p&gt;Новая статья: база данных для сервера FiveM (проверено на Ubuntu 24.04, со снимками экрана)&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Новая страница&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;div class=&amp;quot;ark-crumbs&amp;quot;&amp;gt;[[Главная страница|База знаний]] › [[Виртуально выделенный сервер (VPS / VDS )|VPS / VDS]] › [[Установка игрового сервера на VDS|Игровые серверы на VDS]] › [[GTA 5|GTA 5 (FiveM)]]&amp;lt;/div&amp;gt;&lt;br /&gt;
Почти любой ролевой набор для 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.&lt;br /&gt;
&lt;br /&gt;
== Нужна ли база ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! style=&amp;quot;width:40%;&amp;quot; | Что ставите !! База данных&lt;br /&gt;
|-&lt;br /&gt;
| Свободная игра на стандартных ресурсах || Не нужна&lt;br /&gt;
|-&lt;br /&gt;
| Ролевой набор: ESX, QBCore, Qbox || Обязательна&lt;br /&gt;
|-&lt;br /&gt;
| Отдельные ресурсы — банк, гараж, телефон || Обычно нужна: автор пишет об этом в описании и прикладывает файл &amp;lt;code&amp;gt;.sql&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
База данных работает в оперативной памяти: на VDS с ролевым сервером закладывайте под неё 1–2 ГБ сверх того, что нужно самому серверу. Если памяти впритык — возьмите [https://ark-hoster.ru/vpsgame/ тариф VDS] на ступень выше.&lt;br /&gt;
&lt;br /&gt;
== 1. Установка MariaDB и создание базы ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sudo apt update&lt;br /&gt;
sudo apt install -y mariadb-server unzip&lt;br /&gt;
systemctl is-active mariadb&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Создайте базу и пользователя. Вместо &amp;lt;code&amp;gt;ПарольБазы&amp;lt;/code&amp;gt; придумайте свой пароль — длинный, из латинских букв и цифр: знаки &amp;lt;code&amp;gt;@&amp;amp;#32;: /&amp;amp;#32;? #&amp;lt;/code&amp;gt; в пароле сломают строку подключения.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sudo mariadb -e &amp;quot;CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER &amp;#039;fivem&amp;#039;@&amp;#039;localhost&amp;#039; IDENTIFIED BY &amp;#039;ПарольБазы&amp;#039;; GRANT ALL PRIVILEGES ON fivem.* TO &amp;#039;fivem&amp;#039;@&amp;#039;localhost&amp;#039;; FLUSH PRIVILEGES;&amp;quot;&lt;br /&gt;
mariadb -u fivem -pПарольБазы fivem -e &amp;quot;SELECT CURRENT_USER(), DATABASE(), VERSION();&amp;quot;&lt;br /&gt;
sudo ss -lntp | grep mariadbd | awk &amp;#039;{print $4}&amp;#039;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:Linux-fxdb-db.png|800px]]&lt;br /&gt;
&lt;br /&gt;
Что видно на снимке:&lt;br /&gt;
&lt;br /&gt;
* вторая команда вошла в базу под новым пользователем — значит, пароль и права заданы верно;&lt;br /&gt;
* последняя строка — &amp;lt;code&amp;gt;127.0.0.1:3306&amp;lt;/code&amp;gt;: MariaDB принимает подключения только с самого VDS. Так и должно быть: сервер FiveM стоит рядом, а из интернета база недоступна. Открывать порт 3306 в файрволе не нужно.&lt;br /&gt;
&lt;br /&gt;
Кодировка &amp;lt;code&amp;gt;utf8mb4&amp;lt;/code&amp;gt; нужна, чтобы в базе без искажений хранились русские имена и эмодзи.&lt;br /&gt;
&lt;br /&gt;
== 2. Установка oxmysql ==&lt;br /&gt;
&lt;br /&gt;
oxmysql — ресурс, через который остальные ресурсы обращаются к базе. Его используют все современные наборы; он же понимает запросы, написанные для старых &amp;lt;code&amp;gt;mysql-async&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;ghmattimysql&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sudo -iu fivem&lt;br /&gt;
cd ~/FXServer/server-data/resources&lt;br /&gt;
mkdir -p &amp;#039;[standalone]&amp;#039; &amp;amp;&amp;amp; cd &amp;#039;[standalone]&amp;#039;&lt;br /&gt;
curl -sL --retry 5 -o oxmysql.zip https://github.com/overextended/oxmysql/releases/latest/download/oxmysql.zip &amp;amp;&amp;amp; unzip -q oxmysql.zip &amp;amp;&amp;amp; rm oxmysql.zip&lt;br /&gt;
ls oxmysql&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Скачивайте именно готовый выпуск (файл &amp;lt;code&amp;gt;oxmysql.zip&amp;lt;/code&amp;gt; со страницы выпусков), а не исходный код: в исходном коде нет собранной папки &amp;lt;code&amp;gt;dist&amp;lt;/code&amp;gt;, и ресурс не запустится.&lt;br /&gt;
&lt;br /&gt;
== 3. Строка подключения ==&lt;br /&gt;
&lt;br /&gt;
Откройте файл настроек:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;nano ~/FXServer/server-data/server.cfg&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Добавьте &amp;#039;&amp;#039;&amp;#039;выше&amp;#039;&amp;#039;&amp;#039; остальных строк &amp;lt;code&amp;gt;ensure&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;# База данных&lt;br /&gt;
set mysql_connection_string &amp;quot;mysql://fivem:ПарольБазы@localhost/fivem?charset=utf8mb4&amp;quot;&lt;br /&gt;
ensure oxmysql&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Строка читается так: &amp;lt;code&amp;gt;mysql://пользователь:пароль@адрес/база&amp;lt;/code&amp;gt;. Ресурсы запускаются в том порядке, в каком записаны, поэтому oxmysql должен стоять раньше всех, кому нужна база.&lt;br /&gt;
&lt;br /&gt;
Проверка — сервер должен найти на один ресурс больше, чем раньше:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;cd ~/FXServer/server-data&lt;br /&gt;
grep -A 2 &amp;quot;База данных&amp;quot; server.cfg&lt;br /&gt;
timeout 25 bash ~/FXServer/server/run.sh +exec server.cfg 2&amp;gt;&amp;amp;1 | grep -E &amp;quot;Found&amp;quot; | cut -c1-80&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:Linux-fxdb-ox.png|800px]]&lt;br /&gt;
&lt;br /&gt;
Было 20 ресурсов, стало 21. При запуске с настоящим лицензионным ключом oxmysql пишет в консоль строку о подключении к базе с версией MariaDB — её и ищите после перезапуска сервера:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;exit&lt;br /&gt;
sudo systemctl restart fivem&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 4. Таблицы для ресурсов ==&lt;br /&gt;
&lt;br /&gt;
К ресурсам, которым нужна база, приложен файл &amp;lt;code&amp;gt;.sql&amp;lt;/code&amp;gt; с таблицами. Загрузите его в базу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sudo mariadb fivem &amp;lt; /home/fivem/FXServer/server-data/resources/путь/к/файлу.sql&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Проверить, что таблицы появились: &amp;lt;code&amp;gt;sudo mariadb fivem -e &amp;quot;SHOW TABLES;&amp;quot;&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Если ролевой набор разворачивается рецептом txAdmin, таблицы он создаёт сам — в мастере достаточно указать адрес &amp;lt;code&amp;gt;localhost&amp;lt;/code&amp;gt;, пользователя &amp;lt;code&amp;gt;fivem&amp;lt;/code&amp;gt;, пароль и базу &amp;lt;code&amp;gt;fivem&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Как посмотреть и поправить данные ==&lt;br /&gt;
&lt;br /&gt;
Не открывайте порт 3306 наружу и не ставьте ради этого phpMyAdmin на игровой VDS. Надёжнее подключаться программой с домашнего компьютера через SSH-туннель — так умеют HeidiSQL и DBeaver: в настройках подключения выбирается «SSH-туннель», указываются адрес VDS и вход по SSH, а адрес базы остаётся &amp;lt;code&amp;gt;127.0.0.1:3306&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Из консоли VDS:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;sudo mariadb fivem&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Выход — &amp;lt;code&amp;gt;exit&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Что не проверено ==&lt;br /&gt;
&lt;br /&gt;
Проверены: установка MariaDB, создание базы и вход под новым пользователем, загрузка oxmysql, строка в &amp;lt;code&amp;gt;server.cfg&amp;lt;/code&amp;gt;, то, что сервер находит ресурс. Сервер без лицензионного ключа ресурсы не запускает, а ключ выдаётся только владельцу учётной записи Cfx.re — поэтому само подключение oxmysql к базе в работающем сервере не проверялось.&lt;br /&gt;
&lt;br /&gt;
== Если что-то пошло не так ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Что видите !! Причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| «Access denied for user &amp;#039;fivem&amp;#039;@&amp;#039;localhost&amp;#039;» || Неверный пароль в строке подключения. Проверьте его второй командой из шага 1&lt;br /&gt;
|-&lt;br /&gt;
| «Unknown database» || Имя базы в строке подключения не совпадает с созданной&lt;br /&gt;
|-&lt;br /&gt;
| oxmysql не может разобрать строку подключения || В пароле есть знаки &amp;lt;code&amp;gt;@&amp;amp;#32;: /&amp;amp;#32;? #&amp;lt;/code&amp;gt;. Смените пароль: &amp;lt;code&amp;gt;sudo mariadb -e &amp;quot;ALTER USER &amp;#039;fivem&amp;#039;@&amp;#039;localhost&amp;#039; IDENTIFIED BY &amp;#039;НовыйПароль&amp;#039;;&amp;quot;&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| «Couldn&amp;#039;t find resource oxmysql» || Папка ресурса называется иначе или лежит не в &amp;lt;code&amp;gt;resources&amp;lt;/code&amp;gt;. Должно быть &amp;lt;code&amp;gt;resources/[standalone]/oxmysql/fxmanifest.lua&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Ресурс пишет, что oxmysql не запущен || Строка &amp;lt;code&amp;gt;ensure oxmysql&amp;lt;/code&amp;gt; стоит ниже этого ресурса — поднимите её&lt;br /&gt;
|-&lt;br /&gt;
| «Table … doesn&amp;#039;t exist» || Не загружен файл &amp;lt;code&amp;gt;.sql&amp;lt;/code&amp;gt; этого ресурса — шаг 4&lt;br /&gt;
|-&lt;br /&gt;
| Сервер «подвисает» при сохранениях || Не хватает памяти или медленные запросы. Посмотрите &amp;lt;code&amp;gt;free -h&amp;lt;/code&amp;gt;; если память занята полностью — нужен тариф с большим объёмом&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Для размещения ваших проектов рекомендуем услуги [https://ark-hoster.ru ARK-HOSTER.RU]:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]&amp;#039;&amp;#039;&amp;#039; — для небольших и средних проектов&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;[https://ark-hoster.ru/dedicated/ Выделенные серверы]&amp;#039;&amp;#039;&amp;#039; — для высоконагруженных проектов&lt;br /&gt;
&lt;br /&gt;
{{Телеграм}}&lt;/div&gt;</summary>
		<author><name>Maintenance script</name></author>
	</entry>
</feed>