opnsense/coreواجهة OPNsense الرسومية، وAPI، والواجهة الخلفية للأنظمة.
يدعو مشروع OPNsense المطورين إلى البدء في المساهمة في قاعدة الكود. لأغراضك الخاصة – أو الأفضل من ذلك – للانضمام إلينا في إنشاء أفضل جدار حماية مفتوح المصدر متاح.
تم تصميم عملية البناء لتسهيل بناء وكتابة الكود على أي شخص. المخطط الرئيسي لقاعدة الكود الجديدة متاح على:
https://docs.opnsense.org/development/architecture.html
هدفنا هو التطور تدريجياً إلى قاعدة كود جديدة بدلاً من استخدام نهج الانفجار الكبير نحو شيء جديد.
لإنشاء برمجيات عاملة مثل OPNsense، تحتاج إلى المصادر والأدوات اللازمة لبنائها. أدوات البناء الخاصة بـ OPNsense متاحة بحرية.
ملاحظات حول كيفية بناء OPNsense يمكن العثور عليها في مستودع الأدوات:
https://github.com/opnsense/tools
يمكنك المساهمة في المشروع بطرق عديدة، على سبيل المثال اختبار الوظائف، إرسال تقارير الأخطاء أو إنشاء طلبات سحب مباشرة عبر GitHub. أي مساعدة مرحب بها دائمًا!
يمكنك معرفة المزيد حول المساهمة في CONTRIBUTING.md.
OPNsense متاح وسيظل متاحًا دائمًا بموجب ترخيص BSD ثنائي البنود:
https://opensource.org/licenses/BSD-2-Clause
كل مساهمة مقدمة إلى المشروع يجب أن تكون مرخصة بنفس الشروط من أجل إبقاء OPNsense حرًا حقًا ومتاحًا للجميع.
يوفر المستودع عددًا من الأهداف التي ترتبط إما بعمليات البناء في tools.git أو تهدف إلى التطوير السريع.
يمكن إنشاء حزمة من الحالة الحالية للمستودع باستخدام هذا الهدف. قد يتطلب تثبيت عدة حزم. سيحاول الهدف تقديم المساعدة في حالة الفشل، على سبيل المثال عندما يلزم جلب ملف مفقود من موقع خارجي.
يوجد العديد من الخيارات لتخصيص الحزمة، على سبيل المثال:
يتم تمرير الخيارات بالشكل التالي:
# make package CORE_NAME=my_new_name
بشكل عام، يتم تعيين الخيارات إما إلى قيم افتراضية معقولة أو يتم اكتشافها تلقائيًا في وقت التشغيل.
سيقوم التحديث بسحب أحدث الالتزامات من الفرع الحالي من المستودع الرئيسي.
ستقوم الترقية بتشغيل بناء الحزمة واستبدال الحزمة المثبتة حاليًا في النظام.
جلب التغييرات من النظام الجاري لجميع الملفات المعروفة.
قم بتشغيل عدة فحوصات بناء الجملة على المستودع. يوصى بذلك قبل إصدار طلب سحب على GitHub.
قم بتشغيل فحوصات النمط PSR12 وPEP8 على كود PHP لنمط MVC وكود Python، على التوالي.
لتسهيل التطوير، قد ترغب في استخدام جهاز افتراضي لـ OPNsense وتثبيت البرنامج المساعد os-debug الذي سيوفر الأدوات اللازمة.
قم بتشغيل العديد من المعقّمات التلقائية على قاعدة الكود.