Dark-Moon v1.3.1

Что такое DarkMoon?

DarkMoon — это автоматизированный инструмент для тестирования на проникновение, который организует полные оценки безопасности с помощью агентов безопасности на основе искусственного интеллекта. Будучи открытым инструментом кибербезопасности, он позволяет организациям проводить оценку уязвимостей профессионального уровня без ручного вмешательства.

Вместо того чтобы заменять пентестера, DarkMoon действует как автономная система тестирования безопасности — она рассуждает, планирует и координирует специализированных агентов, которые выполняют реальные операции наступательной безопасности через контролируемый уровень исполнения.

Посмотрите DarkMoon в действии — полная демонстрация автономного тестирования на проникновение

Почему DarkMoon?

Традиционное тестирование на проникновение:

• ⏱️ Трудоёмкое — ручное тестирование занимает недели
• 💰 Дорогое — услуги экспертов-консультантов стоят тысячи в день
• 🔄 Несогласованное — результаты зависят от квалификации тестировщика
• 📊 Сложно масштабировать — ограничено человеческими ресурсами

DarkMoon решает эти проблемы с помощью ИИ-тестирования на проникновение:

• 🤖 Пентест на базе ИИ — автономные агенты проводят полные оценки безопасности от начала до конца
• 🛡️ Безопасность как принцип проектирования — ИИ никогда не выполняет инструменты напрямую; все действия проходят через контролируемый интерфейс MCP
• 🕶️ Приватный шлюз (обратимая локальная токенизация) — ИИ никогда не видит ваши реальные чувствительные данные. IP-адреса, имена хостов, домены, URL-адреса, электронные письма, учётные данные и внутренние пути заменяются детерминированными плейсхолдерами (IP_PRIVATE_001, …); реальные значения подставляются локально, непосредственно перед запуском инструмента, и маскируются обратно во всех результатах. Никакие чувствительные данные никогда не покидают ваш периметр и не передаются LLM-провайдеру — используйте мощь Claude при строгих ограничениях суверенитета данных. Попытки эксфильтрации блокируются.
• ♾️ Автоматизация пентеста для CI/CD — запускайте автоматизированное тестирование безопасности после сборки, чтобы выявлять критические уязвимости до выхода в продакшен
• 🔧 Более 50 интегрированных инструментов — комплексный набор инструментов для тестирования на проникновение (Nuclei, NetExec, BloodHound, sqlmap, Naabu, httpx, ffuf и другие)
• 📈 Адаптивная мультиагентная методология — специализированные агенты для Web, Active Directory, Kubernetes, сети, CMS и не только
• 📝 Автоматизация отчётности об уязвимостях — структурированные отчёты с доказательствами генерируются автоматически

Идеально подходит для команд безопасности, DevSecOps-инженеров, специалистов по этичному хакингу и организаций любого размера.

Быстрый старт

Предварительные требования

• Docker и Docker Compose
• API-ключ LLM (OpenRouter, Anthropic, OpenAI или локальные модели)

Примечание: Настройка GPU, устранение неполадок с драйверами NVIDIA и расширенная настройка окружения описаны в Полной документации — Устранение неполадок с GPU.

Установка

1. Клонируйте репозиторий

git clone https://github.com/ASCIT31/Dark-Moon.git
cd Dark-Moon

2. Настройте вашего LLM-провайдера

install.sh интерактивно обрабатывает настройку провайдера — нет необходимости редактировать docker-compose.yml:

./install.sh           # skip form if .opencode.env already configured
./install.sh --init    # force reconfiguration (cloud or local model)
./install.sh --help    # show usage

Поддерживаются облачные провайдеры (Anthropic, OpenAI, OpenRouter…) и локальные модели (Ollama, llama.cpp).

Примечание: Подробную информацию о переменных окружения и настройке локальных моделей см. в Полной документации — Переменные окружения.

3. Сборка и запуск

./install.sh  # Clean install with full stack reset

4. Запустите первую оценку

./darkmoon.sh "TARGET: example.com"

5. Наблюдайте в реальном времени

./darkmoon.sh --log <session_id>

Примечание: Журналы сеансов в реальном времени отображают каждую команду, выполняемую MCP-сервером. Подробнее см. в Полной документации — Журналы сеансов.

Как это работает

DarkMoon работает как стратегический оркестратор ИИ-агентов безопасности, согласованный с методологиями ISO 27001, NIST SP 800-115 и MITRE ATT&CK.

Когда вы указываете цель, платформа автоматически:

