👨💻 تثبيت Judge0 — واجهة برمجية لصندوق تنفيذ الأكواد
انشر Judge0 على Ubuntu بـ Docker — واجهة برمجية مفتوحة المصدر تُترجم وتُشغّل أكواداً غير موثوقة بأكثر من 60 لغة داخل صندوق معزول، مع PostgreSQL وRedis خلفها.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/judge0/judge0-ubuntu.sh
chmod +x judge0-ubuntu.sh
sudo bash judge0-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/judge0/judge0-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x judge0-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، يشغّل PostgreSQL 16 وRedis 7، ثم يطلق واجهة Judge0 البرمجية وعمّالها على المنفذ 2358. تعمل الحاويتان في الوضع المميّز (privileged) لأن صندوق isolate المعزول يتطلب ذلك.
sudo bash judge0-ubuntu.sh
4 إرسال كود للواجهة البرمجية
لا يملك Judge0 واجهة ويب — إنه واجهة برمجية فقط. تحقق أنه يعمل واعرض اللغات المتاحة:
curl http://<your-server-ip>:2358/languages
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 2358 | REST API (no web UI) — never expose publicly |
| internal | PostgreSQL 16 + Redis 7 + judge0-workers |
| privileged | API and workers run privileged — isolate sandbox requires it |
نظرة عامة
Judge0 هو نظام تنفيذ أكواد عبر الإنترنت مفتوح المصدر وقوي وقابل للتوسع — واجهة REST تُترجم وتُشغّل الكود المصدري بأكثر من 60 لغة برمجة داخل صندوق معزول وتُعيد stdout وstderr ورمز الخروج ووقت التنفيذ واستهلاك الذاكرة. يشغّل Judge0 منصات المسابقات البرمجية ومنصات المقابلات التقنية والأدوات التعليمية التي تتيح للطلاب أو المرشحين تشغيل الكود مباشرة في المتصفح. Judge0 ليس موقعاً تتصفحه — إنه بنية تحتية يتحدث معها تطبيقك الخاص عبر HTTP.
لماذا تستخدمه
بناء ميزة تنفيذ أكواد من الصفر يعني حل مشكلات عزل صعبة: منع الحلقات اللانهائية وقنابل fork واستنزاف الذاكرة والهروب من نظام الملفات أو الشبكة من كود غير موثوق. يحل Judge0 هذا باستخدام isolate، صندوق معزول مُختبَر جيداً بُني أصلاً لأولمبياد المعلوماتية الدولي، ويحزم مترجمات ومفسرات لأكثر من 60 لغة حتى لا تضطر لصيانة تلك السلسلة البرمجية بنفسك. الاستضافة الذاتية لـJudge0 تمنحك تنفيذ أكواد غير محدود وغير محسوب على جهازك الخاص بدلاً من الدفع لكل طلب لواجهة تقييم مُستضافة، وتُبقي الكود المُرسَل — الذي قد يتضمن منطقاً خاصاً أو محتوى امتحان — بعيداً تماماً عن سيرفرات طرف ثالث.
متى تحتاجه
- تبني منصة تقييم برمجي عبر الإنترنت أو منصة مقابلات تقنية أو دورة برمجة تحتاج ترجمة وتشغيل كود يرسله المستخدمون
- تحتاج دعم أكثر من 60 لغة برمجة دون تثبيت وصيانة كل مترجم ومفسر بنفسك
- تريد قدرة تنفيذ أكواد غير محدودة وغير محسوبة دون تسعير لكل طلب من خدمة API مُستضافة
- قد يحتوي الكود المُرسَل منطقاً خاصاً أو محتوى امتحان يجب ألا يغادر بنيتك التحتية الخاصة أبداً
- تحتاج تنفيذ كود برمجي وغير متزامن — أرسل الكود، استطلع أو استلم رد استدعاء، واستقبل stdout/stderr/حالة الخروج
- تبني أدوات تصحيح أو اختبار تلقائية تحتاج تشغيل كود غير موثوق بأمان وعلى نطاق واسع
من يحتاجه
- المطورون الذين يبنون منصات تقييم برمجي عبر الإنترنت أو منصات مسابقات برمجية أو مواقع تدريب على طراز LeetCode
- معسكرات التدريب والجامعات التي تُشغّل واجبات وامتحانات برمجية بتصحيح تلقائي
- الشركات التي تبني منصات مقابلات تقنية أو تقييمات برمجية منزلية
- فرق التقنية التعليمية التي تضيف ميزة 'تشغيل الكود' داخل المتصفح لدروس برمجية تفاعلية
- منظمو الهاكاثونات ومسابقات CTF (التقاط العلم) الذين يحتاجون تنفيذ كود المشاركين بأمان
- مطورو تطبيقات الذكاء الاصطناعي/النماذج اللغوية الذين يحتاجون صندوقاً معزولاً لتنفيذ كود مُولَّد من نموذج لغوي بأمان
حالات الاستخدام الشائعة
- تشغيل زر 'تشغيل الكود' أو 'إرسال' على منصة مسابقات برمجية أو تقييم عبر الإنترنت
- تصحيح واجبات برمجية تلقائياً بتشغيل كود الطالب مقابل مجموعة حالات اختبار
- تشغيل والتحقق من كود مُولَّد بالذكاء الاصطناعي في تطبيق وكيل أو مساعد برمجي قبل عرض النتائج للمستخدم
- تنفيذ إرسالات كود المرشحين أثناء مقابلة تقنية أو تقييم برمجي منزلي
- توفير صندوق معزول داخل المتصفح لدروس برمجية تفاعلية دون تعريض سيرفراتك الخاصة لكود عشوائي
- اختبار عدد كبير من إرسالات الكود بالتوازي لنظام تسجيل هاكاثون أو CTF
الميزات الرئيسية
- يدعم أكثر من 60 لغة برمجة وإصداراتها، تشمل C وC++ وJava وPython وJavaScript وGo وRust والمزيد
- تنفيذ معزول باستخدام isolate، الذي يفرض حدود وقت المعالج ووقت الجدار والذاكرة والعمليات لكل إرسال
- واجهة REST بسيطة — أرسل الكود المصدري ومعرّف اللغة بطلب POST إلى /submissions، ثم استطلع أو استلم رد استدعاء للنتيجة
- يُعيد نتائج تفصيلية: stdout وstderr ومخرجات الترجمة ورمز الخروج ووقت التنفيذ واستهلاك الذاكرة
- طابور إرسال غير متزامن مدعوم بـRedis حتى تبقى الواجهة سريعة الاستجابة حتى تحت حمل ثقيل
- عمّال قابلون للتوسع أفقياً — أضف المزيد من حاويات judge0-workers لزيادة إنتاجية التنفيذ
- نقطة نهاية إرسال دفعي لتشغيل عدة مقاطع كود في طلب واجهة برمجية واحد
- النشر ذاتي الاستضافة يُبقي تحكماً كاملاً بحدود الموارد واللغات المدعومة والكود المُرسَل
كيفية الاستخدام بعد التثبيت
- تحقق أن الواجهة البرمجية تعمل باستخدام GET /about، التي تُعيد إصدار Judge0 وإعداداته
- اعرض كل اللغات المدعومة ومعرّفاتها الرقمية باستخدام GET /languages قبل إرسال أي كود
- أرسل الكود بطلب POST إلى /submissions مع حقول source_code وlanguage_id وstdin الاختياري
- استطلع GET /submissions/{token} باستخدام الرمز المُعاد من إرسالك لاسترجاع نتيجة التنفيذ
- اضبط متغيّر البيئة AUTHN_TOKEN وتطلّبه في كل طلب حتى يستطيع تطبيقك فقط إرسال الكود
- أبقِ Judge0 على شبكة داخلية يمكن الوصول إليها فقط من خلفيتك — لا تكشفه مباشرة للمستخدمين النهائيين أبداً
- وسّع إنتاجية التنفيذ بإضافة المزيد من حاويات judge0-workers إذا كان تطبيقك يرسل كوداً بحجم كبير
- ادمج الواجهة البرمجية في خلفية تطبيقك، ولا تستدعها أبداً مباشرة من JavaScript جانب العميل
أفضل ممارسات الأمان
- لا تكشف Judge0 مباشرة للإنترنت العام أبداً — الغرض بأكمله هو تنفيذ كود عشوائي، مما يجعل نسخة مفتوحة تعادل تنفيذ كود عن بُعد لأي شخص يجدها
- اضبط دائماً AUTHN_TOKEN وتطلّبه في كل طلب واجهة برمجية حتى تستطيع خلفيتك المصادَق عليها فقط إرسال الكود
- أبقِ المنفذ 2358 على شبكة داخلية أو شبكة Docker يمكن الوصول إليها فقط من خدمة خلفيتك الخاصة
- افهم أن الوضع المميّز مطلوب لصندوق isolate — خفّف من خطر الحاوية الإضافي بتشغيل Judge0 على مضيف أو جهاز افتراضي معزول مخصص لهذا الغرض
- اضبط حدوداً محافظة لوقت المعالج ووقت الجدار والذاكرة لكل إرسال لمنع استنزاف الموارد من طلب واحد
- قيّد معدل الإرسالات في طبقة تطبيقك لمنع إساءة الاستخدام حتى من حسابات مصادَق عليها لكنها مخترقة
- حافظ على تحديث صور Judge0 Docker لتلقي تصحيحات الأمان لصندوق isolate والواجهة البرمجية
- راقب استخدام موارد حاويات العمّال، إذ سيظهر أي خلل أو إرسال خبيث يحاول الهروب من الصندوق المعزول كسلوك غير طبيعي
المنافذ وإعدادات جدار الحماية
تستمع واجهة Judge0 البرمجية على المنفذ 2358 ولا تملك واجهة ويب — يجب ألا تُكشف مباشرة للإنترنت العام أبداً لأن وظيفتها بأكملها تنفيذ كود مُرسَل عشوائي. أبقِ المنفذ 2358 قابلاً للوصول فقط من تطبيق خلفيتك الخاص، إما على شبكة Docker داخلية أو خلف قاعدة جدار حماية مقيّدة بعناوين IP داخلية موثوقة. تعمل PostgreSQL وRedis كخدمات داخلية تستخدمها الواجهة البرمجية وحاويات judge0-workers ولا تُنشر للمضيف. تعمل حاويتا الواجهة البرمجية والعمّال في الوضع المميّز، الذي يتطلبه صندوق isolate لعزل مجموعات التحكم والمساحات — هذا متوقع ويجب ألا يُعامَل كخطأ إعداد.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام باستخدام pg_dump — تخزّن تاريخ الإرسالات وإعداد اللغات وأي إعدادات مخصصة
- انسخ ملف docker-compose.yml وإعدادات البيئة (بما فيها judge0.conf) احتياطياً حتى يمكن إعادة إنشاء النشر بشكل مطابق
- وثّق AUTHN_TOKEN وأي حدود موارد مخصصة بشكل منفصل، إذ هي قيم إعداد حساسة أمنياً
- الكود المصدري للإرسالات ونتائجها عادة بيانات تشغيلية قصيرة العمر — قرّر ما إذا كنت تحتاج احتفاظاً طويل الأمد أو يمكنك الاعتماد على قاعدة بيانات تطبيقك الخاص لذلك
- خزّن النسخ الاحتياطية خارج السيرفر واختبر استعادتها على نسخة تجريبية دورياً للتأكد أن العملية تعمل
- احتفظ بسجل لإصدار Judge0 وإصدارات اللغات المستخدمة، إذ قد تتغير معرّفات اللغات بين إصدارات Judge0 الرئيسية
الأخطاء الشائعة
- كشف المنفذ 2358 مباشرة للإنترنت العام دون AUTHN_TOKEN، مما يحوّل السيرفر لخدمة تنفيذ كود عن بُعد مفتوحة
- استدعاء واجهة Judge0 البرمجية مباشرة من JavaScript جانب العميل، مما يعرّض AUTHN_TOKEN لأي شخص يعرض مصدر الصفحة
- عدم ضبط حدود وقت معالج أو وقت جدار أو ذاكرة لكل إرسال، مما يسمح لإرسال خبيث واحد باستنزاف موارد السيرفر
- التقليل من تقدير متطلبات موارد حاويات العمّال، خاصة عند التعامل مع إرسالات متزامنة كثيرة
- نسيان أن Judge0 لا يملك واجهة ويب وتوقع 'تسجيل الدخول' عبر متصفح بدلاً من دمج واجهة REST
- عدم تشغيل حاويات judge0-workers كافية لحجم الإرسالات، مما يسبب بقاء الإرسالات في الطابور لوقت طويل
- اعتبار Judge0 آمناً للكشف لأنه 'يشغّل الكود فقط' دون احتساب ما يحدث إذا كان الصندوق المعزول مُعدّاً بشكل خاطئ أو تم تجاوزه
استكشاف الأخطاء وإصلاحها
- GET /about يُعيد خطأ اتصال — تحقق من تشغيل حاوية واجهة Judge0 البرمجية وأن المنفذ 2358 غير محظور بالجدار الناري
- الإرسالات تبقى في الطابور للأبد ولا تكتمل أبداً — تحقق أن حاوية judge0-workers تعمل وتستطيع الوصول لطابور Redis
- GET /languages يُعيد قائمة فارغة أو غير متوقعة — تأكد أن حاوية الواجهة البرمجية بدأت بنجاح وراجع سجلاتها لأخطاء بدء التشغيل
- فشل الإرسال بخطأ صندوق معزول — تحقق أن الحاوية تعمل فعلياً في الوضع المميّز، إذ يتطلب صندوق isolate وصولاً لمجموعات التحكم والمساحات
- ترفض الواجهة البرمجية الطلبات بخطأ 401/403 — تأكد أن ترويسة AUTHN_TOKEN في طلبك تطابق الرمز المضبوط على السيرفر
- أخطاء اتصال PostgreSQL عند بدء التشغيل — تحقق أن حاوية postgres سليمة ويمكن الوصول إليها من حاوية الواجهة البرمجية على نفس شبكة Docker
- زمن استجابة مرتفع للإرسالات تحت الحمل — وسّع أفقياً بإضافة المزيد من حاويات judge0-workers، أو تحقق من حدود CPU/الذاكرة على المضيف
البدائل
Piston محرك تنفيذ أكواد مفتوح المصدر أبسط وأخف وزناً بلغات أقل وقابلية تخصيص أقل، لكن إعداده أسهل للمشاريع الأصغر. يقدم Sphere Engine وHackerEarth واجهات برمجية تجارية مُستضافة لتنفيذ الأكواد باتفاقيات مستوى خدمة وبنية تحتية مُدارة، مقايضين تحكم الاستضافة الذاتية بعبء تشغيلي معدوم. يمكن استخدام Firecracker microVMs أو gVisor لبناء صندوق معزول مخصص بالكامل، لكن هذا يتطلب جهداً هندسياً أكبر بكثير من اعتماد نظام Judge0 الجاهز القائم على isolate. للفرق التي تحتاج واجهة برمجية ناضجة وواسعة الانتشار وذاتية الاستضافة لتنفيذ الأكواد بدعم لغات واسع، يبقى Judge0 الخيار مفتوح المصدر الأكثر رسوخاً.
متى لا تستخدمه
Judge0 ليس الأداة الصحيحة إذا كنت تحتاج فقط تشغيل عدد قليل من السكريبتات الداخلية الموثوقة — عبء عزله ومتطلب الوضع المميّز مصممان للكود العدائي غير الموثوق ويضيفان تعقيداً غير ضروري للأتمتة الداخلية البسيطة. إذا كانت حركتك منخفضة جداً ولا تريد تشغيل PostgreSQL وRedis وحاويات العمّال بنفسك، تزيل واجهة برمجية مُستضافة لتنفيذ الأكواد (Sphere Engine، HackerEarth، Piston كخدمة) ذلك العبء التشغيلي مقابل تسعير لكل طلب وتحكم أقل. إذا لم تكن حالة استخدامك تتضمن أبداً تشغيل كود غير موثوق يرسله المستخدمون — مثلاً، تشغيل خطوات بناء تطبيقك الخاص فقط — فنظام تقييم معزول كامل هندسة زائدة غير ضرورية.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
لماذا يُستخدم Judge0؟
Judge0 واجهة REST تُترجم وتُشغّل الكود بأكثر من 60 لغة داخل صندوق معزول. ترسل كوداً مصدرياً ومعرّف لغة، ويُعيد stdout وstderr وحالة الخروج واستهلاك الموارد. يشغّل منصات تقييم عبر الإنترنت ومنصات مقابلات تقنية ومواقع تعليمية تتيح للمستخدمين تشغيل الكود.
لماذا يحتاج Judge0 الوضع المميّز؟
ينفّذ Judge0 الكود داخل isolate، صندوق معزول من عالم المسابقات البرمجية يحتاج مجموعات تحكم وميزات مساحات أسماء لا تحصل عليها حاوية عادية. هذا يتطلب الوضع المميّز.
هل يملك Judge0 واجهة ويب؟
لا. Judge0 واجهة برمجية فقط على المنفذ 2358 — تتفاعل معه عبر HTTP من تطبيقك الخاص. ابدأ بـGET /about للتحقق أنه يعمل وGET /languages لعرض اللغات المدعومة ومعرّفاتها، ثم POST إلى /submissions لتشغيل الكود.
هل من الآمن كشف Judge0 للإنترنت؟
لا — أبداً. الغرض بأكمله من Judge0 هو تنفيذ كود عشوائي، لذا نسخة مفتوحة تعادل فعلياً تنفيذ كود عن بُعد لأي شخص يجدها. أبقِ المنفذ 2358 على شبكة داخلية يمكن الوصول إليها فقط من خلفيتك، واضبط AUTHN_TOKEN حتى يستطيع تطبيقك فقط الإرسال.
لماذا يحتاج Judge0 Redis وحاوية عمّال؟
توضع الإرسالات في طابور بدلاً من تشغيلها مباشرة. تستقبل الواجهة البرمجية إرسالاً، تضعه في طابور Redis، وتُعيد رمزاً؛ تلتقط حاوية judge0-workers المنفصلة المهام من الطابور وتنفّذها. إذا لم تكن العمّال تعمل أو لا تستطيع الوصول لـRedis، ستبقى الإرسالات في الطابور للأبد.