txAdmin: الدليل الشامل للوحة FiveM

ما هي txAdmin بالضبط؟

txAdmin مُضمَّنة افتراضيًا في FXServer منذ 2020: لا حاجة لشراء أي شيء أو تثبيته بشكل منفصل. عند التشغيل الأول لـ FXServer، تبدأ txAdmin تلقائيًا وتوفر واجهة ويب (افتراضيًا على المنفذ 40120). إنها الأداة القياسية لمجتمع FiveM، مفتوحة المصدر ويصونها فريق Cfx.re.

• وحدة تحكم مباشرة: سجلات الخادم في الوقت الفعلي، الأوامر، السجل التاريخي
• Recipes: نشر تلقائي لقاعدة كاملة (QBCore، ESX Legacy، vanilla)
• المُجدوِل: إعادة تشغيل مجدولة مع إعلانات داخل اللعبة
• إدارة اللاعبين: الحظر، التحذيرات، القائمة البيضاء، الملاحظات، السجل حسب المعرّف
• المراقبة: اكتشاف الأعطال مع إعادة التشغيل التلقائي

Prérequis

• VPS بذاكرة RAM لا تقل عن 4 Go — يُنصح بـ 8 Go لقاعدة QBCore/ESX مع لاعبين. على Linux، تُعد Debian وUbuntu أفضل التوزيعات توثيقًا: راجع صفحتي VPS Debian وVPS Ubuntu. على Windows، يلزم VPS Windows مع وصول RDP.
• مفتاح ترخيص مجاني يُنشأ على portal.cfx.re (إلزامي لأي خادم FiveM)، يُضاف في server.cfg عبر sv_licenseKey
• المنفذ 30120 عبر TCP وUDP (اللعبة) والمنفذ 40120 عبر TCP (لوحة txAdmin) مفتوحان في جدار الحماية
• قاعدة بيانات MariaDB أو MySQL إذا كنت تنشر إطار عمل للعب الأدوار: يخزّن فيها كل من QBCore وESX الشخصيات والمخزون والاقتصاد

التثبيت على VPS Linux

نزّل أحدث إصدار من FXServer من runtime.fivem.net، وفك ضغطه في مجلد (مثل ~/fxserver)، ثم شغّل ./run.sh. تبدأ txAdmin تلقائيًا وتعرض في الطرفية رمز PIN من 4 أرقام صالحًا لبضع دقائق. افتح http://IP-DU-VPS:40120 في متصفحك، وأدخل رمز PIN، ثم اربط حسابك على Cfx.re: فهو الذي سيُستخدم كمعرّف المسؤول. لكي يستمر الخادم بعد قطع اتصال SSH، شغّله داخل tmux أو screen أو عبر خدمة systemd — يقدّم القسم التالي الوحدة كاملة.

تشغيل FXServer كخدمة systemd

الخادم الذي يُشغَّل يدويًا في طرفية يتوقف بانتهاء جلسة SSH، ولا يعيد التشغيل إذا أُعيد تشغيل VPS. خدمة systemd تحل المشكلتين. أنشئ /etc/systemd/system/fxserver.service بالمحتوى أدناه، مع استبدال المستخدم والمسارات بما يخصك:

• [Unit] — Description=FXServer FiveM ثم After=network.target mariadb.service: لا يبدأ الخادم قبل جاهزية الشبكة وقاعدة البيانات
• [Service] — User=fivem، WorkingDirectory=/home/fivem/fxserver، ExecStart=/home/fivem/fxserver/run.sh، Restart=always، RestartSec=10
• القسم [Install] — WantedBy=multi-user.target
• ثم systemctl daemon-reload، وsystemctl enable --now fxserver، وjournalctl -u fxserver -f لقراءة سجلات بدء التشغيل — وهناك يظهر رمز PIN عند التشغيل الأول

شغّل الخادم تحت حساب مخصص

