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 и поддерживают прогрессивную загрузку по требованию.
- 📚 **База знаний** объединяет переписывание запросов, векторный поиск, переранжирование и постобработку результатов.
- 🖼️ **Анализ изображений** использует отдельную модель зрения для скриншотов, капч и UI, сохраняя только текстовые сводки.
### Управление и аудит
- 🧑⚖️ **Человек в цикле** обеспечивает режимы согласования, списки разрешённых инструментов, проверку агентом аудита и прослеживаемые решения.
- 🛡️ **Блокировка вызовов** в разделе «Безопасность» добавляет настраиваемые проверки по регулярным выражениям перед исполнением MCP, шаблоны напоминаний и пробные запуски, при этом защита государственных доменов включена по умолчанию. См. [Блокировка вызовов инструментов](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-call-guard.md).
- 🔐 **RBAC платформы** поддерживает нескольких пользователей, системные и пользовательские роли, ограниченные области прав, владение и явные назначения.
- 🔒 **Безопасность и аудит** обеспечивают аутентифицированный доступ, журналы аудита, хранение в SQLite и сохранение операционных доказательств.
- 📄 **Управление результатами** сохраняет тот же ограниченный результат инструмента, который видит агент, защищает пути возобновления от чрезмерно больших исторических выводов и добавляет защитные меры в UI для больших представлений деталей. См. [Управление исполнением инструментов](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).
- 🛡️ **Управление уязвимостями** обеспечивает классификацию по серьёзности, отслеживание жизненного цикла, фильтрацию и статистику.
- 📋 **Пакетные задачи** обеспечивают постановку в очередь на исполнение, редактирование, отслеживание статуса и сохранение результатов.
- 📱 **Чат-боты** подключают Personal 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. **Настройте AI-каналы** (обязательно перед первым использованием)
- После запуска откройте **`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`, добавьте или отредактируйте канал, затем заполните провайдера, Base 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
```
**Linux (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`): оно подтягивает новейший коммит
ветки по умолчанию **репозитория-источника обновлений** (по умолчанию — официальный репозиторий; одна настройка указывает
на ваш собственный форк или зеркало), выполняет fast-forward, пересобирает и атомарно подменяет бинарник, сохраняет
`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 Release и
синхронизировать его через rsync», где репозиторий-источник берётся из `--repo owner/name` или `GITHUB_REPO`, а
встроенное значение по умолчанию применяется только когда не задано ни то, ни другое (с предупреждением с именем репозитория).
Источник обновлений — это одна настройка, адрес репозитория в секции `update` файла `config.yaml` или
прямо на странице консоли — официальный репозиторий, ваш собственный форк или чей-то ещё форк. Установку,
распакованную из архива 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` (возврат к
коммиту и бинарнику, сохранённым перед этим обновлением); для 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) в качестве авторитетного шаблона конфигурации и скопируйте только те значения, которые требуются для вашей среды. Как минимум настройте сервер и один канал ИИ:
```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) → [Runbooks](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
```
---
[Read more](https://github.com/ed1s0nz/cyberstrikeai)