vrr/dpi-detector
2
0
Fork 0
mirror of https://github.com/Runnin4ik/dpi-detector.git synced 2026-07-10 01:18:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mirror of https://github.com/Runnin4ik/dpi-detector link from https://habr.com/ru/articles/997088/
81 commits 1 branch 14 tags 11 MiB
Find a file
Exact
Kirill Minovsky c3bf59a65b feat(config): Introduce SNI whitelisting configuration 
- Bundle whitelist_sni.txt with PyInstaller releases
- Document new SNI whitelisting feature in README.md
- Update Docker run commands to allow mounting whitelist_sni.txt
- Expand customizable files list in README.md for CLI and EXE usage
- Correct release links in README.md for version consistency
2026-03-02 02:35:31 +03:00
.github/workflows feat(config): Introduce SNI whitelisting configuration 2026-03-02 02:35:31 +03:00
cli feat(sni-whitelist): Rework test with RTT hints and live UI 2026-03-02 02:05:02 +03:00
core feat(sni-whitelist): Rework test with RTT hints and live UI 2026-03-02 02:05:02 +03:00
images update logo 2026-02-23 01:37:12 +03:00
utils feat(tests): Add whitelist SNI test and refine domain checks 2026-03-02 00:55:06 +03:00
.gitignore add build folders 2026-02-14 02:38:09 +03:00
config.py chore(config): Refine configuration settings 2026-03-02 00:48:15 +03:00
Dockerfile fix new tcp16 file 2026-03-02 00:47:50 +03:00
domains.txt delete rutracker.org 2026-03-02 00:47:37 +03:00
dpi_detector.py feat(tests): Add whitelist SNI test and refine domain checks 2026-03-02 00:55:06 +03:00
LICENSE Initial commit 2026-02-14 01:00:15 +03:00
README.md feat(config): Introduce SNI whitelisting configuration 2026-03-02 02:35:31 +03:00
requirements.txt Remove aiodns dependency 2026-02-28 02:08:00 +03:00
tcp16.json added new targets 2026-03-02 00:46:22 +03:00
whitelist_sni.txt added new sni 2026-03-02 02:01:01 +03:00

README.md


«Маяк у гаснущего горизонта свободного интернета»
Сквозь цифровые сумерки. Смотритель маяка, Runni

🔍 DPI Detector

Python 3.8+ License: MIT Docker

Инструмент для анализа цензуры трафика в России: обнаруживает и классифицирует блокировки сайтов, хостингов и CDN (TCP16-20 блокировки), а также подмену DNS-запросов провайдером.

Пример результатов

🎯 Возможности

  • TCP 16-20KB блокировка — обнаруживает обрыв соединения к CDN и хостингам после передачи 14-34KB
  • Подбор белых SNI для AS хостингов/CDN
  • Проверка доступности заблокированных сайтов — тестирует TLS 1.2, TLS 1.3 и HTTP
  • Проверка DNS — выявляет перехват UDP/53, подмену IP-адресов заглушками и блокировку DoH
  • Классификация ошибок — различает TCP RST, Connection Abort, Handshake/Read Timeout, TLS MITM, SNI-блокировку и другие
  • Гибкая настройка — таймауты, потоки, свои списки доменов, DNS-серверы и IPv4-only режим

⚙️ Кастомизация

Следующие файлы могут быть переопределены. Инструкции ниже.

  1. domains.txt — список доменов для проверки.
  2. tcp16.json — цели для теста TCP 16-20KB.
  3. config.py — конфигурация.
  4. whitelist_sni.txt — список белых SNI для подбора рабочих

Warning

Если у вас запущены средства обхода блокировок (например, zapret или GoodbyeDPI), результаты тестов будут искажены. Чтобы узнать реальное состояние фильтров вашего провайдера, выключите их перед началом проверки или убедитесь, что они работают в режиме обработки всех пакетов (режим ALL), а не только по списку.

🐋 Docker (Рекомендовано)

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

Docker проверит наличие обновлений и скачает свежую версию перед запуском

docker run --rm -it --pull=always ghcr.io/runnin4ik/dpi-detector:latest

Или запускайте с указанием определенной версии
Это избавляет от постоянных скачиваний, но нужно следить за актуальностью версий

docker run --rm -it ghcr.io/runnin4ik/dpi-detector:2.0

С кастомизацией

Переопределите нужные файлы: domains.txt, tcp16.json... Запустите с монтированием (можно монтировать один или несколько файлов)

# Bash (Linux / macOS)
docker run --rm -it --pull=always \
  -v $(pwd)/domains.txt:/app/domains.txt \
  -v $(pwd)/tcp16.json:/app/tcp16.json \
  -v $(pwd)/config.py:/app/config.py \
  -v $(pwd)/whitelist_sni.txt:/app/whitelist_sni.txt \
  ghcr.io/runnin4ik/dpi-detector:latest
Команды для PowerShell и CMD

PowerShell (Windows)

docker run --rm -it --pull=always `
  -v ${PWD}/domains.txt:/app/domains.txt `
  -v ${PWD}/tcp16.json:/app/tcp16.json `
  -v ${PWD}/config.py:/app/config.py `
  -v ${PWD}/whitelist_sni.txt:/app/whitelist_sni.txt `
  ghcr.io/runnin4ik/dpi-detector:latest

CMD (Windows)

docker run --rm -it --pull=always ^
  -v %cd%/domains.txt:/app/domains.txt ^
  -v %cd%/tcp16.json:/app/tcp16.json ^
  -v %cd%/config.py:/app/config.py ^
  -v %cd%/whitelist_sni.txt:/app/whitelist_sni.txt ^
  ghcr.io/runnin4ik/dpi-detector:latest

🐍 Python 3.8+

Требования: httpx>=0.28, rich>=14.3

Установка:

# скачайте и распакуйте архив руками, или:
git clone https://github.com/Runnin4ik/dpi-detector.git
cd dpi-detector
python -m pip install -r requirements.txt

Запуск:

python dpi_detector.py

🪟 Windows (Готовые сборки)

Для использования программы не обязательно устанавливать Python. Скачайте подходящий .exe файл в разделе Releases -> Assets:

С кастомизацией

Переопределите нужные файлы: domains.txt, tcp16.json, config.py, whitelist_sni.txt И положите их в папку рядом с .exe файлом.

🤝 Вклад в проект

Приветствуются Issue и Pull Request'ы и предложения функционала!

📜 Лицензия

MIT License — свободное использование, модификация и распространение.

⚠️ Дисклеймер

Этот инструмент предназначен исключительно для образовательных и диагностических целей. Автор не несет ответственности за использование данного ПО.

🙏 Благодарности

💖 Поддержка проекта

Чаевые картой или по СБП

Валюта Сеть Адрес
USDT TRC20 TGtcb4JMT5F3KiEL16oZnj9ijB2Pag1jCX
USDT ERC20 0x97413028546b5da4cbba4d9838c9d635a5333ab1
USDT TON UQApgV57_p0hQGBV9oxrDi7SvKqgN3pigw5YEA28VShrZ7X_
TON UQApgV57_p0hQGBV9oxrDi7SvKqgN3pigw5YEA28VShrZ7X_
BNB BEP-20 0x97413028546b5da4cbba4d9838c9d635a5333ab1
SOL 9obMiD8hYfs4D8XskQjHPPtAKYPq9CaEZTbBMxtCjQ3k
BTC bc1q7579xpmxcrz34lzmrxfupkpcczvemeqk2e9f4h
ETH 0x97413028546b5da4cbba4d9838c9d635a5333ab1

Star History

Star History Chart