تخطّى إلى المحتوى الرئيسي
أتمتة

دليل عملي: بناء وكيل اختبار اختراق آلي باستخدام Guardian CLI خطوة بخطوة

دليل عملي: بناء وكيل اختبار اختراق آلي باستخدام Guardian CLI خطوة بخطوة
📑 محتويات المقال
    Reference OS v85 دقائق قراءة٢٩ مايو ٢٠٢٦informational + transactional: يبحث المطورون عن أداة عملية لاختبار الاختراق الآلي بالذكاء الاصطناعي، ويريدون شرحاً خطوة بخطوة للتركيب والتشغيل

    دليل عملي: بناء وكيل اختبار اختراق آلي باستخدام Guardian CLI خطوة بخطوة

    في 20 دقيقة فقط، ستنشئ وكيل اختبار اختراق آلي باستخدام Guardian CLI ومفتاح Gemini مجاني.

    الخلاصة: Guardian CLI هو إطار عمل مفتوح المصدر يجمع بين Google Gemini وLangChain لأتمتة اختبار الاختراق. يتطلب Python 3.11+ ومفتاح Gemini. التثبيت عبر git clone وpip install -e .، ثم تشغيل فحص باستخدام guardian --target <domain> --provider gemini. الأداة مجانية وتدعم…
    دليل Guardian CLI877 كلمة تقريباًزارو — مكتبة الأدلة العملية
    دليل عملي: بناء وكيل اختبار اختراق آلي باستخدام Guardian CLI خطوة بخطوة
    Photo by Keegan Checks on Pexels
    LIVE PROJECTzakirkun/guardian-cli★ 1434Python

    Guardian is a production-ready AI-powered penetration testing automation CLI tool that leverages Google Gemini and LangChain to orchestrate intelligent, step-by-step penetration testing workflows while maintaining ethical hacking standards.

    رابط المشروع على GitHub ↗

    MAP

    خريطة الصفحة

    اختر القسم الذي تحتاجه الآن

    1. ما هو Guardian CLI؟
    2. من يحتاج هذه الأداة ومن لا؟
    3. المميزات الرئيسية
    4. المتطلبات الأساسية
    5. تركيب Guardian CLI خطوة بخطوة
    6. شرح ملف .env وإعداد المفاتيح
    7. تشغيل الأداة: أول اختبار اختراق آلي
    8. الأخطاء الشائعة وحلولها
    9. استخدامات عملية في السوق السعودي
    10. هل يستحق التجربة؟ تقييم موضوعي
    11. بدائل مشابهة (مقارنة سريعة)
    12. أسئلة شائعة
    !

    قبل أن تطبق

    الفكرة التي تمنع التسرع

    تخيل أن لديك فريقاً من 10 مختبرين اختراق يعملون 24 ساعة دون كلل – هذا ما يفعله Guardian CLI، لكن بسعر فنجان قهوة.

    Q

    أسئلة التشخيص السريع

    قبل أن تطبق، اعرف أين تقف بالضبط

    1. هل لديك خبرة أساسية بسطر الأوامر وأدوات الأمن؟
    2. هل جهازك يعمل بنظام Linux أو macOS (أو Windows مع WSL)؟
    3. هل حصلت على مفتاح API من Google Gemini؟
    4. هل قمت بتثبيت Python 3.11+ و Go؟
    5. هل لديك هدف اختبار بإذن قانوني (مثل testphp.vulnweb.com)؟
    6. هل تريد أتمتة جمع المعلومات وفحص الثغرات في خطوة واحدة؟
    7. هل تفضل أداة مجانية على الحلول التجارية مثل BurpSuite Pro؟

    نظام التشغيل: Input → Process → Output

    INPUT
    أمر نصي (CLI) مع تحديد الهدف (مثال: نطاق موقع) ومفاتيح API للذكاء الاصطناعي
    PROCESS
    يستخدم LangChain لتنسيق سير عمل متعدد الخطوات: جمع المعلومات، فحص الثغرات، تحليل النتائج، وتوليد تقرير
    OUTPUT
    تقرير أمني منظم يتضمن الثغرات المكتشفة، الأدلة، وتوصيات الإصلاح
    Decision Layer
    يقرر الوكيل أي أداة يستخدمها في كل خطوة بناءً على سياق الهدف (مثل: استخدام nuclei للثغرات المعروفة)
    Memory Layer
    يتذكر النتائج السابقة داخل الجلسة لتجنب تكرار الفحوصات وتحسين الدقة
    Feedback Loop
    يمكن للمستخدم تعديل الأوامر يدوياً أو إعادة تشغيل خطوات معينة بناءً على النتائج
    M

    لوحة قياس النجاح

    لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه

    المؤشرطريقة القياسإشارة جيدة
    وقت التثبيتساعة توقيت من بدء الأوامر حتى تشغيل الفحص الأول.أقل من 20 دقيقة.
    عدد الثغرات المكتشفةمراجعة التقرير النهائي.اكتشاف 3+ ثغرات على هدف تجريبي.
    معدل الأخطاءعدد مرات فشل الفحص بسبب أخطاء.0 أخطاء في أول فحص.

    إذا كنت تبحث عن طريقة لأتمتة اختبارات الاختراق دون إنفاق آلاف الدولارات على أدوات تجارية، فأنت في المكان الصحيح. Guardian CLI هو مشروع مفتوح المصدر يجمع بين Google Gemini و LangChain لإنشاء وكيل ذكاء اصطناعي يدير سير عمل اختبار الاختراق خطوة بخطوة. في هذا الدليل العملي، ستتعلم كيفية تركيبه وتشغيله على جهازك، مع أمثلة من السوق السعودي.

    هذا الدليل موجه للمطورين ومختصي الأمن من المستوى المتوسط. لا تحتاج إلى خبرة عميقة في الذكاء الاصطناعي، لكنك تحتاج إلى معرفة أساسية بسطر الأوامر وأدوات الأمن. لن ننسخ README، بل سنقدم شرحاً عملياً مع تحذيرات وحلول للمشاكل الشائعة.

    ما هو Guardian CLI؟

    Guardian CLI هو إطار عمل لأتمتة اختبار الاختراق باستخدام الذكاء الاصطناعي. بدلاً من تشغيل كل أداة يدوياً (مثل nuclei، sqlmap، subfinder)، يقوم الوكيل بتنسيقها بناءً على تعليمات ذكية من نماذج Gemini. النتيجة: توفير وقت كبير وتقليل الأخطاء البشرية.

    من يحتاج هذه الأداة ومن لا؟

    إعلان

    من يحتاجها: مختبرو الاختراق المستقلون، فرق الأمن في الشركات الناشئة، طلاب الأمن السيبراني الذين يريدون أتمتة المهام المتكررة.

    من لا يحتاجها: المبتدئون تماماً في الأمن (لأنها تتطلب فهماً أساسياً للثغرات)، أو الفرق التي تستخدم أدوات تجارية متكاملة مثل BurpSuite Pro.

    المميزات الرئيسية

    • يدعم عدة مزودي ذكاء اصطناعي: Gemini، GPT-4، Claude، OpenRouter
    • أتمتة كاملة لسير العمل: من جمع المعلومات إلى التقرير النهائي
    • تكامل مع أدوات مفتوحة المصدر معروفة: nuclei، httpx، subfinder، sqlmap وغيرها
    • تقرير منظم مع أدلة (screenshots، logs)
    • مجاني ومفتوح المصدر (رخصة MIT)

    المتطلبات الأساسية

    • نظام تشغيل: Linux أو macOS (Windows عبر WSL)
    • Python 3.11+
    • Go (لتثبيت بعض الأدوات المساعدة)
    • مفتاح API من Google Gemini (مجاني مع حد استخدام)
    • الأدوات المساعدة: nuclei، httpx، subfinder، sqlmap وغيرها (سيتم تثبيتها لاحقاً)

    تركيب Guardian CLI خطوة بخطوة

    الخطوة 1: تثبيت Python والتبعيات

    sudo apt update && sudo apt install python3 python3-pip git -y  # لأوبونتو/ديبيان

    الخطوة 2: استنساخ المستودع

    git clone https://GitHub.com/zakirkun/guardian-cli.git
    cd guardian-cli

    الخطوة 3: تثبيت الحزمة

    pip install -e .

    الخطوة 4: تثبيت الأدوات المساعدة (نصيحة: استخدم السكربت الآلي في القوالب)

    ملاحظة: بعض الأدوات تحتاج Go. ثبّت Go أولاً من الموقع الرسمي.

    شرح ملف .env وإعداد المفاتيح

    أنشئ ملف .env في المجلد الرئيسي للمشروع بالمحتوى التالي (يمكنك نسخه من القوالب):

    # Guardian CLI Configuration
    # احصل على مفتاح Gemini من https://aistudio.google.com/app/apikey
    GOOGLE_API_KEY=your-gemini-api-key-here
    
    # اختياري: مفاتيح لمزودين آخرين
    # OPENAI_API_KEY=sk-your-key-here
    # ANTHROPIC_API_KEY=sk-ant-your-key-here
    # OPENROUTER_API_KEY=your-key-here

    ثم حمّل المتغيرات: export $(grep -v '^#' .env | xargs)

    تشغيل الأداة: أول اختبار اختراق آلي

    لتشغيل فحص أساسي على نطاق تجريبي:

    guardian --target testphp.vulnweb.com --provider gemini

    سيبدأ الوكيل في جمع المعلومات (subfinder، httpx)، ثم فحص الثغرات (nuclei، sqlmap)، وأخيراً إنشاء تقرير. قد تستغرق العملية 10-15 دقيقة حسب حجم الهدف.

    الأخطاء الشائعة وحلولها

    الخطأالسببالحل
    ModuleNotFoundError: No module named 'guardian'لم يتم تثبيت الحزمة بشكل صحيحتأكد من تنفيذ pip install -e . داخل المجلد
    Error: GOOGLE_API_KEY not setلم يتم تعيين مفتاح Geminiتحقق من ملف .env وقم بتصدير المتغيرات
    nuclei: command not foundلم يتم تثبيت nucleiثبته عبر go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
    خطأ في الاتصال بالهدفالهدف غير متاح أو محظوراستخدم هدفاً تجريبياً مثل testphp.vulnweb.com

    استخدامات عملية في السوق السعودي

    مثال: فحص تطبيق حكومي تجريبي (بإذن مسبق) لاكتشاف ثغرات XSS و SQL injection. يمكن استخدام Guardian CLI لأتمتة الفحص الأولي، ثم مراجعة النتائج يدوياً. هذا يوفر 80% من الوقت مقارنة بالفحص اليدوي.

    مثال آخر: شركة ناشئة تريد فحص تطبيقها قبل الإطلاق. بدلاً من دفع آلاف الريالات لشركة أمن، يمكن للفريق الداخلي استخدام Guardian CLI كأداة فحص أولي.

    هل يستحق التجربة؟ تقييم موضوعي

    الإيجابيات: مجاني، مفتوح المصدر، أتمتة ذكية، تقارير منظمة.

    السلبيات: يعتمد على API خارجي (قد يكون بطيئاً)، يحتاج تثبيت أدوات مساعدة متعددة، ليس بديلاً كاملاً عن الخبير البشري.

    التقييم: 8/10 – أداة ممتازة للأتمتة، لكنها تتطلب خبرة أساسية في الأمن.

    بدائل مشابهة (مقارنة سريعة)

    الأداةالمميزاتالعيوب
    Guardian CLIمجاني، يدعم عدة APIs، تقارير منظمةيحتاج تثبيت أدوات مساعدة
    Metasploitقاعدة بيانات ثغرات ضخمة، واجهة رسوميةتجاري، معقد للمبتدئين
    OpenVASمجاني، شاملبطيء، واجهة قديمة
    BurpSuite Proاحترافي، إضافات كثيرةباهظ الثمن (~$399/سنة)

    أسئلة شائعة

    هل Guardian CLI مجاني بالكامل؟

    نعم، الأداة مفتوحة المصدر ومجانية. لكن استخدام Gemini API قد يكون له حد مجاني (60 طلباً في الدقيقة).

    ما الفرق بين Guardian CLI وأدوات مثل Metasploit؟

    Metasploit يركز على استغلال الثغرات، بينما Guardian يركز على أتمتة سير العمل بالكامل من جمع المعلومات إلى التقرير.

    هل أحتاج إلى معرفة متقدمة في الأمن لاستخدامه؟

    تحتاج إلى فهم أساسي للثغرات وأدوات CLI. الأداة تساعد في الأتمتة، لكنها لا تعلمك الأمن من الصفر.

    ما هي مخاطر استخدام الأداة بشكل غير قانوني؟

    استخدام الأداة على أهداف دون إذن قانوني يعتبر جريمة. استخدمها فقط على أهدافك أو بإذن كتابي.

    هل يدعم Guardian CLI اللغة العربية؟

    لا، الواجهة والتقارير باللغة الإنجليزية حالياً.

    كيف أحدث الأداة إلى الإصدار الأحدث؟

    افتح المجلد ونفذ git pull ثم pip install -e . مرة أخرى.

    الخطوات التالية

    بعد تجربة Guardian CLI، يمكنك:

    • استكشاف خيارات إضافية مثل --provider openai أو --output-dir
    • دمج الأداة مع سير عمل CI/CD لفحص التطبيقات تلقائياً
    • المساهمة في المشروع على GitHub (تحسين التوثيق، إضافة أدوات)
    DO

    Playbook التطبيق

    خطوات عملية مرتبة من التشخيص إلى النتيجة

    خطوة 1

    تثبيت Python والتبعيات

    لماذا؟ Guardian CLI يعمل على Python 3.11+ ويحتاج pip و git.

    كيف؟ sudo apt update && sudo apt install python3 python3-pip git -y

    الناتج: تثبيت Python و pip و git بنجاح.

    خطوة 2

    استنساخ المستودع

    لماذا؟ تحميل كود المصدر من GitHub.

    كيف؟ git clone https://github.com/zakirkun/guardian-cli.git && cd guardian-cli

    الناتج: مجلد guardian-cli يحتوي على الكود.

    خطوة 3

    تثبيت الحزمة

    لماذا؟ تثبيت Guardian CLI كحزمة Python.

    كيف؟ pip install -e .

    الناتج: الأمر guardian متاح في الطرفية.

    خطوة 4

    تثبيت الأدوات المساعدة

    لماذا؟ الأداة تحتاج nuclei, httpx, subfinder, sqlmap وغيرها.

    كيف؟ استخدم السكربت الآلي في القوالب أو ثبّت يدوياً: go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest

    الناتج: جميع الأدوات المساعدة مثبتة.

    خطوة 5

    إعداد ملف .env

    لماذا؟ لتخزين مفاتيح API بأمان.

    كيف؟ أنشئ ملف .env بالمحتوى: GOOGLE_API_KEY=your-key-here، ثم نفّذ export $(grep -v '^#' .env | xargs)

    الناتج: المتغيرات البيئية محملة.

    خطوة 6

    تشغيل أول فحص

    لماذا؟ اختبار الأداة على هدف تجريبي.

    كيف؟ guardian --target testphp.vulnweb.com --provider gemini

    الناتج: تقرير فحص يحتوي على الثغرات المكتشفة.

    TMP

    قوالب جاهزة للنسخ

    حوّل القراءة إلى تنفيذ سريع

    ملف .env
    # Guardian CLI Configuration
    GOOGLE_API_KEY=your-gemini-api-key-here
    # OPENAI_API_KEY=sk-your-key-here
    # ANTHROPIC_API_KEY=sk-ant-your-key-here
    # OPENROUTER_API_KEY=your-key-here
    سكربت تثبيت الأدوات المساعدة
    #!/bin/bash
    go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
    go install github.com/projectdiscovery/httpx/cmd/httpx@latest
    go install github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
    pip install sqlmap
    ERR

    مصفوفة الأخطاء

    اعرف أين يتعثر الناس وكيف تتجنب ذلك

    الخطألماذا يحدث؟التصحيح
    ModuleNotFoundError: No module named 'guardian'لم يتم تثبيت الحزمة بشكل صحيح.تأكد من تنفيذ pip install -e . داخل المجلد guardian-cli.
    Error: GOOGLE_API_KEY not setلم يتم تعيين مفتاح Gemini.تحقق من ملف .env وقم بتصدير المتغيرات: export $(grep -v '^#' .env | xargs)
    nuclei: command not foundلم يتم تثبيت nuclei.ثبته عبر go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
    خطأ في الاتصال بالهدفالهدف غير متاح أو محظور.استخدم هدفاً تجريبياً مثل testphp.vulnweb.com.
    IF

    شجرة القرار

    ماذا تفعل حسب حالتك؟

    إذا: إذا كنت مبتدئاً تماماً في الأمن

    إذن: إذن لا تستخدم Guardian CLI حتى تتعلم أساسيات الثغرات وأدوات CLI.

    إذا: إذا كان لديك ميزانية لشراء أدوات تجارية

    إذن: إذن قد تفضل BurpSuite Pro أو Metasploit بدلاً من Guardian CLI.

    إذا: إذا كنت مختبر اختراق مستقل وتريد أتمتة المهام المتكررة

    إذن: إذن Guardian CLI مناسب لك، اتبع خطوات التثبيت.

    إذا: إذا واجهت خطأ في التثبيت

    إذن: إذن راجع جدول الأخطاء الشائعة أو ابحث في GitHub Issues.

    7D

    خطة تطبيق 7 أيام

    جدول صغير يمنع التسويف

    1. اليوم 1: تثبيت Python و Go و Git.
    2. اليوم 2: استنساخ المستودع وتثبيت الحزمة.
    3. اليوم 3: تثبيت الأدوات المساعدة (nuclei, httpx, subfinder, sqlmap).
    4. اليوم 4: الحصول على مفتاح Gemini وإعداد ملف .env.
    5. اليوم 5: تشغيل الفحص على testphp.vulnweb.com.
    6. اليوم 6: تحليل التقرير وتجربة خيارات إضافية (--provider openai).
    7. اليوم 7: دمج الأداة مع CI/CD أو المساهمة في المشروع.
    FACT

    حقائق سريعة تحفظها

    نقاط مختصرة ترجع لها لاحقاً

    1. Guardian CLI مجاني ومفتوح المصدر (رخصة MIT).

    2. يدعم مزودي ذكاء اصطناعي متعددين: Gemini, GPT-4, Claude, OpenRouter.

    3. يتطلب Python 3.11+ و Go لتثبيت الأدوات المساعدة.

    4. يستخدم أدوات مفتوحة المصدر مثل nuclei و sqlmap.

    5. ينشئ تقريراً منظمًا مع لقطات شاشة وسجلات.

    6. يمكن تشغيله على Linux و macOS (Windows عبر WSL).

    7. الحد المجاني لـ Gemini API هو 60 طلبًا في الدقيقة.

    8. الأداة لا تدعم اللغة العربية حاليًا.

    9. تستغرق عملية الفحص 10-15 دقيقة حسب حجم الهدف.

    FAQ

    أسئلة شائعة

    إجابات مباشرة على ما يبحث عنه الزائر

    هل Guardian CLI مجاني بالكامل؟

    نعم، الأداة مفتوحة المصدر ومجانية. لكن استخدام Gemini API قد يكون له حد مجاني (60 طلباً في الدقيقة).

    ما الفرق بين Guardian CLI وأدوات مثل Metasploit؟

    Metasploit يركز على استغلال الثغرات، بينما Guardian يركز على أتمتة سير العمل بالكامل من جمع المعلومات إلى التقرير.

    هل أحتاج إلى معرفة متقدمة في الأمن لاستخدامه؟

    تحتاج إلى فهم أساسي للثغرات وأدوات CLI. الأداة تساعد في الأتمتة، لكنها لا تعلمك الأمن من الصفر.

    ما هي مخاطر استخدام الأداة بشكل غير قانوني؟

    استخدام الأداة على أهداف دون إذن قانوني يعتبر جريمة. استخدمها فقط على أهدافك أو بإذن كتابي.

    هل يدعم Guardian CLI اللغة العربية؟

    لا، الواجهة والتقارير باللغة الإنجليزية حالياً.

    كيف أحدث الأداة إلى الإصدار الأحدث؟

    افتح المجلد ونفذ git pull ثم pip install -e . مرة أخرى.

    ABC

    مصطلحات سريعة

    تعريفات مختصرة تمنع الالتباس

    Guardian CLI

    إطار عمل مفتوح المصدر لأتمتة اختبار الاختراق باستخدام الذكاء الاصطناعي.

    Gemini

    نموذج ذكاء اصطناعي من Google يستخدم لتحليل الأوامر وتنسيق الأدوات.

    LangChain

    إطار عمل لبناء تطبيقات تعتمد على نماذج اللغة.

    nuclei

    أداة مفتوحة المصدر لفحص الثغرات بناءً على قوالب.

    sqlmap

    أداة لاكتشاف واستغلال ثغرات حقن SQL.

    subfinder

    أداة لجمع النطاقات الفرعية.

    httpx

    أداة لفحص الخدمات HTTP.

    Q+

    أسئلة مرتبطة يبحث عنها الناس

    استخدمها كمسارات متابعة داخل نفس الموضوع

    كيفية تثبيت Guardian CLI على Ubuntuأفضل أدوات اختبار الاختراق مفتوحة المصدر 2024مقارنة بين Guardian CLI و Metasploitاستخدام Google Gemini في الأمن السيبرانيأتمتة اختبار الاختراق بالذكاء الاصطناعيدليل LangChain للمبتدئينأدوات فحص الثغرات المجانية للسعودية

    لماذا هذا المرجع يتجاوز الموضوع نفسه؟

    تحول القارئ: من مطور يبحث عن أداة أتمتة إلى مستخدم قادر على تشغيل وكيل اختبار اختراق آلي بنفسه

    • يمكن دمج Guardian CLI مع أدوات CI/CD مثل GitHub Actions لفحص تلقائي
    • مشابه لـ CrewAI في تنسيق وكلاء متعددين، لكن متخصص في الأمن
    • يمكن استخدامه مع PilotDeck لإدارة وكلاء AI متعددين
    SAVE

    كيف تستخدم هذا المرجع لاحقاً؟

    القيمة الحقيقية تظهر عند العودة والتطبيق

    لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.

    مع Guardian CLI، أصبح بإمكانك بناء وكيل اختبار اختراق آلي بالذكاء الاصطناعي دون الحاجة إلى ميزانية ضخمة. اتبع الخطوات في هذا الدليل، واستخدم القوالب المرفقة، وستكون جاهزاً لتشغيل أول فحص خلال 20 دقيقة. تذكر دائماً الالتزام بالأخلاقيات القانونية، واستخدم الأداة لتطوير مهاراتك وحماية تطبيقاتك.

    الآن، حان دورك: افتح الطرفية وابدأ التجربة. إذا واجهت أي مشكلة، راجع جدول الأخطاء الشائعة أو اترك تعليقاً. ولا تنسَ مشاركة هذا الدليل مع زملائك المهتمين بالأمن السيبراني.

    UPD

    خطة تحديث هذا الدليل

    حتى يبقى المرجع صالحاً مع الوقت

    • تحقق من تحديثات GitHub كل شهر (git pull).
    • تحديث قوالب الثغرات في nuclei أسبوعياً (nuclei -update-templates).
    • مراجعة إصدارات الأدوات المساعدة شهرياً.
    • تحديث ملف .env إذا تغيرت مفاتيح API.
    • متابعة إصدارات Python والتأكد من التوافق.

    زارو — مكتبة الأدلة العملية

    نحو مكتبة أدلة عملية: تشخيص، تنفيذ، قياس، وتحديث مستمر.

    Evergreen Reference + GitHub Intelligence + Multi-Stage AI OS v8.0.0-EVERGREEN-GITHUB-AI-INTELLIGENCE-OS

    [Object]
    كاتب في Ficus Web | تقرير إخباري وقصة قصيرة

    مقالات ذات صلة

    اقتراحات مبنية على أول تصنيف مرتبط بالمقال الحالي

    التعليقات (0)

    لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