كيفية تشغيل خادم FiveM على CasaOS باستخدام Docker

نعم، يمكن تشغيل خادم FiveM على مضيف CasaOS عبر Docker. كانت تلك هي الإجابة التي توصل إليها موضوع مجتمع IceWhale في سبتمبر 2023: إذ كان حاسوب الألعاب القديم للمستخدم يمتلك بالفعل موارد كافية لأحمال CasaOS، وأشار أعضاء المجتمع إلى أن FXServer الخاص بـ FiveM يتوفر بإصدارات Linux ويمكن وضعه في حاوية كتطبيق CasaOS مخصص.

استخدم الموضوع التاريخي الجهة الخارجية spritsail/fivem الصورة وعرّضت منفذ ألعاب FiveM ومنفذ txAdmin معًا. ولا يزال ذلك نقطة بداية مفيدة لبنية النظام، لكن لا ينبغي الخلط بينه وبين حزمة CasaOS رسمية من Cfx.re. لا تزال وثائق Cfx.re الحالية تدعم FXServer على Linux، مع تحذير صريح من أن خادم Linux هو منفذ مقدم على سبيل المجاملة، وأن Windows يتلقى عمومًا توافقًا ودعمًا تشخيصيًا أفضل. وفي عام 2026، استمرت أيضًا مشكلات FiveM الخاصة بـ Linux وDocker في الظهور، لذا اختبر مُصنَّف الخادم وإصدار اللعبة المحددين اللذين تخطط لاستخدامهما.

ما أكده موضوع CasaOS الأصلي

سأل المنشور الأصلي ما إذا كان يمكن تشغيل خادم FiveM خاص على حاسوب ألعاب قديم يعمل بالفعل كخادم CasaOS. وقدمت إجابتان الإجابة المفيدة:

• يمكن تشغيل FiveM/FXServer على Linux وفي Docker.
• يمكن لتطبيق مخصص في CasaOS إتاحة المنافذ المطلوبة واستمرار حفظ الإعدادات والبيانات.
• لا يزال الخادم يحتاج إلى مفتاح ترخيص صالح من Cfx.re.
• يجب أن تكون مواصفات الأجهزة كافية لعدد اللاعبين والموارد والبرامج النصية وحِمل قاعدة البيانات.

نقطة بداية Compose الخاصة بالمجتمع

اقترح الرد في عام 2023 تعريفًا لتطبيق مخصص في CasaOS يستند إلى جهة خارجية spritsail/fivem image:

services:
  fivem:
    image: spritsail/fivem
    restart: on-failure
    environment:
      LICENSE_KEY: YOUR_LICENSE_KEY
      NO_DEFAULT_CONFIG: 1
    ports:
      - "40120:40120"
      - "30120:30120"
      - "30120:30120/udp"
    volumes:
      - /DATA/AppData/fivem/config:/config
      - /DATA/AppData/fivem/data:/txData
    stdin_open: true
    tty: true

هذا إعداد تاريخي مستمد من المصدر، وليس تعريف تطبيق تديره IceWhale. راجع وثائق الصورة الحالية قبل استيراده إلى نظام CasaOS قيد التشغيل.

ما المنافذ التي يحتاج إليها FiveM؟

كشف إعداد المجتمع عن:

• 30120/TCP — حركة مرور الألعاب الرئيسية لـ FXServer.
• 30120/UDP — حركة مرور UDP الرئيسية لـ FXServer.
• 40120/TCP — واجهة ويب txAdmin في إعدادات المصدر.

لا تزال وثائق txAdmin الحالية من Cfx.re تعرض المنفذ 40120 باعتباره منفذ HTTP الافتراضي لـ txAdmin. راجع وثائق txAdmin الحالية.

إنشاء مفتاح ترخيص Cfx.re

تتطلب وثائق إعداد خادم Cfx.re الحالية مفتاح ترخيص للخادم قبل بدء تشغيل FXServer. سجّل الخادم من خلال سير عمل Cfx.re/Cfx Portal الحالي، واحتفظ بالمفتاح سريًا.

المرجع الرسمي: إعداد خادم.

لا تُودِع المفتاح في مستودع Git عام، ولا تلصقه في لقطات الشاشة. تُعد متغيرات بيئة CasaOS مريحة، لكن قد يتمكن أي شخص لديه صلاحية إدارية للوصول إلى إعدادات Docker من قراءتها.

الحفاظ على إعدادات الخادم وبيانات txAdmin

كان Compose الأصلي يربط:

/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data   → /txData

المبدأ أهم من تلك المسارات الدقيقة: يجب أن تُخزَّن إعدادات الخادم وملفات تعريف txAdmin على مساحة تخزين مضيفة دائمة، حتى لا تؤدي إعادة إنشاء الحاوية إلى محو حالة الخادم.

قبل تغيير صور الحاويات أو ملفات الخادم، خذ نسخة احتياطية من تلك المجلدات.

لا تزال وثائق FiveM الحالية تتعامل مع Linux باعتباره منفذًا ثانويًا للخادم

تتضمن وثائق الإعداد الحالية الرسمية لـ Cfx.re تحذيرًا مهمًا بشأن Linux: إذ تُوفَّر نسخة Linux من FXServer كمنفذ برمجي يُقدَّم على سبيل المجاملة، لأن توافق توزيعات Linux وأدوات التشخيص الأصلية قد يكونان أكثر صعوبة. وتذكر الوثائق أن احتمال تلقي المشكلات إصلاحات يكون أكبر على Windows.

هذا لا يعني أن خوادم Linux غير قابلة للاستخدام، بل يعني أن نشر CasaOS عبر Docker يضيف طبقة توافق إضافية مقارنةً بخادم Windows عادي مدعوم.

