ed1s0nz/cyberstrikeaiنظام العمل للأمن السيبراني الأصلي بالذكاء الاصطناعي — حيث تتحول النية إلى تنفيذ محكوم، وتصبح الأدلة ذاكرة تشغيلية، وكل عملية تحسن التي تليها.
<div align="center">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/logo.png" alt="CyberStrikeAI Logo" width="200" >
</div>
# CyberStrikeAI
[中文](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README_CN.md) | [English](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README.md)
**نظام العمل للأمن السيبراني الأصيل بالذكاء الاصطناعي—حيث تتحول النية إلى تنفيذ محكوم، ويصبح الدليل ذاكرة تشغيلية، وكل عملية تحسّن العملية التالية.**
يربط CyberStrikeAI التخطيط والتنفيذ والإشراف البشري والأدلة وإعادة التشغيل في مساحة عمل واحدة قابلة للتدقيق. مبني بلغة Go، يجمع بين وكلاء مدعومين بـ Eino، وأدوات أصلية لـ MCP، ومعرفة RAG، وسير عمل مرئي، ونمذجة وتحليل سلسلة الهجوم لعمليات الأمن المصرح بها.
**ابدأ من هنا:** [البدء السريع](#quick-start-one-command-deployment) · [التوثيق](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [تقوية الأمان](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)
> [!IMPORTANT]
> استخدم CyberStrikeAI فقط على الأنظمة التي تملكها أو لديك تصريح صريح باختبارها. بالنسبة للبيئات المشتركة أو الإنتاجية، راجع [نموذج الأمان](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) و[دليل التقوية](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) قبل تمكين الأدوات عالية المخاطر أو WebShell أو قدرات C2.
## معاينة الواجهة والتكامل
<div align="center">
### نظرة عامة على لوحة تحكم النظام
<table>
<tr>
<td width="50%" align="center">
<strong>الوضع الفاتح</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dashboard.png" alt="System Dashboard (Light)" width="100%">
</td>
<td width="50%" align="center">
<strong>الوضع الداكن</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dark.png" alt="System Dashboard (Dark)" width="100%">
</td>
</tr>
</table>
*توفر لوحة التحكم نظرة شاملة على حالة تشغيل النظام، والثغرات الأمنية، واستخدام الأدوات، وقاعدة المعرفة، مما يساعد المستخدمين على فهم الميزات الأساسية للمنصة وحالتها الحالية بسرعة.*
<details>
<summary><strong>المزيد من لقطات الواجهة</strong></summary>
### نظرة عامة على الميزات الأساسية
<table>
<tr>
<td width="33.33%" align="center">
<strong>وحدة التحكم عبر الويب</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/web-console.png" alt="Web Console" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إدارة المهام</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/task-management.png" alt="Task Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إدارة الثغرات</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/vulnerability-management.png" alt="Vulnerability Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>إدارة WebShell</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/webshell-management.png" alt="WebShell Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إدارة MCP</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-management.png" alt="MCP management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>قاعدة المعرفة</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/knowledge-base.png" alt="Knowledge Base" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>إدارة المهارات</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/skills.png" alt="Skills Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إدارة الوكلاء</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/agent-management.png" alt="Agent Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إدارة الأدوار</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/role-management.png" alt="Role Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>إعدادات النظام</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/settings.png" alt="System settings" width="100%">
</td>
<td width="33.33%" align="center">
<strong>وضع MCP stdio</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-stdio2.png" alt="MCP stdio mode" width="100%">
</td>
<td width="33.33%" align="center">
<strong>إضافة Burp Suite</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/plugins.png" alt="Burp Suite plugin" width="100%">
</td>
</tr>
</table>
</details>
</div>
## أبرز الميزات
### الوكلاء والتنسيق
- 🤖 **التنفيذ الوكيلي** يحوّل النية باللغة الطبيعية إلى إجراءات أمنية محكومة وقابلة للتدقيق.
- 🧩 **تنسيق Eino** يدعم تنفيذ وكيل واحد بالإضافة إلى أوضاع الوكلاء المتعددين Deep وPlan-Execute وSupervisor.
- 🔀 **سير العمل الرسومي** يجمع الوكلاء والأدوات والشروط والموافقات والمخرجات في تدفقات قابلة لإعادة الاستخدام.
- 🎭 **الاختبار القائم على الأدوار** يوفر مطالبات مركزة وسياسات أدوات لسيناريوهات الأمان الشائعة.
### الأدوات والمعرفة
- 🧰 **الأدوات الأمنية** تشمل أكثر من 100 وصفة YAML منسقة مع امتدادات مخصصة ووصول محدد بالأدوار.
- 🔌 **تكامل MCP** يدعم HTTP وstdio وSSE والاتحاد الخارجي واكتشاف الأدوات الديناميكي.
- ⏱️ **تنفيذ أدوات مرن** يشغّل استدعاءات MCP/الأدوات الحاجبة في عمال مع انتظار محدود للوكيل، واستطلاع `execution_id` القابل للاستئناف، والإلغاء، وقواطع الدائرة لكل خادم، وحدود التزامن، وحدود مخرجات موحدة.
- 🎯 **مهارات الوكيل** تتبع تخطيط Skill القياسي وتدعم التحميل التدريجي عند الطلب.
- 📚 **قاعدة المعرفة** تجمع إعادة صياغة الاستعلام والاسترجاع المتجهي وإعادة الترتيب والمعالجة اللاحقة للنتائج.
- 🖼️ **تحليل الرؤية** يستخدم نموذج رؤية منفصل لقطات الشاشة والكابتشا وواجهة المستخدم مع الاحتفاظ بالملخصات النصية فقط.
### الحوكمة والتدقيق
- 🧑⚖️ **الإنسان في الحلقة** يوفر أوضاع الموافقة وقوائم الأدوات المسموح بها ومراجعة وكيل التدقيق والقرارات القابلة للتتبع.
- 🛡️ **حظر الاستدعاء** ضمن الأمان يضيف فحوصات regex قابلة للتكوين قبل تنفيذ MCP، وقوالب تذكير، وتشغيلات تجريبية، مع تمكين حماية النطاق الحكومي افتراضيًا. راجع [حظر استدعاء الأدوات](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-call-guard.md).
- 🔐 **RBAC للمنصة** يدعم مستخدمين متعددين وأدوار نظام وأدوار مخصصة وأذونات محددة النطاق والملكية والتعيينات الصريحة.
- 🔒 **الأمان والتدقيق** يوفر وصولًا موثقًا وسجلات تدقيق واستمرارية SQLite والاحتفاظ بالأدلة التشغيلية.
- 📄 **حوكمة النتائج** تخزن نفس نتيجة الأداة المحدودة التي يراها الوكيل، وتحمي مسارات الاستئناف من المخرجات التاريخية الضخمة، وتضيف ضمانات واجهة المستخدم لعروض التفاصيل الكبيرة. راجع [حوكمة تنفيذ الأدوات](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-execution-governance.md).
### العمليات الأمنية
- 📁 **إدارة المحادثات** توفر التثبيت وإعادة التسمية والتنظيم الدفعي.
- 📂 **المشاريع وسلاسل الهجوم** تربط الحقائق عبر الجلسات وتسجيل المخاطر وعروض الرسم البياني وإعادة التشغيل خطوة بخطوة.
- 🗂️ **إدارة الأصول** توحّد وتزيل التكرار من النطاقات وعناوين IP والمنافذ والخدمات؛ وتدعم استيراد وتصدير XLSX/CSV والمرشحات المتقدمة والعروض المحفوظة والملكية والبيانات الوصفية للأعمال والصيانة الجماعية عبر الصفحات ودمج التكرارات؛ وتتتبع تغطية الفحص والثغرات المرتبطة وحالة المخاطر. راجع [دليل إدارة الأصول](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/asset-management.md).
- 🛡️ **إدارة الثغرات** توفر تصنيف الخطورة وتتبع دورة الحياة والتصفية والإحصاءات.
- 📋 **المهام الدفعية** توفر التنفيذ في قائمة الانتظار والتحرير وتتبع الحالة والنتائج المحتفظ بها.
- 📱 **روبوتات الدردشة** تربط WeChat الشخصي وWeCom وDingTalk وLark وTelegram وSlack وDiscord وQQ Bot.
### العمليات الأمنية المصرح بها
- 🐚 **إدارة WebShell** توفر إدارة الاتصال وطرفية افتراضية وعمليات الملفات وسير عمل مدعوم بالذكاء الاصطناعي.
- 📡 **C2 المدمج** يوفر المستمعين والمنارات المشفرة والجلسات وقوائم المهام ومساعدات الحمولات والأحداث المباشرة.
> WebShell وC2 والقدرات الأخرى عالية المخاطر مخصصة للأنظمة التي تملكها أو لديك تصريح صريح باختبارها. راجع [نموذج الأمان](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) و[دليل التقوية](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md).
## الإضافات
يتضمن CyberStrikeAI تكاملات اختيارية ضمن `plugins/`.
- **إضافة Burp Suite**: `plugins/burp-suite/cyberstrikeai-burp-extension/`
مخرجات البناء: `plugins/burp-suite/cyberstrikeai-burp-extension/dist/cyberstrikeai-burp-extension.jar`
التوثيق: `plugins/burp-suite/cyberstrikeai-burp-extension/README.md`
- **إضافة المتصفح (Chrome / Edge)**: `plugins/browser-extension/cyberstrikeai-browser-extension/`
التقط حركة مرور الشبكة في DevTools وأرسلها إلى CyberStrikeAI لاختبار أمني مدعوم بالذكاء الاصطناعي—بما يتوافق مع إضافة Burp.
التثبيت: `chrome://extensions/` → Load unpacked → F12 → تبويب **CyberStrikeAI**
مخرجات الحزمة: `plugins/browser-extension/cyberstrikeai-browser-extension/dist/cyberstrikeai-browser-extension.zip`
التوثيق: `plugins/browser-extension/cyberstrikeai-browser-extension/README.md` / `README.zh-CN.md`
## نظرة عامة على الأدوات
يأتي CyberStrikeAI مع أكثر من 100 أداة منسقة تغطي سلسلة القتل بأكملها:
<details>
<summary><strong>عرض فئات الأدوات الكاملة</strong></summary>
- **ماسحات الشبكة** – nmap, masscan, rustscan, arp-scan, nbtscan
- **ماسحات الويب والتطبيقات** – sqlmap, nikto, dirb, gobuster, feroxbuster, ffuf, httpx
- **ماسحات الثغرات** – nuclei, wpscan, wafw00f, dalfox, xsser
- **تعداد النطاقات الفرعية** – subfinder, amass, findomain, dnsenum, fierce
- **محركات البحث في الفضاء الشبكي** – fofa_search, zoomeye_search, quake_search, shodan_search
- **أمان API** – graphql-scanner, arjun, api-fuzzer, api-schema-analyzer
- **أمان الحاويات** – trivy, clair, docker-bench-security, kube-bench, kube-hunter
- **أمان السحابة** – prowler, scout-suite, cloudmapper, pacu, terrascan, checkov
- **تحليل الملفات الثنائية** – gdb, radare2, ghidra, objdump, strings, binwalk
- **الاستغلال** – metasploit, msfvenom, pwntools, ropper, ropgadget
- **كسر كلمات المرور** – hashcat, john, hashpump
- **التحليل الجنائي** – volatility, volatility3, foremost, steghide, exiftool
- **ما بعد الاستغلال** – linpeas, winpeas, mimikatz, bloodhound, impacket, responder
- **أدوات CTF** – stegsolve, zsteg, hash-identifier, fcrackzip, pdfcrack, cyberchef
- **مساعدات النظام** – exec, create-file, delete-file, list-files, modify-file
</details>
راجع [tools/README_EN.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/tools/README_EN.md) لتعريفات الأدوات والتخصيص وملاحظات الاستخدام.
## الاستخدام الأساسي
### البدء السريع (نشر بأمر واحد)
**المتطلبات الأساسية:**
- Go 1.25+ ([تثبيت](https://go.dev/dl/)؛ مطلوب بواسطة `go.mod`)
- Python 3.10+ ([تثبيت](https://www.python.org/downloads/))
**النشر بأمر واحد:**
```bash
git clone https://github.com/Ed1s0nZ/CyberStrikeAI.git
cd CyberStrikeAI
chmod +x run.sh && ./run.sh
```
يقوم سكربت `run.sh` تلقائيًا بما يلي:
- ✅ التحقق من بيئات Go وPython والتحقق من صحتها
- ✅ إنشاء بيئة Python افتراضية
- ✅ تثبيت تبعيات Python
- ✅ تنزيل تبعيات Go
- ✅ بناء المشروع
- ✅ تشغيل الخادم
**التحقق من بدء التشغيل:**
1. تأكد من أن الطرفية تعرض `● ONLINE` متبوعًا بعنوان URL الفعلي لواجهة الويب.
2. افتح عنوان URL هذا؛ يستخدم وضع HTTPS الافتراضي شهادة موقعة ذاتيًا محلية، لذا اقبل تحذير المتصفح مرة واحدة.
3. في التثبيت الجديد، احفظ كلمة مرور `admin` لمرة واحدة المعروضة تحت `ADMIN SETUP REQUIRED`، وسجّل الدخول، وغيّرها فورًا.
**إعدادات الشبكة الافتراضية:** يبدأ `run.sh` الخادم مع **`--https`** وملف **`config.yaml`** الخاص بالمستودع (TLS محلي موقّع ذاتيًا؛ أفضل للعديد من التدفقات المتزامنة). استخدم **`./run.sh --http`** لـ HTTP العادي. في بيئة الإنتاج، اضبط **`server.tls_cert_path`** / **`server.tls_key_path`** في **`config.yaml`** (انظر التعليقات هناك). للتشغيل اليدوي، أضف **`--https`** أو **`CYBERSTRIKE_HTTPS=1`**؛ إذا كان **`-config`** غير صحيح، يطبع الملف التنفيذي تلميحًا قصيرًا للاستخدام على stderr.
**الإعداد لأول مرة:**
1. **تكوين قنوات الذكاء الاصطناعي** (مطلوب قبل الاستخدام الأول)
- بعد التشغيل، افتح **`https://127.0.0.1:8080/`** (أو **`https://localhost:8080/`**؛ استبدل **8080** بـ `server.port` في `config.yaml`) واقبل تحذير الشهادة الموقعة ذاتيًا مرة واحدة. إذا استخدمت `./run.sh --http`، فاستخدم **`http://`** بدلاً من ذلك.
- انتقل إلى `System Settings` → `Basic Settings` → `AI Channel Configuration`، وأضف قناة أو حرّرها، ثم املأ المزوّد، وعنوان URL الأساسي، ومفتاح API، والطراز، وحدود الرموز المميزة. انقر على **Save changes**. تدعم قائمة القنوات اليسرى تعيين قناة افتراضية، والنسخ، والحذف، والفحص الجماعي.
```yaml
ai:
default_channel: openai-main
channels:
openai-main:
name: OpenAI Main
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1" # or https://api.deepseek.com/v1
model: "gpt-4o" # or deepseek-chat, qwen3-max, etc.
max_total_tokens: 120000
max_completion_tokens: 16384
```
- أو حرّر `config.yaml` مباشرة قبل التشغيل. يُستخدم `ai.default_channel` للمحادثات والمهام الجديدة التي لا تحدد قناة صراحةً؛ كما يمكن لصفحة الدردشة تحديد أي قناة محفوظة لكل جلسة.
2. **تسجيل الدخول** - عند أول بدء تشغيل، تطبع وحدة التحكم كلمة مرور `admin` أولية مُنشأة تلقائيًا؛ أنشئ حسابات من **Platform permissions → User management**
3. **تثبيت أدوات الأمان (اختياري)** - ثبّت الأدوات من `tools/` حسب الحاجة؛ يتم تخطي الأدوات المفقودة أو استبدالها في وقت التشغيل. أمثلة شائعة:
**macOS (Homebrew):**
```bash
brew install nmap masscan sqlmap nikto gobuster ffuf hydra hashcat nuclei subfinder
```
**لينكس (Kali / Debian / Ubuntu):**
```bash
sudo apt update
sudo apt install -y nmap masscan sqlmap nikto gobuster hydra hashcat john binwalk
# On some distros, install ffuf/nuclei/subfinder via go install or upstream docs
```
راجع دليل `tools/` للحصول على القائمة الكاملة؛ ارجع إلى الوثائق الرسمية لكل أداة للحصول على تفاصيل التثبيت.
**طرق التشغيل البديلة:**
```bash
# Direct Go run (set up env yourself); add --https to match run.sh defaults
go run ./cmd/server --https
# Manual build
go build -o cyberstrike-ai ./cmd/server
./cyberstrike-ai --https
```
إذا أظهرت سجلات الخادم `client sent an HTTP request to an HTTPS server`، فهذا يعني أن أحد العملاء لا يزال يستخدم **`http://`** على منفذ TLS فقط—قم بتغيير عنوان URL إلى **`https://`**.
**ملاحظة:** يتم إنشاء البيئة الافتراضية لـ Python (`venv/`) وإدارتها تلقائيًا بواسطة `run.sh`. الأدوات التي تتطلب Python (مثل `api-fuzzer` و`http-framework-test` وغيرها) ستستخدم هذه البيئة تلقائيًا.
### الترقية والتوافق
**يُفضّل استخدام التحديث بضغطة واحدة الخاص بالمنصة** (إعدادات النظام في وحدة التحكم -> التحديث بضغطة واحدة، أو
`./cyberstrike-ai -update` / `-check-update` / `-update-rollback`): حيث يجلب أحدث commit من
الفرع الافتراضي لـ **مستودع مصدر التحديث** (المستودع الرسمي افتراضيًا؛ ويمكن لإعداد واحد توجيهه
إلى fork الخاص بك أو مرآة)، ويقوم بالتحديث السريع، وإعادة البناء وتبديل الملف التنفيذي بشكل ذرّي، ويحافظ
على `roles/skills/tools/agents/data/config.yaml` دون تغيير (تُسمّي النتيجة كل ملف تم الاحتفاظ به؛ فقط
حقل `version` في `config.yaml` تتم مزامنته مع الكود الجديد، بحيث تتطابق شارة العنوان معه)، ويرفض -
بدلًا من الكتابة فوق - عندما يكون المصدر معدّلًا محليًا أو يكون السجل المحلي قد تباعد.
راجع [دليل النشر](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md).
لا يزال `upgrade.sh` يعمل: عندما يكون هذا الدليل شجرة عمل git فإنه يكون غلافًا رفيعًا فوق الأمر
أعلاه؛ فقط التثبيت غير المعتمد على git (tarball) يتراجع إلى المسار القديم "تنزيل إصدار GitHub و
مزامنته بـ rsync"، حيث يأتي مستودع المصدر من `--repo owner/name` أو `GITHUB_REPO` و
ينطبق الافتراضي المدمج فقط عندما لا يُعطى أي منهما (مع تحذير يسمّي المستودع).
مصدر التحديث هو إعداد واحد، عنوان مستودع في قسم `update` من `config.yaml` أو
مباشرة على صفحة وحدة التحكم - المستودع الرسمي، أو fork الخاص بك، أو fork شخص آخر. التثبيت
المفكوك من أرشيف Release (بدون git) يمكن معاينته وربطه من نفس
الصفحة ويتم التحديث بضغطة واحدة من ذلك الحين فصاعدًا.
**سكربت ترقية CyberStrikeAI:**
1. (لأول مرة) تمكين السكربت: `chmod +x upgrade.sh`
2. الترقية باستخدام: `./upgrade.sh` (أعلام اختيارية: `--check`، `--tag vX.Y.Z`، `--repo owner/name`، `--no-venv`، `--yes`). يتم دائمًا الحفاظ على `tools/` و`roles/` و`skills/` و`agents/` المحلية.
3. سيقوم السكربت بعمل نسخة احتياطية من `config.yaml` و`data/`، وترقية الكود، وتحديث `version` في `config.yaml`، ثم إعادة تشغيل الخادم.
أمر واحد موصى به:
`chmod +x upgrade.sh && ./upgrade.sh --yes`
إذا حدث خطأ ما: داخل شجرة عمل git ما عليك سوى تشغيل `./cyberstrike-ai -update-rollback` (للعودة إلى
الـ commit والملف التنفيذي المحفوظين قبل ذلك التحديث)؛ أما بالنسبة لتثبيت tarball فاستعد من
`.upgrade-backup/` (أو انسخ `data/` و`config.yaml` يدويًا مرة أخرى) وشغّل `./run.sh` مجددًا.
المتطلبات / النصائح (مسار tarball فقط):
* تحتاج إلى `curl` أو `wget` لتنزيل حزم Release.
* يُوصى بـ `rsync` / وهو مطلوب لمزامنة الكود الآمنة.
* إذا قام GitHub API بتقييد معدلك، فاضبط `export GITHUB_TOKEN="..."` قبل تشغيل `./upgrade.sh`.
⚠️ **قبل الترقية:** راجع ملاحظات الإصدار المستهدف للتغييرات في التكوين وقاعدة البيانات وواجهة API. النسخ الاحتياطية مطلوبة حتى لترقيات التصحيحات؛ فرقم الإصدار وحده ليس ضمانًا للتوافق.
## التكوين
استخدم [`config.example.yaml`](https://github.com/ed1s0nz/cyberstrikeai/blob/main/config.example.yaml) كقالب التكوين المرجعي وانسخ فقط القيم المطلوبة لبيئتك. كحد أدنى، قم بتكوين الخادم وقناة AI واحدة:
```yaml
server:
host: "127.0.0.1"
port: 8080
ai:
default_channel: openai-main
channels:
openai-main:
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1"
model: "your-model"
```
`openai` هو حقل وقت تشغيل متوافق مع الإصدارات السابقة؛ احتفظ بإعدادات النماذج الجديدة في `ai.channels`. لا تُدرج بيانات اعتماد حقيقية في الالتزامات. راجع [مرجع الإعدادات](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md)، و[الملفات الشخصية الموصى بها](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md)، و[دليل تقوية الأمان](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) قبل كشف الخدمة خارج localhost.
## الوثائق ذات الصلة
- **المستخدمون الجدد:** [النشر](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md) → [الإعدادات](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md) → [استكشاف الأخطاء وإصلاحها](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/troubleshooting.md)
- **المشغّلون:** [ملفات تعريف الإعدادات](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) → [تقوية الأمان](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) → [أدلة التشغيل](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/runbooks.md)
- **المكاملون:** [مرجع API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-reference.md) → [وصفات API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-recipes.md) → [اتحاد MCP](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/mcp-federation.md)
- **المساهمون:** [دليل المطوّر](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/developer-guide.md) → [الاختبار](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/testing.md) → [المساهمة](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/contributing-guide.md)
- **جميع المواضيع:** [الوثائق الإنجليزية](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [فهرس الوثائق ثنائي اللغة](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/README.md)
## تخطيط المشروع
```
CyberStrikeAI/
├── cmd/ # Server, MCP stdio entrypoints, tooling
├── internal/ # Agent, MCP core, handlers, C2 (`internal/c2`), security executor
├── web/ # Static SPA + templates
├── tools/ # YAML tool recipes (100+ examples provided)
├── roles/ # Role configurations (12+ predefined security testing roles)
├── skills/ # Agent Skills dirs (SKILL.md + optional files; demo: cyberstrike-eino-demo)
├── agents/ # Multi-agent Markdown (orchestrator.md + sub-agent *.md)
├── docs/ # Topic docs (deployment, config, security, API, knowledge base, C2, WebShell, etc.)
├── images/ # Docs screenshots & diagrams
├── config.yaml # Runtime configuration
├── run.sh # Convenience launcher
└── README*.md
```
## أمثلة الاستخدام الأساسية
```
Scan open ports on 192.168.1.1
Perform a comprehensive port scan on 192.168.1.1 focusing on 80,443,22
Check if https://example.com/page?id=1 is vulnerable to SQL injection
Scan https://example.com for hidden directories and outdated software
Enumerate subdomains for example.com, then run nuclei against the results
```
## دفاتر اللعب المتقدمة
```
Load the recon-engagement template, run amass/subfinder, then brute-force dirs on every live host.
Use external Burp-based MCP server for authenticated traffic replay, then pass findings back for graphing.
Compress the 5 MB nuclei report, summarize critical CVEs, and attach the artifact to the conversation.
Build an attack chain for the latest engagement and export the node list with severity >= high.
```
## 404Starlink
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/404StarLinkLogo.png" width="30%">
انضم CyberStrikeAI إلى [404Starlink](https://github.com/knownsec/404StarLink)
## مشروع TCH Top-Ranked Intelligent Pentest
<div align="left">
<a href="https://zc.tencent.com/competition/competitionHackathon?code=cha004" target="_blank">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/tch.png" alt="TCH Top-Ranked Intelligent Pentest Project" width="30%">
</a>
</div>
---
## المجتمع والدعم
- انضم إلى المجتمع على [Discord](https://discord.gg/8PjVCMu8Zw).
<details>
<summary><strong>مجموعة WeCom</strong></summary>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/main/images/wecom-group-cyberstrikeai-qr.png" alt="CyberStrikeAI WeCom group QR code" width="280">
</details>
## الترخيص
CyberStrikeAI مرخّص بموجب Apache License 2.0.
راجع ملف [LICENSE](https://github.com/ed1s0nz/cyberstrikeai/blob/main/LICENSE) للتفاصيل.
---
## ⚠️ إخلاء المسؤولية
**هذه الأداة مخصصة للأغراض التعليمية والاختبار المصرّح به فقط!**
CyberStrikeAI هي منصة احترافية لاختبار الأمان مصممة لمساعدة باحثي الأمان واختباري الاختراق ومتخصصي تقنية المعلومات في إجراء تقييمات الأمان وأبحاث الثغرات **بترخيص صريح**.
**باستخدامك هذه الأداة، فإنك توافق على:**
- استخدام هذه الأداة فقط على الأنظمة التي لديك ترخيص كتابي واضح للعمل عليها
- الالتزام بجميع القوانين واللوائح والمعايير الأخلاقية المعمول بها
- تحمّل المسؤولية الكاملة عن أي استخدام غير مصرّح به أو إساءة استخدام
- عدم استخدام هذه الأداة لأي أغراض غير قانونية أو ضارة
**المطوّرون غير مسؤولين عن أي إساءة استخدام!** يرجى التأكد من أن استخدامك يتوافق مع القوانين واللوائح المحلية، وأنك حصلت على ترخيص صريح من مالك النظام المستهدف.
للاطلاع على إرشادات الإبلاغ عن الثغرات وتقوية النشر، راجع [SECURITY.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/SECURITY.md).
---
هل تحتاج إلى مساعدة أو ترغب في المساهمة؟ افتح issue أو PR — إضافات أدوات المجتمع مرحّب بها!