1. 🔍 Обнаруживает целевую среду (порты, сервисы, протоколы)
2. 🧠 Идентифицирует технологический стек (фреймворки, CMS, API)
3. 🎯 Моделирует поверхность атаки
4. 🚀 Развёртывает специализированных субагентов на основе обнаруженных технологий
5. 🔬 Выполняет цикл интеллектуального сканирования уязвимостей с реактивной адаптацией
6. ✅ Подтверждает находки доказательствами (запросы, пэйлоады, ответы)
7. 📝 Генерирует структурированный аудиторский отчёт

Оркестрация субагентов

DarkMoon динамически выбирает и отправляет специализированных агентов в зависимости от обнаруженных технологий:

Несколько агентов могут выполняться параллельно в гибридных архитектурах.

Примечание: Полный список агентов, их структуру, жизненный цикл и способы создания пользовательских агентов см. в Полной документации — ИИ-агенты.

Обзор архитектуры

User ──> DarkmoonCLI ──> OpenCode (AI Brain) ──> MCP (Security Gatekeeper) ──> Docker Toolbox (Real Tools)

sequenceDiagram
  participant U as User
  participant O as OpenCode
  participant A as AI Agent
  participant M as MCP Darkmoon
  participant T as Docker Toolbox

  U->>O: User prompt
  O->>A: Delegate task
  A->>M: MCP function call
  M->>T: Execute real tool
  T-->>M: Results
  M-->>A: Structured output
  A-->>O: Next decision
  O-->>U: Summary / result

ИИ рассуждает и планирует. MCP контролирует, что может быть выполнено. Toolbox запускает изолированные инструменты внутри Docker. ИИ никогда напрямую не взаимодействует с системой — это безопасность как принцип проектирования.

Примечание: Полное описание архитектуры (диаграммы развёртывания, сетевые потоки, границы безопасности) см. в Полной документации — Архитектура.

Определение области тестирования

DarkMoon поддерживает гибкое определение области тестирования непосредственно из командной строки.

Быстрый пентест (без настройки):

./darkmoon.sh "TARGET: http://172.19.0.3:3000"

Режим bug bounty (флаги активируются автоматически):

./darkmoon.sh "TARGET: http://172.19.0.3:3000 PROGRAM=\"Juice Shop\" FOCUS=sqli,xss,idor NOISE=moderate FORMAT=h1"

Ключевые флаги включают FOCUS, EXCLUDE, CREDS, TOKEN, NOISE, SEVERITY, FORMAT и другие — все они естественным образом интерпретируются ИИ.

Примечание: Полный справочник флагов, типы активов, свободный синтаксис EXCLUDE/FOCUS и расширенное определение области для нескольких целей см. в Полной документации — Определение области тестирования.

Интегрированный набор инструментов

DarkMoon поставляется со специально созданным Docker-образом, содержащим более 50 инструментов безопасности, скомпилированных и оптимизированных в многоступенчатой сборке:

Все инструменты доступны напрямую — настройка путей не требуется.

Примечание: Полный список инструментов с деталями установки и инструкциями по добавлению новых инструментов см. в Полной документации — Инструментарий.

📖 Руководство по документации

Полная документация DarkMoon охватывает всё необходимое для работы с платформой. Вот краткий справочник по наиболее важным разделам:

Варианты использования

DarkMoon спроектирован как универсальная платформа для тестирования безопасности для:

• 🔒 Команд безопасности — запускайте непрерывное автоматизированное тестирование на проникновение по всей вашей инфраструктуре
• ⚙️ DevSecOps-пайплайнов — интегрируйте исследования безопасности на базе ИИ в рабочие процессы CI/CD
• 🎯 Охотников за bug bounty — ускоряйте этичный хакинг с помощью автономного анализа целей
• 🔬 Исследователей безопасности — исследуйте поверхности атаки с помощью ИИ-платформы кибербезопасности, которая адаптируется в реальном времени
• 🎓 Обучения и образования — изучайте наступательную безопасность с помощью направляемых воспроизводимых оценок

Примеры промптов

# Web application pentest
./darkmoon.sh "TARGET: http://172.19.0.3:3000"

# Active Directory assessment
./darkmoon.sh "TARGET: 192.168.1.10"

# Bug bounty with specific focus
./darkmoon.sh "TARGET: https://app.example.com PROGRAM=\"Example BB\" FOCUS=sqli,rce,ssrf EXCLUDE=H1 FORMAT=h1"

Примечание: Дополнительные примеры промптов, включая сценарии с DVGA, Juice Shop и headless-браузером, см. в Полной документации — Примеры промптов.

Участие в разработке

DarkMoon — это открытый проект, и он приветствует вклад сообщества. Хотите ли вы добавить новых агентов, интегрировать инструменты, создавать рабочие процессы или улучшить документацию — ознакомьтесь с рекомендациями в CONTRIBUTING.md.

Лицензия

Этот проект распространяется под лицензией GNU General Public License v3.0. Подробности см. в LICENSE.