لا تشغّل FXServer بصلاحيات root. أنشئ مستخدم نظام مخصصًا (adduser --system --group fivem)، وضع فيه مجلد الخادم، وامنحه ملكية المجلد txData. عندئذ لن يصل أي مورد خارجي سيئ البرمجة — وما أكثرها في منظومة لعب الأدوار — إلا إلى ملفات اللعبة، لا إلى بقية الجهاز. على VPS تستضيف عليه أيضًا موقعًا أو قاعدة بيانات، يُعد هذا الفصل الحد الأدنى.

تثبيت txAdmin على VPS Windows

يتوفر FXServer أيضًا بإصدار Windows، وتلتزم به مجتمعات كثيرة للعب الأدوار لأن أدوات التطوير لديها تعمل عليه. المبدأ نفسه: نزّل الأرشيف server.zip من runtime.fivem.net، وفك ضغطه، وشغّل FXServer.exe. تبدأ txAdmin وتعرض رمز PIN في نافذة وحدة التحكم، وتستجيب اللوحة على http://IP-DU-VPS:40120. بعض الفروق الواجب معرفتها:

• يحظر جدار حماية Windows الاتصالات افتراضيًا: أنشئ قاعدتين للحركة الواردة، واحدة لـ المنفذ 30120 عبر TCP وUDP، وأخرى لـ المنفذ 40120 عبر TCP (جدار حماية Windows Defender مع الأمان المتقدم، أو New-NetFirewallRule في PowerShell)
• تُغلق نافذة وحدة التحكم مع جلسة RDP: لكي يعمل الخادم باستمرار، سجّل FXServer.exe كخدمة Windows (NSSM وWinSW هما الأداتان اللتان يستخدمهما المجتمع) أو استخدم مهمة مجدولة تُشغَّل «عند بدء تشغيل الكمبيوتر»
• خصّص ذاكرة أكبر مما على Linux: فالنظام نفسه يستهلك المزيد منها. على VPS Windows لدينا، يبدأ العرض الأساسي بـ 8 Go، ما يترك الهامش اللازم لقاعدة QBCore أو ESX
• ترخيص Microsoft غير مُضمَّن: إنها تكلفة إضافية يجب احتسابها، على عكس VPS Linux

نشر قاعدة باستخدام recipes

عند الدخول لأول مرة، يقترح معالج txAdmin نشر recipe: قاعدة خادم كاملة تُثبَّت تلقائيا (إطار العمل، قاعدة البيانات، الموارد الأولية). اختر QBCore أو ESX Legacy لخادم roleplay، أو قاعدة vanilla للبدء من الصفر. تضبط الـ recipe أيضا الاتصال بـ MySQL/MariaDB — على VPS، ثبّت MariaDB أولا وأنشئ قاعدة بيانات مخصصة.

المنافذ الواجب فتحها، ولماذا

ثلاثة منافذ فقط، لكن الخطأ الشائع هو فتح المنفذ 30120 عبر TCP وحده. يستخدم FiveM رقم المنفذ نفسه عبر TCP وUDP: يُستخدم TCP لاكتشاف الخوادم وقائمتها، وUDP لحركة اللعب. إذا ظهر الخادم في القائمة ولم يتمكن أحد من الاتصال به، فالسبب في الغالب هو نسيان UDP.

• 30120/tcp و30120/udp: اللعب. مفتوحان للجميع. على Debian أو Ubuntu: يفتح الأمر ufw allow 30120 البروتوكولين دفعة واحدة
• 40120/tcp: لوحة txAdmin. يجب حصره بعنوان IP الخاص بك، انظر أدناه
• 3306/tcp (MariaDB): لا تفتحه للخارج. تعمل القاعدة على الجهاز نفسه مع FXServer، ويُوصَل إليها عبر 127.0.0.1. إن منفذ MySQL المكشوف على الإنترنت من أسرع الطرق لخسارة قاعدة الشخصيات
• يمكن تغيير منفذ اللعب (endpoint_add_tcp وendpoint_add_udp في server.cfg): وهذا مفيد لتشغيل خادمين على الجهاز نفسه، أحدهما للإنتاج والآخر للاختبار

