فرييرن: الإطار الصغير للأدوات الأمنية

الوصف

فرييرن هو إطار لتشغيل الأدوات الأمنية على أجهزة توجيه OpenWrt وأجهزة الكمبيوتر ذات اللوحة الواحدة (SBCs). يوفر لوحة تحكم ويب مع إدارة WiFi ووحدات قابلة للتثبيت وطرفية مدمجة ومدير حزم. تتكون الحزمة من واجهة برمجة تطبيقات خلفية PHP مع واجهة أمامية React، مصممة لتكون خفيفة الوزن بما يكفي للأجهزة المدمجة مع بقائها قابلة للتوسيع من خلال وحدات الطرف الثالث.

الميزات

• إدارة WiFi — إنشاء وتحرير وإزالة الواجهات اللاسلكية. فحص الشبكات، تكوين الراديوات، تحرير إعدادات UCI الخام.
• الشبكة — إدارة واجهات الشبكة، عرض عقود DHCP، وتشغيل تشخيصات الاتصال.
• نظام الوحدات — تثبيت وإزالة وتثبيت وحدات الطرف الثالث من مستودع بعيد. تُحمّل الوحدات ديناميكيًا كحزم UMD.
• مدير الحزم — تثبيت وإزالة حزم opkg مباشرة من لوحة التحكم.
• طرفية مدمجة — طرفية قائمة على الويب (ttyd) يمكن الوصول إليها من اللوحة.
• أدوات النظام — لوحة معلومات مع إحصائيات النظام، قائمة أجهزة USB، استخدام نظام الملفات، عارض سجل النظام، التشخيصات، والتحكم في خدمات init.d.
• الإعدادات — تكوين اسم المضيف، المنطقة الزمنية، كلمة مرور المستخدم، وسمة اللوحة.
• قابل للتوسيع — إنشاء وحدات جديدة باستخدام frieren-module-template. وحدة تحكم PHP + واجهة أمامية React لكل وحدة.

المكونات

• frieren-back — إطار PHP صغير. واجهة برمجة تطبيقات JSON POST مع مصادقة الجلسة، CSRF، تكامل إعدادات UCI، وORM مصغر.
• frieren-front — تطبيق صفحة واحدة React (Vite, Wouter, Jotai, React Query). يدعم تحميل وحدات UMD ديناميكيًا.
• frieren-module-template — أداة إنشاء لتطوير وحدات الطرف الثالث مع تبعيات مشتركة عبر المتغيرات العامة للنافذة.
• frieren-terminal — @frieren/terminal-core، مكتبة TypeScript/xterm.js مدمجة في الواجهة الأمامية. توفر عميل الطرفية المباشر ttyd، عارض سجل للقراءة فقط، وسمات الطرفية المشتركة.
• tools — أدوات مساعدة للتطوير: وكيل API للتطوير، نص نشر الجهاز، عميل اختبار API، ومصغر PHP.

المستودعات ذات الصلة

• وحدات Frieren: تحتوي على وحدات مطورة من المجتمع بناءً على frieren-module-template. هذا المستودع هو مورد للمستخدمين الذين يسعون لتوسيع وظائف تثبيت Frieren بميزات إضافية.
• إصدار Frieren: يستضيف مثبتات لنشر الإصدارات المترجمة مسبقًا من Frieren. هذا المستودع مثالي للمستخدمين الذين يرغبون في تثبيت Frieren بسرعة وسهولة دون المرور بعملية البناء.
• إصدار وحدات Frieren: خط أنابيب البناء لفهرس الوحدات — يُنشئ فهرس modules.json وحزم tarballs لكل وحدة تقوم اللوحة بتثبيتها منها.

التثبيت

يعمل Frieren على OpenWrt (الإصدارات الرسمية، وليس الفروع). يمكن تثبيته عبر برنامج نصي آلي أو تجميعه يدويًا.

التثبيت السريع

للتثبيت السريع والسهل، قم بتنفيذ الأمر التالي في الطرفية الخاصة بك. سيقوم هذا البرنامج النصي بمعالجة جميع التهيئات وخطوات الإعداد اللازمة:

wget -qO- https://raw.githubusercontent.com/xchwarze/frieren-release/master/install/install-openwrt.sh | sh

جديد في هذا؟ ابدأ من هنا. إذا لم تكن متأكدًا ما هو OpenWrt، أو كيفية وميضه، أو كيفية فتح اللوحة بعد ذلك، اتبع أسئلة التثبيت الشائعة خطوة بخطوة والمناسبة للمبتدئين — فهي ترشدك خلال كل شيء من جهاز نظيف إلى تسجيل الدخول.

التجميع اليدوي

كل مكون داخل مشروع Frieren (frieren-back وfrieren-front وfrieren-module-template) له ملف README.md الخاص به مع تعليمات بناء وتثبيت محددة. يُرجى الرجوع إلى هذه الملفات في أدلتها الخاصة للحصول على إرشادات أكثر تفصيلاً.

تطوير الوحدات

استخدم frieren-module-template لإنشاء وحدات جديدة. قم بتشغيل yarn wizard لإعداد وحدة جديدة، قم بتطوير الميزة، ثم yarn build لتجميع حزمة UMD. راجع README قالب الوحدة للتفاصيل.

الترخيص

هذا المشروع مرخص بموجب PolyForm Noncommercial License 1.0.0.

الاستخدام غير التجاري مسموح به. الاستخدام التجاري غير مسموح به بموجب هذا الترخيص. الاستخدام التجاري يتطلب ترخيصًا تجاريًا منفصلاً من المؤلف.

للترخيص التجاري، اتصل: [email protected]

المساهمة

المساهمات مرحب بها — ميزات جديدة، إصلاحات أخطاء، أو وحدات. راجع README لكل مكون لتعليمات البناء.

المؤلفون

• المطور الرئيسي: DSR! - [email protected]

دعم التطوير

إذا وجدت Frieren مفيدًا، فكر في دعم التطوير. التبرعات تمول أجهزة الاختبار والعمل المستمر. أرسل عبر Binance أو انضم إلى Patreon للحصول على تحديثات وإصدارات حصرية.