]( | **Тёмный режим**
** предоставляет режимы согласования, списки разрешённых инструментов, проверку аудит-агентом и отслеживаемые решения.
* 🔐 **Платформенный RBAC** поддерживает несколько пользователей, системные и пользовательские роли, разрешения с областью действия, владение и явные назначения.
* 🔒 **Безопасность и аудит** обеспечивают аутентифицированный доступ, журналы аудита, хранение в SQLite и сохранение операционных доказательств.
* 📄 **Управление результатами** сохраняет тот же ограниченный по объёму результат инструмента, который видел агент, защищает пути возобновления от чрезмерно большого исторического вывода и добавляет защитные механизмы интерфейса для больших представлений деталей. См. Управление исполнением инструментов.
* 📁 **Управление диалогами** предоставляет группировку, закрепление, переименование и пакетную организацию.
* 📂 **Проекты и цепочки атак** связывают факты между сеансами, скоринг рисков, графовые представления и пошаговое воспроизведение.
* 🗂️ **Управление активами** нормализует и дедуплицирует домены, IP-адреса, порты и сервисы; поддерживает импорт и экспорт XLSX/CSV, расширенные фильтры и сохранённые представления, владение и бизнес-метаданные, массовые операции на нескольких страницах и объединение дубликатов; а также отслеживает охват сканированием, связанные уязвимости и состояние риска. См. Руководство по управлению активами.
* 🛡️ **Управление уязвимостями** предоставляет классификацию по критичности, отслеживание жизненного цикла, фильтрацию и статистику.
* 📋 **Пакетные задачи** обеспечивают выполнение в очереди, редактирование, отслеживание статуса и сохранение результатов.
* 📱 **Чат-боты** подключают Personal WeChat, WeCom, DingTalk, Lark, Telegram, Slack, Discord и QQ Bot.
* 🐚 **Управление WebShell** предоставляет управление подключениями, виртуальный терминал, файловые операции и рабочие процессы с поддержкой ИИ.
* 📡 **Встроенный C2** предоставляет слушатели, зашифрованные биконы, сеансы, очереди задач, помощники для создания payload и события в реальном времени.
> WebShell, C2 и другие высокорисковые возможности предназначены для систем, которыми вы владеете или на тестирование которых у вас есть явное разрешение. См. модель безопасности и руководство по усилению безопасности.
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/` → «Загрузить распакованное расширение» → 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+ подобранными инструментами, охватывающими всю цепочку атаки (kill chain):
**Просмотреть полный список категорий инструментов**
* **Сканеры сети** – 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
Описания инструментов, настройка и примечания по использованию приведены в tools/README_EN.md.
### Быстрый старт (развёртывание одной командой)
* Go 1.25+ (Установить; требуется `go.mod`)
**Развёртывание одной командой:** ```bash git clone cd CyberStrikeAI chmod +x run.sh && ./run.sh
- ✅ Проверит и валидирует окружения Go и Python
1. Убедитесь, что в терминале отображается `● ONLINE` и фактический URL веб-интерфейса.
2. Откройте этот URL; в режиме HTTPS по умолчанию используется локальный самоподписанный сертификат, поэтому один раз примите предупреждение браузера.
3. При новой установке сохраните одноразовый пароль `admin`, показанный под `ADMIN SETUP REQUIRED`, войдите в систему и немедленно смените его.
**Сетевые параметры по умолчанию:** `run.sh` запускает сервер с **`--https`** и **`config.yaml`** из репозитория (локальный самоподписанный TLS; лучше для многих одновременных потоков). Для обычного HTTP используйте **`./run.sh --http`**. В продакшене укажите **`server.tls_cert_path`** / **`server.tls_key_path`** в **`config.yaml`** (см. комментарии там). Для ручного запуска добавьте **`--https`** или **`CYBERSTRIKE_HTTPS=1`**; если **`-config`** указан неверно, бинарный файл выводит краткую подсказку по использованию в stderr.
1. **Настройка AI-каналов** (обязательно перед первым использованием)
- После запуска откройте **` (или **` замените **8080** на `server.port` в `config.yaml`) и один раз примите предупреждение о самоподписанном сертификате. Если вы использовали `./run.sh --http`, используйте **` вместо этого.
- Перейдите в `System Settings` → `Basic Settings` → `AI Channel Configuration`, добавьте или отредактируйте канал, затем заполните провайдера, Base URL, API-ключ, модель и лимиты токенов. Нажмите **Save changes**. Левый список каналов поддерживает назначение канала по умолчанию, копирование, удаление и массовую проверку.
base_url: " # or
model: "gpt-4o" # or deepseek-chat, qwen3-max, etc.
- Или отредактируйте `config.yaml` напрямую перед запуском. `ai.default_channel` используется для новых бесед и задач, которые явно не выбирают канал; на странице чата также можно выбрать любой сохранённый канал для каждого сеанса.
2. **Login** - При первом запуске консоль выводит автоматически сгенерированный начальный пароль `admin`; создавайте учётные записи через **Platform permissions → User management**
3. **Установка инструментов безопасности (необязательно)** - Устанавливайте инструменты из `tools/` по мере необходимости; отсутствующие инструменты пропускаются или заменяются во время выполнения. Распространённые примеры:
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 build -o cyberstrike-ai cmd/server/main.go
Если в журналах сервера указано `client sent an HTTP request to an HTTPS server`, клиент всё ещё использует **` на порту только с TLS — смените URL на **`
**Примечание:** Виртуальное окружение Python (`venv/`) автоматически создаётся и управляется с помощью `run.sh`. Инструменты, требующие Python (например, `api-fuzzer`, `http-framework-test` и т. п.), автоматически используют это окружение.
**Однокликовое обновление CyberStrikeAI:**
1. (При первом использовании) сделайте скрипт исполняемым: `chmod +x upgrade.sh`
2. Обновите с помощью: `./upgrade.sh` (необязательные флаги: `--tag vX.Y.Z`, `--no-venv`, `--yes`). Локальные `tools/`, `roles/` и `skills/` всегда сохраняются.
3. Скрипт создаст резервную копию ваших `config.yaml` и `data/`, обновит код из GitHub Release, обновит `version` в `config.yaml`, а затем перезапустит сервер.
Рекомендуемая однострочная команда: `chmod +x upgrade.sh && ./upgrade.sh --yes`
Если что-то пошло не так, вы можете восстановиться из `.upgrade-backup/` (или вручную скопировать обратно `/data` и `config.yaml`) и снова запустить `./run.sh`.
* Вам понадобятся `curl` или `wget` для загрузки пакетов Release.
* Для безопасной синхронизации кода рекомендуется/требуется `rsync`.
* Если GitHub API ограничивает ваш лимит запросов, установите `export GITHUB_TOKEN="..."` перед запуском `./upgrade.sh`.
⚠️ **Перед обновлением:** ознакомьтесь с примечаниями к целевой версии на предмет изменений конфигурации, базы данных и API. Резервные копии обязательны даже для патч-обновлений; один лишь номер версии не гарантирует совместимости.
Используйте `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: " model: "your-model"
`openai` — это поле времени выполнения с обратной совместимостью; новые параметры моделей задавайте в `ai.channels`. Не коммитьте реальные учётные данные. Перед тем как открывать доступ к сервису за пределами localhost, ознакомьтесь с [справочником по конфигурации]( [рекомендованными профилями]( и [руководством по усилению безопасности](
- **Новые пользователи:** [Развёртывание]( → [Конфигурация]( → [Устранение неполадок](
- **Операторы:** [Профили конфигурации]( → [Усиление безопасности]( → [Runbooks](
- **Интеграторы:** [Справочник по API]( → [Рецепты API]( → [MCP-федерация](
- **Контрибьюторы:** [Руководство разработчика]( → [Тестирование]( → [Внесение вклада](
- **Все темы:** [Документация на английском]( · [Двуязычный указатель документации](
├── 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
├── scripts/ # Repository maintenance checks, including documentation validation
├── config.yaml # Runtime configuration
├── run.sh # Convenience launcher
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 is vulnerable to SQL injection Scan 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.