كم من الموارد حسب عدد اللاعبين

يعتمد محرك RAGE اعتمادا كبيرا على نواة واحدة: تردد المعالج أهم من عدد vCore. يستوعب VPS بـ 8 أنوية بطيئة لاعبين أقل من VPS بـ 4 أنوية سريعة. أما الذاكرة، فالموارد الخارجية هي التي تحدد الحاجة — إذ يحمّل خادم roleplay كامل نحو مئة سكربت بسهولة.

• قاعدة vanilla، عدد قليل من اللاعبين: تكفي 4 Go من RAM، وهو الحد الأدنى لتشغيل FXServer
• QBCore أو ESX، من 20 إلى 40 لاعبا: 8 Go. تستهلك نحو خمسين سكربتا في خادم roleplay مبتدئ ما بين 2 و4 Go وحدها، ويحتاج MariaDB إلى نحو 1 إضافي
• خادم راسخ، 64 مقعدا فأكثر، سكربتات مخصصة: 16 Go، وتخزين SSD — فالتبادل مع القاعدة مستمر طوال الجلسات
• القرص: احسب حجم مواردك مع القاعدة، واترك مساحة للنسخ الاحتياطية. خوادم roleplay تكبر مع الوقت، ولا تصغر أبدا

وحدة تحكم txAdmin في الاستخدام اليومي

يعرض تبويب Live Console سجلات الخادم في الوقت الفعلي ويقبل جميع أوامر FXServer (refresh، ensure ma-ressource، restart es_extended...). تُسجَّل الإجراءات الحساسة لكل حساب مسؤول: كل kick أو ban أو restart يُتتبَّع، وهذا مفيد عندما يدير عدة مشرفين الخادم.

• Scheduler: جدول إعادة تشغيل مرة أو مرتين يوميا مع إعلانات تلقائية — فذاكرة خادم FiveM تتجزأ مع الوقت
• Backups: احفظ نسخة احتياطية منتظمة من مجلد بياناتك ومن قاعدة MySQL (لا يحفظ txAdmin قاعدة البيانات نيابة عنك)
• Permissions: أنشئ حساب مسؤول لكل مشرف بصلاحيات محدودة، بدلا من مشاركة الحساب الرئيسي

تحديث FXServer وtxAdmin

ليس لـ txAdmin تحديث مستقل: فهو مدمج في artifact الخاص بـ FXServer، لذا تحديث الخادم يحدّث اللوحة. العملية بسيطة لكنها تتم بالترتيب، وإلا قد تفقد إعداداتك.

1. التقط snapshot للـ VPS من منطقة العملاء، أو على الأقل نسخة من مجلد الخادم وتصديرا للقاعدة
2. أوقف الخادم بشكل سليم (systemctl stop fxserver، أو زر Stop في txAdmin)
3. استبدل ملفات الـ artifact فقط — لا تلمس txData/ ولا مجلد resources/ ولا server.cfg: فهذه بياناتك، لا بيانات الخادم
4. أعد التشغيل، ثم تحقق في وحدة التحكم من تحميل جميع الموارد. أي مورد غير متوافق مع الإصدار الجديد يظهر فورا في السجلات
5. احتفظ بالـ artifact السابق لبضعة أيام: فالتراجع يقتصر حينها على إعادة المجلد القديم

احفظ ما يهم فعلا

ملاحظة تتكرر كثيرا في طلبات الدعم: «txAdmin يصنع نسخا احتياطية، أليس كذلك؟» نعم، لكن ليس لما تظنه. لا يحفظ txAdmin قاعدة البيانات. وهي التي تحتوي على الشخصيات والمركبات والحسابات المصرفية والمخزونات — كل ما بناه مجتمعك ولن يغفر أحد خسارته.