لا تزال مشكلات FiveM الخاصة بـ Docker موجودة في عام 2026

تُظهر تقارير المشكلات الحديثة في CitizenFX أن FXServer على Linux يمكنه العمل بشكل صحيح داخل Docker، بينما لا تزال إصدارات ألعاب محددة مفروضة أو ملفات Enhanced تتسبب في أعطال خاصة بالحاويات. فعلى سبيل المثال، أعادت مشكلة في عام 2026 إنتاج تعطل للعميل باستخدام sv_enforceGameBuild 3751 على Linux/Docker، بينما عملت الحاوية نفسها بالإعدادات الافتراضية دون ذلك الإعداد.

ولهذا، فإن بدء تشغيل الحاوية بنجاح وإمكانية الوصول إلى صفحة txAdmin لا يضمنان استقرار كل مجموعة من ملفات FiveM ومصادره.

ما مقدار العتاد الذي تحتاج إليه؟

الرد الأصلي لعام 2023 اقتبس متطلبات الحد الأدنى القديمة لأجهزة سطح المكتب لتشغيل FiveM. ولا تُعد هذه القيم صيغة موثوقة حديثة لتقدير حجم الخادم. يعتمد الطلب على الخادم المخصص بدرجة كبيرة على:

• عدد اللاعبين؛
• عدد أطر العمل والموارد؛
• جودة نصوص Lua/JavaScript/C#؛
• عبء عمل قاعدة البيانات؛
• إعداد OneSync؛
• خدمات إضافية مثل MariaDB/MySQL.

إذا ثبّتَّ ESX أو QBCore أو إطارًا آخر، فقد تحتاج حاوية FiveM إلى الوصول إلى حاوية MariaDB/MySQL. ضع الخدمتين على شبكة Docker يعرّفها المستخدم حتى تتمكنا من التواصل عبر اسم خدمة ثابت بدلًا من عناوين IP متغيرة للحاويات.

قد تحتاج أطر FiveM إلى قاعدة بيانات منفصلة

قد تحتاج أطر FiveM إلى قاعدة بيانات منفصلة

احتفظ ببيانات قاعدة البيانات في دليل CasaOS AppData دائم خاص بها، وأنشئ نسخة احتياطية منها بشكل مستقل عن ملفات FXServer.

اختبر على الشبكة المحلية قبل فتح الخادم أمام الإنترنت

ابدأ باختبار محلي:

1. تأكّد من استمرار تشغيل حاوية FiveM.
2. افتح txAdmin على http://CASAOS_IP:40120 إذا كانت الصورة تستخدم المنفذ الافتراضي.
3. أكمل إعداد txAdmin.
4. تأكّد 30120/TCP و 30120/UDP مربوطة.
5. انضم من جهاز آخر على الشبكة المحلية.
6. بعد الاختبار المحلي فقط، اضبط قواعد جهاز التوجيه/جدار الحماية إذا كان اللاعبون عبر الإنترنت بحاجة إلى الوصول.

الاستضافة عبر الإنترنت تضيف مسؤوليات أمنية

يتلقى خادم الألعاب العام حركة مرور غير مطلوبة من الإنترنت. أبقِ CasaOS نفسه وSSH وواجهة Docker البرمجية ومنافذ قاعدة البيانات خاصة. اكشف فقط المنافذ المطلوبة لـ FXServer/txAdmin، وفكّر في تقييد الوصول إلى txAdmin بدلًا من ترك واجهة الإدارة مفتوحة على نطاق واسع.

لا تكشف MariaDB/MySQL مباشرةً على الإنترنت لمجرد أن FiveM يحتاج إلى قاعدة بيانات.

قائمة التحقق لخادم FiveM على CasaOS

1. تأكّد من أن المضيف يملك قدرًا كافيًا من وحدة المعالجة المركزية وذاكرة الوصول العشوائي ومساحة التخزين.
2. أنشئ مفتاح ترخيص خادم Cfx.re.
3. اختر صورة Docker مُصانة لـ FiveM/FXServer، أو أنشئ الصورة بنفسك من الملفات الحالية.
4. احفظ الإعدادات وtxData خارج الحاوية.
5. اكشف 30120/TCP و 30120/UDP.
6. اكشف txAdmin بالقدر اللازم فقط.
7. اختبر محليًا قبل إعداد قواعد جدار الحماية/NAT العامة.
8. انسخ احتياطيًا txData والموارد وserver.cfg وأي قاعدة بيانات خارجية.
9. توقّع وجود اختلافات في توافق Linux/Docker مقارنةً بـ FXServer على Windows.

الأسئلة الشائعة حول FiveM على CasaOS

هل يمكن تشغيل FiveM على CasaOS؟

نعم. قدّم الموضوع الأصلي بنية Docker عاملة لتطبيق CasaOS مخصص. أما صورة الحاوية نفسها فكانت تابعة لجهة خارجية وليست حزمة CasaOS رسمية.

هل spritsail/fivem صورة رسمية من Cfx.re؟

لا. إنها صورة Docker تابعة لجهة خارجية يشير إليها المجتمع. تحقّق من حالة صيانتها الحالية قبل استخدامها.

ما المنافذ التي ينبغي ربطها؟

إعداد المصدر المستخدم 30120/TCP, 30120/UDP، و 40120/TCP بالنسبة إلى txAdmin.

هل يحظى Linux/Docker بالدعم نفسه الذي يحظى به Windows؟

ليس تمامًا. توضّح وثائق Cfx.re الحالية صراحةً أن FXServer على Linux هو منفذ مُقدَّم على سبيل المجاملة، وتذكر أن Windows أكثر عرضة لتلقّي الإصلاحات المتعلقة بمشكلات التوافق.