🎮 تثبيت Crafty Controller — لوحة ويب لسيرفرات Minecraft
انشر Crafty Controller على Ubuntu بـ Docker — لوحة ويب سهلة لإنشاء وتشغيل وإدارة عدة سيرفرات Minecraft مع نسخ احتياطي ووصول لوحدة التحكم وإدارة اللاعبين، على المنفذ 8433.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/crafty/crafty-ubuntu.sh
chmod +x crafty-ubuntu.sh
sudo bash crafty-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/crafty/crafty-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x crafty-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم ويُشغّل Crafty Controller عبر HTTPS على المنفذ 8433، مع ربط منفذي اللعبة 25565 و25566، وتخزين السيرفرات والنسخ الاحتياطية والسجلات والإعدادات في أحجام مربوطة.
sudo bash crafty-ubuntu.sh
4 قراءة بيانات الاعتماد الافتراضية وتسجيل الدخول
يكتب Crafty بيانات اعتماد المسؤول المولّدة في ملف عند أول تشغيل. اقرأ هذا الملف، ثم افتح اللوحة عبر HTTPS وسجّل الدخول:
cat /root/docker/crafty/config/default-creds.txt
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8433 | Web panel over HTTPS (host → container 8443) — self-signed cert |
| 25565 / 25566 | Minecraft game ports for your servers |
| default-creds.txt | Generated admin login, written to the config volume |
نظرة عامة
Crafty Controller لوحة إدارة ويب مصممة خصيصاً لاستضافة سيرفرات Minecraft. بدلاً من الاتصال عبر SSH وتشغيل ملفات JAR للسيرفر يدوياً وتحرير ملفات الخصائص من الطرفية، تحصل على لوحة تحكم في المتصفح تنشئ وتضبط سيرفرات جديدة من ملفات JAR الرسمية أو المعدّلة، وتشغّلها وتوقفها، وتبث وحدة تحكم حية لتشغيل الأوامر، وتدير اللاعبين والصلاحيات، وتجدول نسخاً احتياطية تلقائية، وتتيح تشغيل عدة سيرفرات Minecraft مستقلة جنباً إلى جنب على نفس المضيف.
لماذا تستخدمه
تشغيل سيرفر Minecraft من سطر الأوامر يعمل جيداً لعالم واحد تديره بنفسك، لكنه يصبح مملاً بسرعة بمجرد أن تدير عدة سيرفرات أو حزم تعديلات (modpacks) أو مجموعة مشرفين لا يرتاحون لـ SSH وملفات server.properties. يغلّف Crafty Controller دورة حياة سيرفر Minecraft بالكامل — الإنشاء والضبط والتشغيل والإيقاف والتحديث والنسخ الاحتياطي — خلف واجهة ويب أنيقة، بحيث يستطيع أي شخص في فريقك إدارة سيرفر عبر متصفح بدلاً من طرفية. إنه مصمم خصيصاً لـ Minecraft وليس لوحة عامة متعددة الألعاب، مما يجعل الإعداد والاستخدام اليومي أبسط بشكل ملحوظ من البدائل الأثقل.
متى تحتاجه
- تريد تشغيل وإدارة سيرفر Minecraft دون حفظ إعدادات server.properties أو أوامر SSH عن ظهر قلب
- تستضيف عدة سيرفرات Minecraft (إصدارات مختلفة، حزم تعديلات، مجموعات أصدقاء مختلفة) وتريدها كلها في لوحة تحكم واحدة
- لديك أصدقاء أو مشرفون غير تقنيين يحتاجون تشغيل أو إيقاف السيرفرات أو مشاهدة وحدة التحكم أو إدارة اللاعبين دون وصول shell
- تريد نسخاً احتياطية تلقائية مجدولة لعالمك دون كتابة مهام cron وأوامر tar بنفسك
- تريد وحدة تحكم حية للسيرفر في المتصفح لتشغيل الأوامر ومراقبة السجلات دون إبقاء جلسة SSH مفتوحة
- تدير سيرفر مجتمع وتحتاج صلاحيات لاعبين دقيقة ووصولاً للوحة بأدوار محددة لمشرفين مساعدين
من يحتاجه
- مشرفو سيرفرات Minecraft الذين يريدون بديلاً بالمتصفح عن تحرير ملفات الإعداد يدوياً وتشغيل الأوامر عبر SSH
- المجتمعات الصغيرة ومجموعات الأصدقاء الذين يشغّلون عدة عوالم Minecraft (بقاء، إبداعي، معدّل) على مضيف واحد مشترك
- عشاق المختبرات المنزلية والاستضافة الذاتية الذين يشغّلون بالفعل خدمات Docker أخرى ويريدون استضافة سيرفرات ألعاب بنفس الأسلوب
- مالكو السيرفرات الذين يحتاجون تفويض الإدارة اليومية لمشرفين مساعدين غير تقنيين
- مضيفو سيرفرات حزم التعديلات الذين يريدون طريقة سهلة لتبديل ملفات JAR وإدارة إصدارات Java وإعادة تشغيل السيرفرات عبر واجهة
- أي شخص تجاوز مرحلة تشغيل JAR لـ Minecraft يدوياً في جلسة screen أو tmux ويريد إدارة سليمة لدورة حياة السيرفر
حالات الاستخدام الشائعة
- استضافة عدة سيرفرات Minecraft (عادي، معدّل، إصدارات مختلفة) جنباً إلى جنب والتبديل بينها من لوحة تحكم واحدة
- السماح لمشرفي المجتمع بتشغيل وإيقاف ومراقبة وحدة تحكم السيرفر دون منحهم وصول SSH للمضيف
- جدولة نسخ احتياطية تلقائية ليلية للعالم قبل تشغيل تحديثات أو تغييرات إضافات خطرة
- إدارة قوائم اللاعبين البيضاء والحظر وصلاحيات المشغّل عبر اللوحة بدلاً من تحرير ملفات JSON يدوياً
- تشغيل سيرفر تجريبي مؤقت بسرعة لتجربة حزمة تعديلات أو إضافة جديدة قبل نشرها للعالم الرئيسي
- مراقبة استخدام موارد السيرفر وعدد اللاعبين من لوحة التحكم بدلاً من الاتصال عبر SSH لفحص top أو htop
الميزات الرئيسية
- معالج إنشاء سيرفر عبر الويب يدعم Vanilla وPaper وForge وFabric وأنواع سيرفرات Minecraft الشائعة الأخرى
- وحدة تحكم حية وتفاعلية في المتصفح لتشغيل الأوامر ومراقبة مخرجات السيرفر الفورية
- نسخ احتياطية تلقائية مجدولة لبيانات العالم والإعدادات، تُخزَّن في حجم نسخ احتياطي مخصص
- إدارة اللاعبين والصلاحيات، بما في ذلك القوائم البيضاء والحظر وصلاحية المشغّل، دون تحرير ملفات JSON خام
- دعم تشغيل وإدارة عدة سيرفرات Minecraft مستقلة من نسخة Crafty واحدة
- وصول للوحة بأدوار محددة بحيث يمكن منح مشرفين مساعدين صلاحيات محددة دون تحكم إداري كامل
- مراقبة استخدام الموارد (CPU، رام) لكل سيرفر مباشرة في لوحة التحكم
- HTTPS بشهادة موقّعة ذاتياً جاهز من البداية للوحة الويب، فالاتصال مشفّر حتى دون وكيل عكسي منفصل
كيفية الاستخدام بعد التثبيت
- اقرأ بيانات اعتماد المسؤول المولّدة تلقائياً من config/default-creds.txt وسجّل الدخول عبر HTTPS على المنفذ 8433
- غيّر كلمة مرور المسؤول الافتراضية فور تسجيل الدخول الأول
- أنشئ أول سيرفر Minecraft لك عبر معالج إنشاء السيرفر في اللوحة، مختاراً نوع السيرفر (Vanilla، Paper، Forge، Fabric) والإصدار
- اخصص للسيرفر أحد المنفذين المُعيَّنين (25565 أو 25566) حتى يستطيع اللاعبون خارج اللوحة الاتصال فعلياً
- اضبط نسخاً احتياطية تلقائية مجدولة لكل سيرفر تحت تبويب Backups الخاص به حتى لا تعتمد على لقطات يدوية
- اضبط صلاحيات اللاعبين والقائمة البيضاء وحالة المشغّل لعالمك عبر اللوحة بدلاً من تحرير الملفات يدوياً
- أضف حسابات مسؤول أو مشرف إضافية بأدوار محددة إذا كان أشخاص آخرون سيساعدون في إدارة السيرفرات
- راقب وحدة التحكم الحية بعد تشغيل سيرفر للتأكد من أنه حُمِّل بشكل صحيح قبل دعوة اللاعبين للانضمام
أفضل ممارسات الأمان
- غيّر كلمة مرور المسؤول المولّدة تلقائياً فور تسجيل الدخول الأول ولا تترك بيانات الاعتماد الافتراضية كما هي
- تقبّل تحذير الشهادة الموقّعة ذاتياً عن وعي، أو استبدلها بشهادة حقيقية عبر وكيل عكسي إذا كانت اللوحة مكشوفة خارج شبكتك المحلية
- قيّد الوصول للمنفذ 8433 (اللوحة) على الشبكات الموثوقة أو VPN — فهو يمنح تحكماً كاملاً في كل سيرفر Minecraft تديره
- أنشئ حسابات محددة الأدوار لمشرفين مساعدين بدلاً من مشاركة تسجيل دخول المسؤول الرئيسي
- افتح فقط منافذ ألعاب Minecraft (25565/25566) التي يحتاجها سيرفر فعلياً — لا تكشف منافذ مُعيَّنة غير مستخدمة
- حافظ على تحديث صورة Docker الخاصة بـ Crafty Controller لتحصل على إصلاحات أمان واستقرار
- راجع بانتظام أي حسابات مسؤول ومشرف تملك وصولاً للوحة وأزل أي حساب لم يعد بحاجته
المنافذ وإعدادات جدار الحماية
تُقدَّم لوحة Crafty Controller عبر HTTPS على المنفذ 8433 على المضيف (مربوط بالمنفذ الداخلي 8443 للحاوية) بشهادة موقّعة ذاتياً، لذا ستُظهر المتصفحات تحذير شهادة ما لم تضع شهادة حقيقية أمامها عبر وكيل عكسي. حركة لعبة Minecraft الفعلية تستخدم منافذ منفصلة — يربط هذا النشر المنفذ 25565 (المنفذ الافتراضي القياسي لـ Minecraft) والمنفذ 25566 لسيرفر ثانٍ — ويجب تعيين أحد هذين المنفذين لكل سيرفر تنشئه في اللوحة ليكون متاحاً للاعبين. افتح فقط منافذ الألعاب للسيرفرات التي تعمل فعلياً، وقيّد الوصول للمنفذ 8433 الخاص باللوحة على جهات موثوقة، لأنه يتحكم في كل سيرفر على المضيف.
النسخ الاحتياطي والصيانة
- استخدم ميزة النسخ الاحتياطي المجدول المدمجة في Crafty لكل سيرفر حتى تُلتقط حفظات العالم تلقائياً دون تدخل يدوي
- تأكد أن النسخ الاحتياطية تصل لحجم النسخ الاحتياطي المربوط على المضيف، وليس فقط داخل تخزين الحاوية المؤقت
- انسخ حجم النسخ الاحتياطي لتخزين خارج السيرفر دورياً، لأن عطل قرص المضيف سيدمّر العوالم الحية ونسخها الاحتياطية معاً بخلاف ذلك
- انسخ حجم config احتياطياً أيضاً، لأنه يحتوي تعريفات السيرفرات وحسابات المستخدمين وملف default-creds.txt
- اختبر استعادة نسخة احتياطية على نسخة Crafty جديدة أحياناً للتأكد أن ملفات النسخ الاحتياطي تُحمَّل فعلياً كعالم يعمل
- احتفظ بعدة لقطات نسخ احتياطية مؤرّخة لكل سيرفر بدلاً من نسخة احتياطية متدحرجة واحدة، في حال عدم ملاحظة تلف فوراً
الأخطاء الشائعة
- عدم تغيير كلمة مرور المسؤول المولّدة تلقائياً بعد قراءتها من default-creds.txt أبداً
- كشف منفذ اللوحة (8433) للإنترنت العام دون تقييد الوصول، مما يمنح أي شخص يجدها تحكماً في سيرفراتك
- نسيان تعيين منفذ لعبة مُعيَّن لسيرفر جديد، مما يتركه غير متاح للاعبين رغم أنه يعمل
- عدم إعداد نسخ احتياطية مجدولة والاعتماد على الذاكرة لنسخ العوالم يدوياً قبل تغييرات خطرة
- تشغيل عدة سيرفرات معدّلة ثقيلة الموارد على عتاد مخصص لسيرفر عادي واحد، مما يسبب بطئاً في جميعها
- فقدان موقع ملف config/default-creds.txt والانحباس خارج اللوحة بعد نسيان كلمة المرور المُغيَّرة
- تعيين نفس منفذ اللعبة لسيرفرين مختلفين، مما يسبب تعارض منفذ يمنع أحدهما من التشغيل
استكشاف الأخطاء وإصلاحها
- تعذّر تسجيل الدخول للوحة — أعد قراءة config/default-creds.txt لبيانات الاعتماد المولّدة الأصلية، أو أعد ضبط كلمة مرور المسؤول من المضيف إذا كنت محبوساً خارجها
- يحذّر المتصفح من شهادة غير صالحة — هذا متوقع مع الشهادة الافتراضية الموقّعة ذاتياً؛ تقبّل التحذير أو ضع وكيلاً عكسياً بشهادة حقيقية أمام اللوحة
- سيرفر Minecraft لا يبدأ — تحقق من وحدة التحكم الحية في اللوحة بحثاً عن عدم تطابق إصدار Java أو ملفات عالم تالفة أو ذاكرة مخصصة غير كافية
- لا يستطيع اللاعبون الاتصال بسيرفر — تأكد أن السيرفر عُيِّن له أحد منفذي اللعبة (25565/25566) وأن جدار الحماية يسمح بذلك المنفذ
- النسخ الاحتياطية لا تظهر — تحقق أن حجم النسخ الاحتياطي مربوط بشكل صحيح على المضيف وأن مهمة النسخ الاحتياطي المجدولة مفعّلة فعلياً لذلك السيرفر
- السيرفر يتأخر أو يتعطل تحت الحمل — تحقق من استخدام CPU وRAM على المضيف، لأن تشغيل عدة سيرفرات أو حزم تعديلات يتنافس على نفس الموارد
- اللوحة تصبح غير متاحة بعد إعادة تشغيل المضيف — تأكد أن سياسة إعادة تشغيل حاوية Crafty مضبوطة على unless-stopped
البدائل
Pterodactyl لوحة أقوى بكثير ومتعددة الألعاب ببنية daemon/node مصممة لشركات الاستضافة التي تشغّل سيرفرات كثيرة لعملاء كثر — قادرة لكنها أعقد بشكل ملحوظ في النشر والصيانة. AMP (Application Management Panel) خيار آخر متعدد الألعاب بواجهة أنيقة لكن بنموذج ترخيص مدفوع للنشر الكبير. MCSManager بديل أخف يقوده المجتمع ويركّز أساساً على Minecraft، بروح مشابهة لـ Crafty. لسيرفر Minecraft واحد يديره شخص واحد، حتى خدمة systemd بسيطة أو جلسة tmux تعمل دون أي لوحة إطلاقاً. تميّز Crafty Controller هو تركيزه على Minecraft وسهولة إعداده الحقيقية، دون العبء التشغيلي لمنصة استضافة كاملة متعددة المستأجرين.
متى لا تستخدمه
إذا كنت تشغّل سيرفر Minecraft واحداً فقط لنفسك وتشعر بالراحة مع SSH وserver.properties، فإن لوحة الويب تضيف طبقة قد لا تحتاجها. إذا كنت تخطط لاستضافة ألعاب كثيرة غير Minecraft (Rust، ARK، وغيرها) أو تقديم استضافة لعملاء مدفوعين، فإن بنية Pterodactyl الأنضج متعددة الألعاب خيار أفضل على المدى الطويل رغم التعقيد الإضافي. وصول لوحة Crafty للمشرفين شبه كلي إلى حد ما — إذا احتجت تحكماً دقيقاً جداً بالصلاحيات لكل ميزة لفريق إشراف كبير، فمنصة أنضج قد تخدم ذلك بشكل أفضل. لمشروع استضافة كبير يشغّل عشرات سيرفرات العملاء، سيصل تصميم Crafty الأبسط بعقدة واحدة لحدوده أسرع من لوحة daemon/node مناسبة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Crafty Controller؟
إنه لوحة إدارة ويب لسيرفرات Minecraft. بدلاً من تشغيل ملفات JAR للسيرفر عبر SSH وتحرير ملفات الإعداد يدوياً، تحصل على واجهة متصفح تنشئ السيرفرات، وتشغّلها وتوقفها، وتعرض وحدة تحكم حية لتشغيل الأوامر، وتدير اللاعبين والصلاحيات، وتجدول نسخاً احتياطية تلقائية، وتتيح تشغيل عدة سيرفرات Minecraft مستقلة من لوحة تحكم واحدة.
ما المنفذ وما بيانات الدخول؟
تُقدَّم اللوحة عبر HTTPS على المنفذ 8433 على المضيف (مربوط من منفذ الحاوية 8443)، فتصفّح بـ https:// وتقبّل تحذير الشهادة الموقّعة ذاتياً. يولّد Crafty بيانات اعتماد المسؤول عند أول تشغيل ويكتبها في config/default-creds.txt.
ما المنافذ التي تستخدمها سيرفرات Minecraft الخاصة بي؟
يربط هذا النشر منفذي اللعبة 25565 و25566 — 25565 هو المنفذ القياسي لـ Minecraft. عند إنشاء سيرفر في Crafty، عيّن له أحد هذين المنفذين المُعيَّنين حتى يستطيع اللاعبون الوصول إليه.
هل يتعامل مع النسخ الاحتياطي؟
نعم، وهذا أحد أفضل أسباب استخدامه. يستطيع Crafty أخذ نسخ احتياطية تلقائية مجدولة لعوالمك، تُخزَّن في حجم النسخ الاحتياطي.
كيف يُقارَن بـ Pterodactyl؟
Pterodactyl لوحة أقوى بكثير ومتعددة الألعاب ببنية daemon/node مصممة لشركات الاستضافة التي تشغّل سيرفرات كثيرة لعملاء كثر — قادرة لكنها أعقد بكثير في النشر. Crafty Controller يركّز على Minecraft وأبسط بكثير في الإعداد والاستخدام.