После завершения прохода fingerprint OpenDoor выводит компактную сводку предварительного сканирования перед началом перебора по словарю:```text
Fingerprint result: cms/WordPress (95%)
Web stack: WordPress | PHP | Cloudflare
Security posture: HSTS preload-ready

### pip```bash
python3 -m pip install --upgrade opendoor

Пакеты Chocolatey могут отставать от последнего релиза на GitHub/PyPI, пока проходит модерация сообщества.

### Arch Linux / AUR

OpenDoor доступен в Arch User Repository:```bash
yay -S opendoor

### Docker

OpenDoor доступен в виде официального Docker-образа проекта через GitHub Container Registry.```bash
docker pull ghcr.io/stanislav-web/opendoor:latest
docker run --rm -it ghcr.io/stanislav-web/opendoor:latest --version

### BlackArch Linux

OpenDoor доступен в BlackArch Linux:```bash
sudo pacman -Syu
sudo pacman -S opendoor

См. полное [руководство по установке](https://opendoor.readthedocs.io/Installation-and-update/).

---

## 🚀 Быстрое использование

### Базовое сканирование каталогов```bash
opendoor --host https://example.com

`--crawl` активируется вручную и работает только со сканированием каталогов. Он использует `GET`, извлекает консервативные HTML-атрибуты из уже просканированных ответов, сохраняет только URL-адреса того же источника, учитывает игнорируемые расширения, пропускает POST-формы и внешние источники и сообщает об обнаруженных URL-адресах через обычные группы результатов.

### Сканирование поддоменов```bash
opendoor --host example.com --scan subdomains

Целевые файлы могут содержать URL-адреса, домены, IPv4-адреса, блоки IPv4 CIDR и включающие диапазоны IPv4:```text
https://example.com
app.example.com
192.168.1.10
192.168.1.0/24
192.168.1.10-192.168.1.50

Тот же смешанный формат целей поддерживается через STDIN.

### Низкошумное сканирование```bash
opendoor \
  --host https://example.com \
  --method GET \
  --auto-calibrate \
  --include-status 200-299,301,302,403 \
  --exclude-status 404,429,500-599 \
  --exclude-size-range 0-256 \
  --sniff endpoint,secret,shadow,openredirect,malware,skipempty,collation,indexof,file,stacktrace \
  --reports std,json,csv,sarif

Полезные снифферы включают:

| Sniffer             | Назначение                                                                                                                          |
|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|
| `indexof`           | Обнаружение страниц со списком каталогов.                                                                                           |
| `file`              | Обнаружение известных шаблонов раскрытия чувствительных файлов.                                                                     |
| `collation`         | Обнаруживает повторяющиеся или похожие на редирект резервные ответы, которые могут создавать ложные срабатывания.                   |
| `skipempty`         | Пропускать пустые ответы.                                                                                                           |
| `skipsizes=46`      | Пропускать ответы с точными известными «шумными» размерами.                                                                         |
| `skipsizes=46:1024` | Пропускать ответы внутри «шумного» диапазона размеров.                                                                              |
| `stacktrace`        | Обнаруживать раскрытые стектрейсы отладки/выполнения и детали внутренних ошибок.                                                    |
| `secret`            | Обнаруживать возможные раскрытые API-ключи, токены, закрытые ключи и учётные данные с редактируемыми метаданными отчёта.            |
| `shadow`            | Активно проверять подтверждённые ответы `200 OK`, похожие на файлы, на ограниченные резервные/теневые варианты, такие как `.bak`, `.old` и шаблоны путей. |
| `openredirect`      | Активно проверять параметры запроса, похожие на редирект, с контролируемыми маркерными URL и сообщать только о подтверждённых уязвимостях открытого перенаправления. |
| `endpoint`          | Пассивно обнаруживать клиентские конечные точки WebSocket, Socket.IO, SSE/EventSource и AJAX в уже загруженных ответах.             |
| `malware`           | Обнаруживать возможное вредоносное содержимое, маркеры веб-шеллов, внедрённые скрипты или обфусцированные полезные нагрузки.        |

Снифферы, зависящие от тела запроса, автоматически принудительно используют `GET`, если настроенный метод — `HEAD`.

