Install
git clone https://github.com/beenuar/AiSOC && cd AiSOC
make upلمن هذا مناسب
- للفرق الأمنية أو الباحثين الأفراد الذين يرغبون في تشغيل مركز عمليات أمنية (SOC) مدعوم بالذكاء الاصطناعي على جهاز محلي أو خوادمهم الخاصة: AiSOC مشروع مفتوح المصدر وقابل للاستضافة الذاتية، يستقبل بيانات القياس الأمني (telemetry)، ويكتشف التهديدات ويربطها، ويجري التحقيقات عبر وكلاء ذكاء اصطناعي بعمليات استدلال قابلة للتدقيق، ويقترح إجراءات استجابة تُعتمد من قبل الإنسان.
- للمستخدمين الذين يريدون تشغيله دون الاعتماد على مفاتيح API سحابية: تشير الوثائق الرسمية إلى أنه يعمل دون مفتاح API.
- للمستخدمين الذين يعملون بعملاء مثل Claude أو Cursor أو Continue ويريدون الاتصال به عبر MCP.
الحالات غير المناسبة:
- المستخدمون الذين لا يملكون بيئة Docker تلبي متطلبات الموارد (انظر المتطلبات أدناه) لن يتمكنوا من إتمام التثبيت.
- لم توضح الأدلة ما إذا كان مناسبًا كبديل إنتاجي لمركز عمليات أمنية، ولا صيغ مصادر القياس الأمني المحددة المدعومة؛ فهذه أمور مجهولة، ويجب التحقق منها بنفسك في المستودع قبل الاختيار.
أول تجربة في 3 دقائق
المسار الرئيسي الموصى به هو البدء السريع (Quick start) الرسمي: استنساخ المستودع وتشغيله باستخدام make.
المتطلبات المسبقة:
- Docker Compose v2، مع ذاكرة 8 جيجابايت و20 جيجابايت من مساحة القرص المتاحة في آلة Docker الافتراضية.
python3(الإصدار 3.9 فما فوق) وbash.- إذا لم تكن متأكدًا من مطابقة بيئتك للمتطلبات، شغّل أولًا الأمر
make doctorالمقدم رسميًا، فهو يتحقق من جميع المتطلبات المذكورة أعلاه.
التثبيت والتشغيل (الأوامر كما وردت في المصدر الرسمي):
git clone https://github.com/beenuar/AiSOC && cd AiSOC
make up
في أول تشغيل، سيتم تنزيل نماذج بحجم حوالي 2 جيجابايت وتخزينها في وحدة تخزين (volume) لا تُحذف إلا عبر make clean — وهذا أثر جانبي يجب معرفته قبل التشغيل.
إشارة النجاح: بعد تشغيل الخدمات محليًا، يمكنك التفاعل معها عبر واجهتها أو واجهة MCP. لم تقدم الأدلة خطوات واجهة محددة بعد أول تشغيل ولا عنوان الوصول الافتراضي، لذا اعتمد في هذه الخطوة على الشروح اللاحقة في ملف README بالمستودع.
تجربة أولى منخفضة المخاطر: لم تُدرج الأدلة أسماء أدوات MCP المحددة ولا خصائص القراءة/الكتابة لها، لذا لا يمكن تحديد أداة "للقراءة فقط" بعينها كأول استدعاء. قبل التأكد من الآثار الجانبية للأدوات، يُنصح بالبدء باستعراض الوظائف العرضية مثل الواجهة وسجل القرارات (decision ledger)، وتجنب تنفيذ عمليات الاستجابة مباشرة.
حالات الاستخدام
الحالة الأولى: فحص البيئة قبل التشغيل.
السيناريو: لست متأكدًا مما إذا كانت موارد آلة Docker الافتراضية لديك كافية. الطريقة: بعد استنساخ المستودع، شغّل make doctor أولًا، وسيتحقق بندًا بندًا من Docker Compose v2، وذاكرة 8 جيجابايت، و20 جيجابايت من القرص، وpython3 3.9+، وbash. النتيجة المتوقعة: بعد نجاح الفحص، نفّذ make up، لتجنب فشل أول تشغيل في منتصفه بسبب نقص الموارد.
الحالة الثانية: الاتصال بـ AiSOC عبر MCP من داخل Claude أو Cursor أو Continue. السيناريو: تريد الاستعلام مباشرة عن نتائج الكشف أو استنتاجات التحقيق من AiSOC داخل هذه العملاء. الطريقة: تشير الوثائق الرسمية للمشروع إلى أنه يتضمن MCP server موجّهًا لـ Claude وCursor وContinue؛ أما حقول الإعداد وطريقة الاتصال في كل عميل تحديدًا، فلم تقدم الأدلة مقاطع إعداد حرفية، ويجب الاعتماد على تعليمات إعداد MCP المقابلة في المستودع. الحدود المؤكدة: يمكن التأكيد على أنه يوفر MCP server مع العملاء المستهدفة، لكن قائمة الأدوات المتاحة بعد أول اتصال، والمعاملات، وصيغ المخرجات تندرج ضمن ما لم تغطه الأدلة، ولا ينبغي افتراضها.
حدود الاستخدام
- طبيعة القراءة/الكتابة: يستقبل بيانات القياس الأمني ويكتشف التهديدات، ويجري وكلاء الذكاء الاصطناعي التحقيقات و"يقترحون" الاستجابات، لكن الاستجابة تُعتمد من قبل الإنسان — أي أن عمليات الكتابة لها نقطة تأكيد. لم توضح الأدلة أي أدوات MCP هي للقراءة فقط وأيها يطلق إجراءات فعلية.
- البيانات المحلية والآثار على القرص: أول تشغيل ينزّل نماذج بحجم حوالي 2 جيجابايت إلى وحدة تخزين، ولا يمكن حذفها إلا عبر
make clean؛ وهذا يستهلك مساحة قرص حقيقية، وعملية الحذف نفسها تمحو محتوى تلك الوحدة. - متطلبات بيانات الاعتماد: تشير الوثائق الرسمية إلى أنه يعمل دون مفتاح API، ولم تُذكر متطلبات بيانات اعتماد أخرى.
- قيود صريحة: يتطلب Docker Compose v2 (ذاكرة 8 جيجابايت / قرص 20 جيجابايت)، وpython3 3.9+، وbash.
- ما لم يُؤكد بعد: قائمة أدوات MCP المحددة، وخصائص القراءة فقط لكل أداة، ومنفذ الوصول الافتراضي، وأنواع مصادر القياس الأمني المدعومة، وإجراءات الترقية وإلغاء التثبيت — لم تقدمها الصفحة الرسمية ضمن الأدلة الحالية، ويجب مراجعة أحدث نسخة من README في المستودع قبل الاستخدام.