تثبيت MariaDB وربط قاعدة بيانات FiveM (oxmysql)

تحفظ QBCore وESX وQbox بيانات اللاعبين والمخزون والمركبات في قاعدة بيانات MySQL/MariaDB. تثبّتها مرة واحدة على خادم VPS نفسه، ويتصل بها FiveM عبر localhost.

Windows

1. نزّل مثبّت MariaDB بصيغة MSI (إصدار LTS) من mariadb.org/download.
2. ثبّته واختر كلمة مرور root طويلة. اترك الخيار Install as service محددًا ليبدأ مع Windows.
3. يتضمن المثبّت برنامج HeidiSQL، وهو برنامج لعرض قاعدة البيانات وتعديلها عبر واجهة رسومية.

Linux (Ubuntu / Debian)

apt install -y mariadb-server
mariadb-secure-installation

أجب عن الأسئلة: احذف المستخدمين المجهولين وقاعدة بيانات الاختبار.

أنشئ قاعدة البيانات ومستخدمها

لا تستخدم root مع FiveM. ادخل إلى MariaDB (في Windows، من HeidiSQL أو بالأمر mysql -u root -p؛ وفي Linux، بالأمر mariadb) ونفّذ:

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'LONG_PASSWORD';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;

هذه هي البيانات التي ستطلبها منك txAdmin عند نشر الوصفة: قاعدة البيانات fivem، والمستخدم fivem، وكلمة مروره.

سلسلة الاتصال (oxmysql)

تكتبها txAdmin في ملف server.cfg. وإذا أضفتها يدويًا، فهذا شكلها:

set mysql_connection_string "mysql://fivem:LONG_PASSWORD@localhost/fivem?charset=utf8mb4"

ويجب أن يأتي ensure oxmysql قبل الإطار في ترتيب التحميل. وإذا كانت كلمة المرور تحتوي على رموز مثل @ أو #، فاستبدل بها كلمة خالية منها: فهذه الرموز تُفسد السلسلة.

لا تفتح المنفذ 3306

لا يستخدم قاعدة البيانات إلا خادم FiveM الموجود على الجهاز نفسه، وفتح المنفذ 3306 على الإنترنت دعوة صريحة لمهاجمتها. لإدارتها من حاسوبك، استخدم HeidiSQL مع خيار نفق SSH (في Linux)، أو اتصل عبر سطح المكتب البعيد (في Windows).

أكثر خطأين شيوعًا

واحرص على النسخ الاحتياطية: تصدير قاعدة البيانات يوميًا (dump) هو ما سينقذك إذا حذف أحد السكربتات بيانات المخزون.