🎮 تثبيت سيرفر Minecraft المعدَّل — سيرفر Java معدَّل بـ Forge/Fabric على Docker
نشر سيرفر Minecraft Java Edition معدَّل باستخدام Forge أو Fabric مع Docker على Ubuntu — مُهيَّأ مسبقاً بمحمّل الموديولات لتثبيت حزمة الموديولات والبدء باللعب فوراً.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/minecraft-modded/minecraft-modded-ubuntu.sh
chmod +x minecraft-modded-ubuntu.sh
./minecraft-modded-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/minecraft-modded/minecraft-modded-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x minecraft-modded-ubuntu.sh
3 تشغيل المثبّت
./minecraft-modded-ubuntu.sh
4 الاتصال وإضافة الموديولات
your-server-ip:25567
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 25567 | Minecraft server (mapped from the standard port 25565) |
نظرة عامة
سيرفر Minecraft المعدَّل هو سيرفر Java Edition مخصص مُهيَّأ مسبقاً بمحمّل موديولات — إما Forge (المحمّل التاريخي المسيطر لحزم الموديولات الكبيرة) أو Fabric (البديل الأخف والأسرع الشائع لموديولات الأداء والموديولات التقنية). يعمل المحمّل كطبقة تشغيل يستخدمها السيرفر لاكتشاف ملفات JAR الخاصة بالموديولات وتحميلها وتنفيذها من مجلد mods/، مما يتيح تغييرات على اللعب تتراوح بين تعديلات بسيطة لتحسين جودة الحياة وميكانيكيات لعب محوّلة كلياً. يستخدم هذا النشر عبر Docker صورة itzg/minecraft-server مع متغير البيئة TYPE المضبوط على FORGE أو FABRIC، لتحميل الإصدار الصحيح من المحمّل تلقائياً وربطه بإصدار Minecraft المحدد. يعمل السيرفر على المنفذ 25567 (مُربط داخلياً من المنفذ القياسي 25565) لتجنب التعارضات مع سيرفر Java عادي قد يكون يعمل على نفس المضيف.
لماذا تستخدمه
يتيح لك سيرفر معدَّل ذاتي الاستضافة تشغيل أي مجموعة من الموديولات دون التقيد بقائمة موديولات مسموح بها لدى مزود الاستضافة أو حدود ذاكرة تمنع حزم الموديولات الكبيرة من البدء. أنت تتحكم في إصدار Minecraft المحدد، وإصدار Forge أو Fabric المحدد، وكل موديول في الحزمة — وهذا مهم لأن توافق حزم الموديولات مرتبط ارتباطاً وثيقاً بالإصدار، وحتى رفع بسيط لإصدار Forge قد يكسر عشرات الموديولات.
متى تحتاجه
- تريد لعب حزمة موديولات Forge أو Fabric محددة مع مجموعة من الأصدقاء على سيرفر دائم لا يتوقف عندما لا يكون أحد متصلاً
- تبني أو تختبر حزمة موديولات مخصصة وتحتاج بيئة سيرفر نظيفة للتحقق من توافق الموديولات وسلوكها على الخادم
- تتطلب حزمة موديولاتك ذاكرة أو معالجاً أكثر مما يتيحه خطة استضافة مشتركة — VPS يعطيك موارداً مخصصة يمكن التنبؤ بها
- تريد تشغيل نسخ معزولة متعددة من سيرفر معدَّل على نفس المضيف لحزمات موديولات مختلفة دون تدخل إحداها في الأخرى
- تحتاج تحكماً دقيقاً في إصدارات Forge أو Fabric وتهيئة محمّل الموديولات لا يكشفها مزود الاستضافة المُدار
من يحتاجه
- مطورو حزم الموديولات ومؤلفو الموديولات الذين يحتاجون بيئة سيرفر نظيفة وقابلة للتكرار لاختبار تفاعلات الموديولات وتوافقها
- مجموعات الأصدقاء الذين يريدون عالماً معدَّلاً دائماً دون الاعتماد على جلسات LAN أو تشغيل PC أحدهم باستمرار
- مشغّلو سيرفرات المجتمع الذين يديرون حزمة Forge أو Fabric منسقة لقاعدة لاعبين محددة
- هواة الاستضافة الذاتية الذين يديرون سيرفرات ألعاب على VPS ويريدون إضافة نسخة Minecraft معدَّلة إلى نفس البنية التحتية
- لاعبو Minecraft التقنيون الذين يعملون مع حزمات موديولات كبيرة ومعقدة مثل Create أو ATM أو Enigmatica التي تتطلب موارد سيرفر مخصصة
حالات الاستخدام الشائعة
- استضافة عالم بقاء معدَّل دائم مع حزمة Forge منسقة (مثل Create: Above and Beyond أو All the Mods) لمجموعة لاعبين محددة
- تشغيل سيرفر Fabric مع موديولات أداء (Lithium وStarlight) وموديولات تقنية لتجربة متعددة اللاعبين قريبة من Vanilla لكن محسَّنة
- إعداد بيئة تطوير لمؤلف حزمة موديولات لاختبار توافق الموديولات مع بعضها وسلوك الأعطال من جانب السيرفر قبل الإطلاق للاعبين
- استضافة سيرفر Minecraft معدَّل في حاوية Docker جنباً إلى جنب مع خدمات أخرى على نفس VPS، معزول وقابل للإدارة باستقلالية
الميزات الرئيسية
- محمّل موديولات مُهيَّأ مسبقاً (Forge أو Fabric) يُثبَّت تلقائياً بواسطة صورة itzg/minecraft-server عبر متغير البيئة TYPE
- المنفذ 25567 لاتصالات اللاعبين (مُربط داخلياً من 25565) للسماح بالتشغيل جانب سيرفر Java عادي على نفس المضيف
- تحميل الموديولات من مجلد mods/ — ضع ملفات JAR وأعد تشغيل الحاوية لتحميل أي موديول متوافق
- دعم مجموعة Minecraft ومحمّل موديولات بإصدار محدد، مما يمنع التعارضات غير المقصودة في الإصدار التي تكسر حزم الموديولات
- تخصيص ذاكرة يعتمد على متغيرات البيئة لضبط حجم JVM heap المناسب لحزمات الموديولات الكبيرة التي تحتاج 4-8+ جيجابايت
- تحكم كامل في server.properties لبذرة العالم والصعوبة وأقصى لاعبين ومسافة الرؤية وجميع الإعدادات القياسية الأخرى
- دورة حياة مُدارة بـ Docker مع restart: unless-stopped لضمان بقاء السيرفر المعدَّل عبر إعادات تشغيل المضيف دون تدخل يدوي
- متوافق مع mcrcon وعملاء RCON آخرين لإدارة وحدة التحكم عن بُعد عند تفعيل enable-rcon=true
كيفية الاستخدام بعد التثبيت
- افتح المنفذ TCP 25567 في جدار الحماية: ufw allow 25567/tcp — هذا هو المنفذ الذي يتصل منه اللاعبون بهذا السيرفر المعدَّل
- ثبّت موديولات حزمتك من جانب السيرفر بوضع ملفات JAR في مجلد mods/ داخل مجلد بيانات السيرفر، ثم أعد تشغيل الحاوية
- تأكد من تشغيل جميع اللاعبين نفس الموديولات من جانب العميل بإصدارات متطابقة — كلٌّ من Forge وFabric يتطلب تطابق قوائم الموديولات بين العميل والسيرفر لمعظم الموديولات
- على عميل Minecraft Java Edition، اذهب إلى Multiplayer → Add Server وأدخل IP السيرفر والمنفذ 25567 للاتصال
- راجع docker logs minecraft-modded -f بعد التشغيل الأول لتأكد تحميل جميع الموديولات بدون أخطاء قبل محاولة اتصال اللاعبين
- اضبط حداً للذاكرة مناسباً لحزمة موديولاتك — حزمة Forge كبيرة نموذجية تحتاج 4-6 جيجابايت على الأقل؛ عدّل متغير MEMORY في docker-compose.yml
أفضل ممارسات الأمان
- أبقِ online-mode=true في server.properties لتقتصر الوصول على حسابات Java Edition المصادَق عليها — لا تعطّله إلا إذا احتجت بيئة LAN في وضع عدم الاتصال تحديداً
- افتح فقط المنفذ 25567/tcp في جدار الحماية — لا توجد واجهة ويب أو API أو منفذ إدارة تكشفه حاوية السيرفر المعدَّل
- فعّل القائمة البيضاء (white-list=true) لتقييد الانضمام على اللاعبين الذين رخّصتهم صراحةً، مانعاً اتصال اللاعبين غير المدعوّين حتى مع حسابات صالحة
- احرص على تحديث صورة itzg/minecraft-server لتلقي إصلاحات الأمان وتحديثات دعم إصدارات المحمّل
- افحص الموديولات قبل تثبيتها على سيرفرك — استخدم فقط الموديولات من مصادر موثوقة (CurseForge أو Modrinth) لتجنب ملفات JAR الضارة
المنافذ وإعدادات جدار الحماية
يعمل سيرفر Minecraft المعدَّل على المنفذ TCP 25567، والذي يُربط داخلياً بالمنفذ القياسي 25565 داخل الحاوية. هذا الإزاحة تسمح للسيرفر المعدَّل وسيرفر Java العادي بالتعايش على نفس المضيف دون تعارض في المنافذ. يتصل اللاعبون بالمنفذ 25567 من قائمة Multiplayer في عميل Minecraft Java. لا حاجة لفتح منافذ أخرى — لا توجد واجهة إدارة ويب أو API مكشوفة في هذا الإعداد. إذا فعّلت RCON، قيّد المنفذ 25575 على localhost أو عنوان IP إدارة موثوق فقط.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً مجلدات بيانات العالم — تحتوي على جميع الأجزاء المُولَّدة وبيانات لعب اللاعبين وملف level.dat مع بذرة العالم وقواعد اللعبة
- انسخ احتياطياً مجلد mods/ وأي ملفات إعداد موديولات في config/ — تعرّف هذه الملفات الحالة الدقيقة لحزمة موديولاتك وهي ضرورية لاستعادة سيرفر وظيفي
- انسخ احتياطياً server.properties وwhitelist.json وops.json للحفاظ على صلاحيات اللاعبين وإعدادات السيرفر
- أوقف السيرفر قبل النسخ الاحتياطي (docker stop minecraft-modded) لتجنب تلف العالم من حفظ أجزاء جارٍ
- اختبر الاستعادة بتشغيل حاوية جديدة ببيانات النسخة الاحتياطية والتحقق من تحميل جميع الموديولات وتوليد العالم بشكل صحيح
الأخطاء الشائعة
- عدم تطابق إصدارات Minecraft بين السيرفر وحزمة موديولات العميل — حتى فارق إصدار صغير (مثل 1.20.1 مقابل 1.20.4) سيمنع اتصال العملاء
- تشغيل سيرفر Forge مع موديولات Fabric أو العكس — موديولات Forge وFabric ليست قابلة للتبادل وستفشل في التحميل على المحمّل الخاطئ
- تخصيص ذاكرة غير كافية — تحتاج حزم الموديولات الكبيرة في الغالب 4-8 جيجابايت من JVM heap؛ تخصيص Docker الافتراضي سيتسبب في أخطاء OutOfMemoryError عند التشغيل الأول
- عدم إعادة تشغيل الحاوية بعد إضافة موديولات إلى مجلد mods/ أو إزالتها — يقرأ السيرفر قائمة الموديولات فقط عند البدء
- تضمين موديولات العميل فقط في مجلد mods/ للسيرفر — كثير من موديولات الرسومات والواجهة تُعطّل السيرفر لأنها تستدعي فئات متاحة فقط من جانب العميل
- نسيان فتح المنفذ 25567 في جدار الحماية — سيرى اللاعبون 'Connection refused' بدون رسالة خطأ مفيدة إذا كان هذا المنفذ TCP محجوباً
استكشاف الأخطاء وإصلاحها
- السيرفر يتعطل عند البدء — راجع docker logs minecraft-modded لتقرير عطل الموديول؛ السطر الأول 'caused by' يحدد عادةً الموديول الإشكالي أو تبعية مفقودة
- اللاعبون لا يستطيعون الاتصال — تحقق من فتح المنفذ TCP 25567 (ufw status) وتشغيل الحاوية (docker ps)، وأن جميع اللاعبين يستخدمون نفس قائمة الموديولات والإصدارات تماماً كالسيرفر
- خطأ OutOfMemoryError في السجلات — زد متغير MEMORY في docker-compose.yml (مثل MEMORY=6G لحزمة Forge كبيرة) وأعد التشغيل
- فشل تحميل موديول مع خطأ 'dependency not found' — ثبّت JAR التبعية المفقودة في مجلد mods/ وأعد التشغيل
- يتولّد العالم لكن الموديولات لا تبدو نشطة — تأكد من تطابق متغير TYPE مع محمّل الموديولات (FORGE أو FABRIC) وتحديد الإصدار الصحيح
- ينقطع اتصال العميل فوراً مع 'mod list mismatch' — تأكد من تثبيت كل موديول مطلوب على السيرفر أيضاً من جانب العميل بنفس الإصدار تماماً
البدائل
سيرفر Minecraft Java العادي هو الخيار الصحيح إذا لم تحتج موديولات — أسهل في التشغيل والتحديث بدون مشاكل توافق الموديولات. سيرفرات Paper/Spigot تدعم الإضافات (وليس موديولات Forge/Fabric) وهي أفضل للعب القائم على الإضافات. خدمات استضافة حزم الموديولات المُدارة مثل Nodecraft وApex Hosting وBisectHosting تقدم نشراً بنقرة واحدة مع دعم بتكلفة متكررة. ATLauncher وCurseForge وPrism Launcher تدعم تصدير حزمة السيرفر التي تتزاوج مع هذا الإعداد على Docker.
متى لا تستخدمه
تجنب سيرفراً معدَّلاً إذا كان لاعبوك على Bedrock Edition — موديولات Forge وFabric تعمل فقط مع عملاء Java Edition. إذا أردت إضافات (اقتصاد ومطالبة أراضٍ وصلاحيات) بدلاً من موديولات، فسيرفر Paper أنسب لأن معظم إضافات Spigot/Bukkit لا تعمل على سيرفر Forge والعكس. إذا كانت حزمة موديولاتك صغيرة ومجموعتك تلعب أحياناً فقط، فخدمة الاستضافة المُدارة بنشر حزمة موديولات بنقرة واحدة أبسط من صيانة حاوية Docker ذاتية الاستضافة مع إدارة توافق الموديولات.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين Forge وFabric؟
Forge هو محمّل موديولات Java Edition المسيطر تاريخياً مع أكبر نظام موديولات — معظم حزم الموديولات الكبرى (Feed the Beast وAll the Mods وTechnic) تستخدم Forge. إنه أثقل وأبطأ في البدء لكن لديه عقود من دعم الموديولات. Fabric هو محمّل موديولات أخف وأسرع اكتسب شعبية لموديولات الأداء (Sodium وLithium وStarlight) والموديولات التقنية الحديثة. الاثنان غير متوافقَين — سيرفر Forge لا يمكنه تحميل موديولات Fabric والعكس.
لماذا يستخدم هذا السيرفر المنفذ 25567 بدلاً من 25565؟
يُستخدم المنفذ 25567 لكي يتمكن السيرفر المعدَّل من العمل على نفس المضيف مع سيرفر Minecraft Java قياسي (الذي يستخدم 25565) دون تعارض في المنافذ. تستخدم حاوية Docker داخلياً المنفذ 25565 — الربط من جانب المضيف فقط هو المختلف. يتصل اللاعبون بالمنفذ 25567 من قائمة Add Server في عميل Minecraft.
هل يحتاج اللاعبون لتثبيت نفس الموديولات كالسيرفر؟
نعم، لمعظم الموديولات. موديولات Forge وFabric التي تُعدّل اللعب أو تُضيف عناصر أو تُغيّر توليد العالم يجب تثبيتها على كل من السيرفر والعميل بإصدارات متطابقة. بعض الموديولات تعمل من جانب السيرفر فقط (تعمل دون تثبيت من جانب العميل) وبعضها من جانب العميل فقط (يجب عدم تثبيتها على السيرفر). ارجع دائماً لتوثيق الموديول لمعرفة الفئة التي ينتمي إليها.
كيف أضيف موديولات إلى السيرفر؟
ضع ملفات JAR للموديولات في مجلد mods/ داخل مجلد بيانات السيرفر (في /root/docker/minecraft-modded/data/mods/ افتراضياً). أوقف الحاوية، أضف ملفات JAR، ثم أعد التشغيل. يحمّل السيرفر جميع ملفات JAR من مجلد mods/ عند البدء. أزل موديولاً بحذف JAR الخاص به وإعادة التشغيل.
كم من الذاكرة يحتاج سيرفر معدَّل؟
سيرفر Fabric صغير مع موديولات خفيفة قليلة يحتاج 2-3 جيجابايت. حزمة Forge متوسطة (30-100 موديول) تحتاج عادةً 4-6 جيجابايت. حزمة موديولات كبيرة أو ثقيلة (أكثر من 100 موديول، موديولات توليد عالم مكثفة مثل Biomes O'Plenty أو Terralith) قد تحتاج 6-10 جيجابايت. اضبط متغير MEMORY في docker-compose.yml وفقاً لذلك وراقب الاستخدام الفعلي بـ docker stats.