Подробнее: [Справочник снифферов](https://opendoor.readthedocs.io/Sniffers/)

### Аутентифицированное сканирование из необработанного запроса```bash
opendoor \
  --raw-request request.txt \
  --scheme https \
  --method GET \
  --auto-calibrate \
  --reports json,html,sqlite,sarif

### Отказоустойчивое сканирование

Используйте более консервативный профиль выполнения для нестабильных целей, медленных сетей, временных блокировок WAF, нестабильности прокси или длительных авторизованных сканирований.```bash
opendoor \
  --host https://example.com \
  --method GET \
  --timeout 60 \
  --retries 5 \
  --retries-fail-streak 25 \
  --auto-calibrate \
  --waf-detect \
  --waf-guard \
  --session-save session.json \
  --reports std,json,html

Во время активного сканирования нажмите `Ctrl+C` один раз, чтобы приостановить воркеры, затем выберите `C` для продолжения или `E` для прерывания.

### Пробы обхода заголовков и путей

Используйте это только на системах, которые вам разрешено тестировать. Функция является opt-in и зондирует заблокированные ресурсы с контролируемыми временными заголовками и безопасными вариантами путей.```bash
opendoor \
  --host https://example.com \
  --method GET \
  --waf-detect \
  --header-bypass \
  --header-bypass-limit 32 \
  --reports std,json,csv,sarif,sqlite

### Маршрутизация через прокси

Используйте один явный прокси:```bash
opendoor --host https://example.com --proxy socks5://127.0.0.1:9050

Используйте собственный список ротационных прокси:```bash
opendoor --host https://example.com --proxy-list proxies.txt

Если OpenVPN установлен вне `PATH`, укажите бэкенд явно:```bash
opendoor \
  --host https://example.com \
  --transport openvpn \
  --transport-profile ./profile.ovpn \
  --transport-bin /opt/homebrew/sbin/openvpn

Дополнительные примеры:

- [Базовые сканирования](https://opendoor.readthedocs.io/examples/basic-scans/)
- [Пакетные сканирования](https://opendoor.readthedocs.io/examples/batch-scans/)
- [Сканирования с аутентификацией](https://opendoor.readthedocs.io/examples/authenticated-scans/)
- [WAF-безопасные сканирования](https://opendoor.readthedocs.io/examples/waf-safe-scans/)
- [Сканирования с обходом заголовков](https://opendoor.readthedocs.io/examples/header-bypass-scans/)
- [Сканирования через VPN-транспорт](https://opendoor.readthedocs.io/examples/vpn-transport-scans/)
- [Примеры CI/CD](https://opendoor.readthedocs.io/examples/ci-cd/)

---

### Дифференциальное сравнение отчётов

OpenDoor может сравнивать ровно два предыдущих/текущих отчёта без запуска нового сканирования. Используйте это, когда хотите увидеть, что появилось, исчезло или изменилось между двумя результатами авторизованного сканирования.

Поддерживаются только пары входных файлов SQLite-to-SQLite и JSON-to-JSON. Смешанные форматы, отсутствующие файлы, недействительные отчёты и неподдерживаемые типы отчётов вызывают корректную ошибку проверки.```bash
opendoor --diff reports/baseline/example.com.sqlite:reports/current/example.com.sqlite --reports std,json
opendoor --diff reports/baseline/example.com.json:reports/current/example.com.json --reports std,json --reports-dir ./diff

Пример загрузки через GitHub Actions:```yaml
- name: Upload OpenDoor SARIF
  uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: reports/example.com/example.com.sarif
    category: opendoor

Запуск тестов:```bash
python -m unittest

Документация по сборке:```bash
python3 -m venv .docs-venv
source .docs-venv/bin/activate
python -m pip install -r docs/requirements.txt
python -m mkdocs build --strict

См. полное [руководство по тестированию](https://opendoor.readthedocs.io/Testing/) и [руководство по внесению вклада](https://opendoor.readthedocs.io/Contribution/).

---

## 🔐 Безопасность и гигиена секретов

Не коммитьте реальные секреты и приватные транспортные профили.

Никогда не публикуйте:

- реальные профили OpenVPN;
- приватные ключи WireGuard;
- клиентские сертификаты mTLS и приватные ключи;
- файлы auth-user-pass;
- файлы cookie;
- bearer-токены;
- списки целей клиентов;
- приватные отчёты о сканировании;
- чувствительные артефакты CI.

Используйте только примеры-заглушки.

---

## ⚖️ Ответственное использование

OpenDoor — это инструмент для тестирования безопасности.

Используйте его только против систем, которыми вы владеете или на тестирование которых у вас есть явное разрешение.

Такие функции, как обнаружение WAF, WAF-безопасное сканирование, повторная отправка raw-запросов, транспортные профили и зонды обхода Header Injection, предназначены для авторизованного тестирования безопасности, защитной валидации и регрессионных проверок экспозиции.

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

---

## 🧾 Журнал изменений

См. [CHANGELOG.md](https://github.com/stanislav-web/opendoor/blob/HEAD/CHANGELOG.md) и [релизы на GitHub](https://github.com/stanislav-web/OpenDoor/releases).

---

## 🤝 Внесение вклада

Пул-реквесты приветствуются.

Перед внесением вклада ознакомьтесь с [руководством по внесению вклада](https://opendoor.readthedocs.io/Contribution/) и запустите соответствующие тесты.
OpenDoor развивается благодаря вкладу в код, обновлению документации, тестированию, отчётам об ошибках, отзывам о безопасности, идеям функций и проверке сообществом.
Спасибо всем, кто помог улучшить проект.

[![Contributors](https://contrib.rocks/image?repo=stanislav-web/OpenDoor)](https://github.com/stanislav-web/OpenDoor/graphs/contributors)

---

## 📄 Лицензия

OpenDoor выпускается только под лицензией GNU General Public License v3.0.

См. [LICENSE](https://github.com/stanislav-web/opendoor/blob/HEAD/LICENSE).

---

## Поддержка

Если OpenDoor помогает вашей авторизованной работе по безопасности, вы можете поддержать дальнейшее сопровождение проекта через Giveth.

[Поддержать OpenDoor на Giveth](https://giveth.io/project/opendoor)

---
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/stanislav-web/OpenDoor) [![License: GPL v3](https://img.shields.io/badge/license-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)