• القاعدة: mysqldump يومي عبر مهمة cron، يُرسَل إلى مكان آخر غير الـ VPS نفسه
• مجلد txData/: يحتوي على admins.json وإعدادات اللوحة وسجل العقوبات
• مجلد resources/ وserver.cfg: خاصة إذا عدّلت سكربتات مشتراة، فهذه التعديلات غير موجودة في أي مكان آخر
• لقطات snapshot للـ VPS تغطي الجهاز بأكمله وتُستعاد بنقرة واحدة من منطقة العملاء. وهي تكمل تصديرات القاعدة ولا تحل محلها: فاللقطة تستعيد أيضا الخطأ الذي أردت إلغاءه

تأمين الوصول إلى اللوحة

لوحة إدارة مكشوفة على IP عام هدف واضح. تكفي ثلاثة إجراءات:

• حصر المنفذ 40120 بعنوان IP الخاص بك: ufw allow from VOTRE_IP to any port 40120 ثم ufw deny 40120 — لا يصل إلى اللوحة سوى المسؤولين المشاركين، ويبقى منفذ اللعب (30120) مفتوحا للجميع
• لا تعطّل المصادقة أبدا، حتى «للاختبار فقط»: وضع txAdmin دون كلمة مرور مخصص للتطوير المحلي، وليس لـ VPS عام إطلاقا
• Reverse-proxy عبر HTTPS في الإنتاج (اختياري): Nginx أو Caddy في الواجهة مع نطاق فرعي وشهادة Let's Encrypt، بدلا من كشف ip:40120 دون تشفير — احرص على تمرير ترويسات WebSocket (Upgrade/Connection)، فوحدة التحكم المباشرة تعتمد عليها
• حساب مسؤول لكل شخص، بأدنى الصلاحيات: يسجّل txAdmin الإجراءات لكل حساب، ولا فائدة من ذلك إذا تشارك الجميع المعرّف نفسه

المشكلات الشائعة وحلولها

• تعذّر الوصول إلى الصفحة 40120: المنفذ مغلق — افتحه في الجدار الناري (ufw allow 40120/tcp) أو تحقق من أن txAdmin يستمع فعلا (السجلات عند التشغيل)
• يظهر الخادم في القائمة لكن لا أحد يستطيع الاتصال: المنفذ 30120 مفتوح عبر TCP فقط. افتحه أيضًا عبر UDP
• انتهت صلاحية رمز PIN: أعد تشغيل FXServer، وسيظهر رمز PIN جديد في الطرفية
• فقدان صلاحية المسؤول: أوقف الخادم واحذف الملف txData/admins.json — سيعيد txAdmin تشغيل معالج الإعداد الأولي
• «Invalid license key»: مفتاح Cfx.re مرتبط بعنوان IP. إذا غيّرت الخادم، فأعد توليده على portal.cfx.re واستبدل السطر sv_licenseKey في server.cfg
• تبقى وحدة التحكم المباشرة فارغة خلف وكيل عكسي (reverse-proxy): ترويسات WebSocket لا تُمرَّر. أضف Upgrade وConnection إلى إعدادات Nginx
• الخادم يعيد التشغيل بشكل متكرر: اقرأ السجلات قبل الانهيار مباشرة. في تسع حالات من عشر، يكون السبب موردًا خارجيًا أُضيف في اليوم السابق — أزله من server.cfg وأعد التشغيل للتأكد
• الخادم بطيء: راقب تبويب المراقبة؛ إذا امتلأت ذاكرة RAM مع قاعدتك ولاعبيك، فانتقل إلى خطة VPS أعلى. يتم تغيير العرض من لوحة تحكم العميل، دون إعادة تثبيت
• هجمات متكررة أثناء الجلسات: تُستهدف خوادم لعب الأدوار المزدحمة بانتظام. الحل الوحيد هو التصفية على مستوى الشبكة؛ راجع دليلنا فهم Anti-DDoS