blockchecks 1.3.2__tar.gz

blockchecks-1.3.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 blockcheckS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

blockchecks-1.3.2/MANIFEST.in

@@ -0,0 +1,20 @@
+include configs/*.conf
+include configs/composite_discord.conf
+recursive-include presets/strategies *.tls *.txt *.http *.quic *.udp
+recursive-include presets/domains *.txt
+include presets/blobs/README.md
+recursive-include blobs *.bin
+include blobs/README.md
+recursive-include lua/blockchecks *.lua
+recursive-include lua/custom *.lua *.toml
+include lua/README.md
+include lua/custom/README.md
+include presets/README.md
+include LICENSE
+include README.md
+include docs/todo.md
+include docs/guide.md
+include docs/package.md
+include changelog.md
+recursive-include systemd *.service
+recursive-include src/blockchecks *.py

blockchecks-1.3.2/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: blockchecks
+Version: 1.3.2
+Summary: Asynchronous DPI strategy testing framework for nfqws2/zapret2
+Author: zhoel-sherk
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/zhoel-sherk/blockcheckS
+Project-URL: Repository, https://github.com/zhoel-sherk/blockcheckS
+Project-URL: Changelog, https://github.com/zhoel-sherk/blockcheckS/blob/master/changelog.md
+Project-URL: Documentation, https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/guide.md
+Keywords: nfqws2,zapret,dpi,network,bypass,blockcheck,netns
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: curl-cffi>=0.8.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Requires-Dist: pydantic-settings>=2.0
+Provides-Extra: mcp
+Requires-Dist: mcp<2.0.0,>=1.1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pytest-randomly>=3.15; extra == "dev"
+Requires-Dist: pytest-timeout>=2.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.5.0; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: vulture>=2.14; extra == "dev"
+Requires-Dist: pytest-archon>=0.0.6; extra == "dev"
+Requires-Dist: mutmut>=3.6; extra == "dev"
+Requires-Dist: hypothesis>=6.0; extra == "dev"
+Provides-Extra: discovery
+Requires-Dist: aiohttp-socks>=0.11.0; extra == "discovery"
+Requires-Dist: aiohttp>=3.9; extra == "discovery"
+Provides-Extra: youtube
+Requires-Dist: yt-dlp>=2024.1.0; extra == "youtube"
+Dynamic: license-file
+
+# blockchecks
+
+Asynchronous DPI (Deep Packet Inspection) strategy testing framework for
+**nfqws2** / **zapret2**.
+
+It runs thousands of desync strategies against target domains inside isolated
+network namespaces, using a browser-grade TLS fingerprint (JA4 via curl_cffi),
+and reports which combinations actually work on a given network. Results are
+stored in SQLite and can be exported to ready-to-use nfqws2 configuration
+files for Keenetic / OpenWrt / Linux routers.
+
+## Features
+
+- **Fast**: ~1 test/sec (33× faster than the reference `blockcheck.sh`) via
+  asyncio + a reused netns pool.
+- **Accurate**: browser-grade JA4 TLS fingerprint (Chrome BoringSSL), content
+  validation, DPI fake-detection.
+- **TCP + UDP**: TCP strategy families, HTTP :80, QUIC/HTTP3, and Discord
+  Voice UDP endpoint discovery (STUN + IP Discovery).
+- **Resilient**: checkpoint/resume, SQLite state, adaptive priority queue.
+- **Tooling**: static strategy validator (offline, 9+ rules), custom Lua
+  registry, MCP server for LLM agents.
+- **Portable**: installs on x86_64, arm64 and armv7l (Raspberry Pi 2+) without
+  compiling native dependencies.
+
+## Requirements
+
+- Linux with root (needed for network namespaces + iptables)
+- Python 3.10+
+- nfqws2 / zapret2 (auto-fetched on first run)
+
+## Quick start
+
+```bash
+pip install blockchecks
+
+# First scan — ~30 strategies against discord.com
+sudo bs scan -d discord.com --generate --parallel 4
+
+# Resume after interruption (checkpoint/resume)
+sudo bs scan -d discord.com --generate --resume
+```
+
+## Export a router config
+
+```bash
+# default: ~/.local/share/blockcheckS/export/nfqws2_<ts>.conf (+ raw, user.list)
+bc-nfconf --db logs/run.db --out-dir /path/to/out
+
+# optional: add an IP filter from the DNS cache (no DNS needed on the router)
+bc-nfconf --db logs/run.db --out-dir /path/to/out --ipset
+```
+
+## Documentation
+
+- [User guide](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/guide.md)
+- [Architecture](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/architecture.md)
+- [MCP server](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/mcp.md)
+- [Changelog](https://github.com/zhoel-sherk/blockcheckS/blob/master/changelog.md)
+
+## License
+
+MIT — see [LICENSE](https://github.com/zhoel-sherk/blockcheckS/blob/master/LICENSE).
+
+## Disclaimer
+
+This software is an open-source analytical tool for educational, academic and
+network-research purposes, intended for network administrators and systems
+engineers to study DPI behaviors. Use entirely at your own risk.

blockchecks-1.3.2/README.md

@@ -0,0 +1,282 @@
+# blockcheckS — lightspeed DPI strategy tester
+
+[![version](https://img.shields.io/badge/version-1.3.2-green)](#)
+[![python](https://img.shields.io/badge/python-3.10%2B-green)](#)
+[![license](https://img.shields.io/badge/license-MIT-brightgreen)](LICENSE)
+[![tests](https://img.shields.io/badge/tests-1266%20passed-success)](#)
+
+**Твой провайдер режет YouTube, Discord и Telegram через DPI?**
+*blockcheckS за 10 минут найдёт работающий обход из 10 000+ комбинаций,
+пока ты пьёшь кофе. В 33 раза быстрее, чем blockcheck.sh.*
+
+> Асинхронный подбор стратегий nfqws2/zapret2 в изолированных network
+> namespaces. HTTP/2 и HTTP/3 через браузерный TLS-отпечаток (JA4),
+> TCP×UDP pair matrix с авто-дискавери голосовых эндпоинтов Discord,
+> checkpoint/resume, SQLite-стейт и экспорт готового конфига для Keenetic.
+
+- ⚡ **1 тест/сек** — 33× быстрее blockcheck.sh (0.43 тест/сек)
+- 🔍 **10 886+ стратегий** — StandardGenerator: TCP-семей + HTTP :80 + QUIC + UDP voice
+- 🎭 **Браузерный JA4** — curl_cffi с Chrome 124 BoringSSL (не палится как скрипт)
+- 🏊 **Netns pool** — пресозданные изолированные namespace'ы
+- 🔬 **Preflight Triage** — детерминированный профиль DPI до скана (DNS/L3/SNI/
+  stream-stall/QoS/QUIC/TLS-fingerprint) → отсечение бесполезных веток генераторов
+- 🧬 **Adaptive queue** — генетический буст PASS-стратегий по family/blob/traits
+- 🛰️ **`bs serve`** — резидентный on-the-fly probe server (Unix socket + HTTP)
+- 🧩 **`bs mcp`** — MCP-мост (FastMCP, stdio) для LLM-клиентов (Claude/Cursor/opencode)
+- 🧪 **Статический валидатор** — офлайн-проверка стратегий до netns (9+ правил,
+  fuzz-устойчив) + кастомные Lua (`lua/custom/`, `manifest.toml` с included/excluded)
+- 📊 **TCP×UDP матрицы** — ищет пары стратегий для голоса Discord
+- 💾 **Checkpoint/resume** — упал роутер? Продолжи с места, SQLite помнит всё
+- 📦 **nfconf export** — готовый конфиг для Keenetic, Linux, OpenWrt (+ `--ipset`
+  из DNS-кэша, IP→CIDR через ip2net)
+- 🤖 **Zapret2 auto-fetch** — сам скачает nfqws2 с GitHub, если нет локально
+- 🍓 **Raspberry Pi 2+ (armv7l)** — установка без компиляции (stdlib /proc, без psutil)
+
+---
+
+## Оглавление
+
+1. [Что такое blockcheckS? (30 секунд)](#что-такое-blockchecks-30-секунд)
+2. [Сравнение с blockcheck.sh](#сравнение-с-blockchecksh)
+3. [Быстрый старт](#быстрый-старт)
+4. [Установка](#установка)
+5. [CLI команды](#cli-команды)
+6. [Пресеты](#пресеты)
+7. [Экспорт конфига для роутера](#экспорт-конфига-для-роутера)
+8. [Документация](#документация)
+9. [For contributors](#for-contributors)
+10. [Дисклеймер](#дисклеймер)
+
+---
+
+## Что такое blockcheckS? (30 секунд)
+
+Берёшь домен (скажем, `discord.com`), запускаешь одну команду — и через пару
+минут получаешь список стратегий nfqws2, которые **реально работают** на твоём
+провайдере. Никакого гадания на кофейной гуще с `badsum`/`fakedsplit` — только
+холодный, циничный перебор через изолированные netns с браузерным JA4.
+
+```bash
+sudo bs scan -d discord.com --generate --parallel 4
+# → 29 стратегий за 8 секунд, 3 PASS
+```
+
+Под капотом: asyncio + NetNsPool + curl_cffi + nfqws2 + SQLite + немного магии.
+
+---
+
+## Сравнение с blockcheck.sh
+
+| blockcheck.sh (оригинал) | blockcheckS (этот парень) |
+|---|---|
+| ~60–120 сек на стратегию | ~3–5 сек на стратегию (async parallel) |
+| System curl / OpenSSL | curl_cffi с браузерным JA4 (Chrome 124 BoringSSL) |
+| Только TCP | TCP + UDP voice (STUN + IP Discovery) |
+| Последовательный shell | asyncio + NetNsPool (netns переиспользуются) |
+| Легко «ложно-зелёный» | Content validation + DPI fake detection |
+| 32 000+ комбинаций, медленно | 10 886 комбинаций, **быстро** (покрытие ≥90% BC2) |
+| Только bash | Python-пакет, `pip install`, pytest, ruff |
+
+---
+
+## Быстрый старт
+
+Три команды — и ты в деле:
+
+```bash
+# 1. Установка (editable, см. ниже почему)
+pip install -e ".[dev,discovery]"
+
+# 2. Первый скан — 29 стратегий на discord.com
+sudo bs scan -d discord.com --generate --parallel 4
+
+# 3. Продолжить после обрыва (checkpoint/resume)
+sudo bs scan -d discord.com --generate --resume
+```
+
+Больше примеров в [User Guide](docs/guide.md).
+
+---
+
+## Установка
+
+**Linux с root** (нужен для netns + iptables). Python 3.10+.
+
+```bash
+git clone https://github.com/zhoel-sherk/blockcheckS.git
+cd blockcheckS
+pip install -e ".[dev,discovery]"
+```
+
+Почему **editable** (`-e`)? `configs/` и `presets/` лежат в корне репо —
+plain wheel их не найдёт. Это осознанное решение (см. [ONB-7](docs/package.md)).
+
+**nfqws2 / zapret2** — blockcheckS сам скачает официальный релиз
+[bol-van/zapret2](https://github.com/bol-van/zapret2) при первом запуске в
+`~/.local/share/blockcheckS/zapret2/` (под armv7l/arm64 — `binaries/linux-arm`).
+Если nfqws2 уже стоит в `/opt/zapret2` — использует его. Отключить авто-фетч:
+`--no-fetch-deps`.
+
+**Блобы** (fake payloads) — в репо `blobs/` (без скачивания). Override:
+`BLOCKCHECKS_BLOBS`. Опционально: `scripts/install_blobs.sh` для extras на хосте.
+Flowseal-техники: `--tcp-sources flowseal` / `-M flowseal-fast`
+([Flowseal/zapret-discord-youtube](https://github.com/Flowseal/zapret-discord-youtube);
+howto: [docs/cookbook/blobs.md](docs/cookbook/blobs.md)).
+
+**Raspberry Pi 2+ (armv7l)** — все обязательные зависимости имеют armv7l
+wheels на PyPI (psutil убран → stdlib `/proc`), поэтому установка **без
+компиляции**:
+```bash
+bash scripts/setup-standalone.sh    # venv + pip install + smoke
+# подробности: docs/install-rpi.md
+```
+
+Юнит-тесты запускаются **без root**:
+```bash
+pytest -m "not integration"
+```
+
+---
+
+## CLI команды
+
+| Команда | Что делает | Пример |
+|---|---|---|
+| `bs scan` | Асинхронный TCP-батч | `sudo bs scan -d discord.com --generate --parallel 4` |
+| `bs pair` | TCP×UDP pair matrix | `sudo bs pair -d discord.com --generate --auto-discover 5` |
+| `bs full` | Масс-скан + экспорт (долгий) | `sudo bs full --parallel 4 --max-timeh 2` |
+| `bs tcp` | Одна TCP-стратегия (sync) | `sudo bs tcp -d discord.com -c configs/simple_fake__fake_ts.conf` |
+| `bs udp` | Один UDP-конфиг (sync) | `sudo bs udp -c configs/udp_voice__fake_r6.conf` |
+| `bs composite` | Композитный TCP+UDP конфиг | `sudo bs composite -c configs/composite_discord.conf` |
+| `bs bench-settle` | Калибровка settle/curl таймаутов | `sudo bs bench-settle -d discord.com` |
+| `bs serve` | Резидентный probe server (Unix socket + HTTP) | `sudo bs serve --pool 2` |
+| `bs mcp` | MCP-сервер (stdio) для LLM-клиентов | `bs-mcp` (см. [docs/mcp.md](docs/mcp.md)) |
+| `bc-nfconf` | Экспорт nfqws2-конфигов из БД (+`--ipset`) | `bc-nfconf --db state.db --out-dir output --ipset` |
+
+Флаги, которые стоит знать: `--resume`, `--preset`, `-M`, `--generate`,
+`--tcp-sources`, `--parallel`, `--max`, `--scan-level`, `--repeats`,
+`--disable-ech`, `--max-timeh`. Bare `--generate` (без значения) =
+`custom,configs`; явно: `--generate fake,configs`.
+
+Подробный CLI reference: [docs/guide.md](docs/guide.md).
+
+---
+
+## Пресеты
+
+Готовые списки доменов и стратегий из GP control-plane:
+
+```bash
+# Домены
+bs scan --preset benchmark --generate        # 6 доменов для быстрой проверки
+bs scan --preset discord --generate          # голый Discord (22 домена)
+bs scan --preset google-youtube --generate   # YouTube CDN (23 домена)
+bs scan --preset critical --generate         # критичные: YT + Discord + GV
+
+# Стратегии
+bs scan -d discord.com -M blockcheckS-best   # 9 проверенных стратегий
+bs scan -d discord.com -M gp-verified        # 12 GP-подтверждённых
+bs pair -d discord.com -M gp-voice           # голосовые UDP-стратегии
+```
+
+Посмотреть всё: `bs scan --list-presets`.  
+Детали: [presets/README.md](presets/README.md).
+
+---
+
+## Экспорт конфига для роутера
+
+После прогона blockcheckS экспортирует готовые nfqws2-конфиги из best-стратегий
+в XDG-каталог:
+
+```bash
+# default: ~/.local/share/blockcheckS/export/nfqws2_<ts>.conf (+ raw, user.list)
+bc-nfconf --db logs/run.db --out-dir /path/to/out
+
+# Добавить IP-фильтр из DNS-кэша (без DNS на роутере):
+#   малые наборы → --ipset-ip inline, большие → user.ipset
+bc-nfconf --db logs/run.db --out-dir /path/to/out --ipset
+```
+
+На Keenetic скопируйте `nfqws2_*.conf` → `/opt/etc/nfqws2/nfqws2.conf`.
+Детали: [configs/README.md](configs/README.md).
+
+---
+
+## Документация
+
+| Документ | О чём |
+|---|---|
+| [User Guide](docs/guide.md) | CLI reference, примеры, known limitations |
+| [Architecture](docs/architecture.md) | Data flow, module map, voice discovery flow |
+| [Package Layout](docs/package.md) | XDG-пути, деревья, import graph |
+| [Database Schema](docs/database.md) | ER-диаграмма, SQL examples, checkpoint logic |
+| [MCP Server](docs/mcp.md) | Установка MCP в Claude Desktop / Cursor / opencode |
+| [Raspberry Pi (armv7l)](docs/install-rpi.md) | Установка на RPi 2+ без компиляции |
+| [Glossary](docs/glossary.md) | Терминология: netns, NFQUEUE, pair matrix, ... |
+| [Changelog](changelog.md) | История версий (1.3.2 и ранее) |
+| [Roadmap](docs/todo.md) | Бэклог: P1 (скорость), P2 (voice/GP), P3 (ML) |
+
+Cookbook: [add checker](docs/cookbook/add-checker.md) ·
+[add generator](docs/cookbook/add-generator.md) ·
+[add CLI flag](docs/cookbook/add-cli-flag.md) ·
+[GP bridge](docs/cookbook/gp-bridge.md).
+
+---
+
+## For contributors
+
+- [CONTRIBUTING.md](CONTRIBUTING.md) — setup, тесты, PR flow, что коммитить а что нет
+- [docs/architecture.md](docs/architecture.md) — data flow, module map
+- [docs/cookbook/](docs/cookbook/) — как добавить checker / generator / CLI flag
+
+Быстрый старт для разработчика:
+```bash
+pip install -e ".[dev,discovery]"
+ruff check src tests    # линтер
+pytest -m "not integration"   # юнит-тесты (без root)
+```
+
+---
+
+## ⚖️ Legal Disclaimer / Дисклеймер
+
+### English
+This software is provided "as is", without warranty of any kind, express or
+implied. **blockcheckS** is an open-source analytical tool designed strictly for
+educational, academic, and network research purposes. It is intended for network
+administrators and systems engineers to analyze Deep Packet Inspection (DPI)
+behaviors and diagnose network topologies.
+
+*   The author(s) do not encourage, facilitate, or promote any illegal
+    activities or violations of local telecommunication laws.
+*   This software does not contain any malicious code, malware, or exploits
+    designed to compromise computer security or bypass information protection
+    systems (in compliance with Art. 273 of the Criminal Code of the Russian
+    Federation).
+*   The use of this tool is entirely **at your own risk**. The author(s) shall
+    not be held liable for any direct, indirect, incidental, or consequential
+    damages, service disruptions, or legal actions resulting from the use or
+    misuse of this software.
+
+### Русский
+Данное программное обеспечение предоставляется по принципу «как есть» (as is).
+**blockcheckS** является аналитическим инструментом и распространяется
+исключительно в ознакомительных, научно-исследовательских и диагностических
+целях для системных инженеров и сетевых администраторов.
+
+*   **Исключительно исследовательский характер**: Программа предназначена для
+    изучения механизмов работы систем глубокого анализа пакетов (DPI) и не
+    содержит вредоносного функционала, средств обхода систем защиты информации
+    или вирусов (соответствует требованиям **Ст. 273 УК РФ**). Утилита
+    оперирует стандартными сетевыми вызовами и легитимными механизмами ядра
+    Linux.
+*   **Соблюдение законодательства**: Автор(ы) не призывают к нарушению
+    действующего законодательства Российской Федерации, включая Федеральный
+    закон «О связи» № 126-ФЗ и Федеральный закон «Об информации, информационных
+    технологиях и о защите информации» № 149-ФЗ.
+*   **Отказ от ответственности**: Вы используете данное ПО **на свой страх и
+    риск**. Автор(ы) не несут ответственности за любые ограничения связи,
+    блокировки, штрафы, потерю данных или иные прямые или косвенные
+    последствия, возникшие в результате работы или неправильной настройки
+    данной утилиты.

blockchecks-1.3.2/README.pypi.md

@@ -0,0 +1,69 @@
+# blockchecks
+
+Asynchronous DPI (Deep Packet Inspection) strategy testing framework for
+**nfqws2** / **zapret2**.
+
+It runs thousands of desync strategies against target domains inside isolated
+network namespaces, using a browser-grade TLS fingerprint (JA4 via curl_cffi),
+and reports which combinations actually work on a given network. Results are
+stored in SQLite and can be exported to ready-to-use nfqws2 configuration
+files for Keenetic / OpenWrt / Linux routers.
+
+## Features
+
+- **Fast**: ~1 test/sec (33× faster than the reference `blockcheck.sh`) via
+  asyncio + a reused netns pool.
+- **Accurate**: browser-grade JA4 TLS fingerprint (Chrome BoringSSL), content
+  validation, DPI fake-detection.
+- **TCP + UDP**: TCP strategy families, HTTP :80, QUIC/HTTP3, and Discord
+  Voice UDP endpoint discovery (STUN + IP Discovery).
+- **Resilient**: checkpoint/resume, SQLite state, adaptive priority queue.
+- **Tooling**: static strategy validator (offline, 9+ rules), custom Lua
+  registry, MCP server for LLM agents.
+- **Portable**: installs on x86_64, arm64 and armv7l (Raspberry Pi 2+) without
+  compiling native dependencies.
+
+## Requirements
+
+- Linux with root (needed for network namespaces + iptables)
+- Python 3.10+
+- nfqws2 / zapret2 (auto-fetched on first run)
+
+## Quick start
+
+```bash
+pip install blockchecks
+
+# First scan — ~30 strategies against discord.com
+sudo bs scan -d discord.com --generate --parallel 4
+
+# Resume after interruption (checkpoint/resume)
+sudo bs scan -d discord.com --generate --resume
+```
+
+## Export a router config
+
+```bash
+# default: ~/.local/share/blockcheckS/export/nfqws2_<ts>.conf (+ raw, user.list)
+bc-nfconf --db logs/run.db --out-dir /path/to/out
+
+# optional: add an IP filter from the DNS cache (no DNS needed on the router)
+bc-nfconf --db logs/run.db --out-dir /path/to/out --ipset
+```
+
+## Documentation
+
+- [User guide](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/guide.md)
+- [Architecture](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/architecture.md)
+- [MCP server](https://github.com/zhoel-sherk/blockcheckS/blob/master/docs/mcp.md)
+- [Changelog](https://github.com/zhoel-sherk/blockcheckS/blob/master/changelog.md)
+
+## License
+
+MIT — see [LICENSE](https://github.com/zhoel-sherk/blockcheckS/blob/master/LICENSE).
+
+## Disclaimer
+
+This software is an open-source analytical tool for educational, academic and
+network-research purposes, intended for network administrators and systems
+engineers to study DPI behaviors. Use entirely at your own risk.

blockchecks-1.3.2/blobs/README.md

@@ -0,0 +1,68 @@
+# Baked strategy blobs
+
+Committed `.bin` payloads for nfqws2 `--blob=` / Flowseal-style strategies.
+
+- Prefer this directory at runtime (see `BLOCKCHECKS_BLOBS` / `config.BLOB_DIR`).
+- Alias map: `src/blockchecks/engine/blob_aliases.py`
+- How to add a file: [docs/cookbook/blobs.md](../docs/cookbook/blobs.md)
+- Upstream reference: https://github.com/Flowseal/zapret-discord-youtube
+
+## TLS ClientHello blobs (TCP :443 fake payloads)
+
+| Alias | File | Size | Source / note |
+|---|---|---|---|
+| `google` / `tls_clienthello` | `tls_clienthello_www_google_com.bin` | 681 B | www.google.com ClientHello (Flowseal bin) — базовый Google-фейк |
+| `max_ru` | `tls_clienthello_max_ru.bin` | 664 B | max.ru ClientHello (Flowseal) — подтверждён на LLC Fiord |
+| `4pda` | `tls_clienthello_4pda_to.bin` | 284 B | 4pda.to ClientHello (Flowseal) |
+| `tls_vk` | `tls_clienthello_vk_com.bin` | 517 B | vk.com ClientHello |
+| `tls_5ka` | `tls_5ka.bin` | 654 B | **5ka.ru ClientHello (NEW, Flowseal 2026)** — Пятёрочка, обход РКН |
+| `tls_funpay` | `tls_funpay.bin` | 562 B | funpay.com ClientHello (Hellcat-95, PR #16591) |
+| `tls_rzd` | `tls_rzd.bin` | 658 B | www.rzd.ru ClientHello (Hellcat-95, PR #16591) |
+
+## QUIC Initial blobs (UDP :443 fake payloads)
+
+| Alias | File | Size | Source / note |
+|---|---|---|---|
+| `quic_google` | `quic_initial_www_google_com.bin` | 1200 B | www.google.com QUIC Initial (Flowseal) — базовый |
+| `quic_dbank` | `quic_initial_dbankcloud_ru.bin` | 1357 B | dbankcloud.ru QUIC Initial (Flowseal) |
+| `quic_4pda` | `quic_4pda.bin` | 1250 B | 4pda.to QUIC Initial (Flowseal) |
+| `quic_tencent` | `quic_tencent.bin` | 1231 B | tencent.com QUIC Initial (Flowseal) |
+| `quic_steam` | `quic_steam.bin` | 1200 B | steamcommunity.com QUIC Initial (Flowseal) |
+| `quic_vk` | `quic_initial_vk_com.bin` | 1357 B | vk.com QUIC Initial |
+| `quic_5ka` | `quic_5ka.bin` | 1250 B | **5ka.ru QUIC Initial (NEW, Flowseal 2026)** — Пятёрочка |
+| `quic_rutube` | `quic_rutube.bin` | 1357 B | **rutube.ru QUIC Initial (NEW, Flowseal 2026)** — Rutube |
+| `quic_funpay` | `quic_funpay.bin` | 1200 B | funpay.com QUIC Initial (Hellcat-95, PR #16591) |
+| `quic_cloudflare` | `quic_cloudflare.bin` | 1200 B | www.cloudflare.com QUIC Initial (Hellcat-95, PR #16591) |
+| `quic_alfabank` | `quic_alfabank.bin` | 1200 B | alfabank.ru QUIC Initial (Hellcat-95, PR #16591) |
+| `quic_gv_kyber_1` | `quic_gv_kyber_1.bin` | 1230 B | googlevideo CDN QUIC + Kyber/ML-KEM key-share #1 |
+| `quic_gv_kyber_2` | `quic_gv_kyber_2.bin` | 1230 B | googlevideo CDN QUIC + Kyber key-share #2 |
+| `quic_gv_rr2` | `quic_gv_rr2.bin` | 1200 B | googlevideo CDN QUIC (rr2 snapshot) |
+| `quic_initial` | `quic_initial.bin` | 1200 B | generic QUIC Initial (zapret2 default) |
+
+## UDP voice / STUN blobs
+
+| Alias | File | Size | Source / note |
+|---|---|---|---|
+| `discord_udp` | `discord_udp.bin` | 1200 B | Flowseal ACTIVE_DISCORD_UDP.bin — Discord voice IP-discovery/media |
+| `discord_ipdisc` | `discord_ipdisc.bin` | 74 B | Discord IP-discovery-with-port (70 B discovery) |
+| `game_udp` | `game_udp.bin` | 1250 B | Flowseal ACTIVE_GAME_UDP.bin — game UDP fake |
+| `stun` | `stun.bin` | 100 B | STUN binding request (Flowseal) |
+| `stun2` | `stun2.bin` | 120 B | STUN variant 2 (Flowseal) |
+
+## Other
+
+| Alias | File | Size | Source / note |
+|---|---|---|---|
+| `wireguard_init` | `wireguard_init.bin` | 148 B | WireGuard handshake initiation |
+| `http_iana` | `http_iana.bin` | 427 B | fake HTTP GET to www.iana.org |
+
+## New blobs (2026-08)
+
+Added from Flowseal zapret-discord-youtube (2026 tree):
+- **5ka.ru** (`tls_5ka`, `quic_5ka`) — Пятёрочка (X5 Retail), россия, часто под РКН-фильтрацией.
+  Источник: [PR #16589](https://github.com/Flowseal/zapret-discord-youtube/pull/16589) (merged).
+- **rutube.ru** (`quic_rutube`) — Rutube, российский видеохостинг.
+- **funpay.com / www.cloudflare.com / alfabank.ru** (`quic_funpay`, `quic_cloudflare`,
+  `quic_alfabank`) и **funpay.com / www.rzd.ru** (`tls_funpay`, `tls_rzd`) —
+  из [PR #16591](https://github.com/Flowseal/zapret-discord-youtube/pull/16591)
+  (Hellcat-95, закрыт без мержа; блобы взяты из коммита 8c35287).

blockchecks-1.3.2/blobs/http_iana.bin

@@ -0,0 +1,9 @@
+GET / HTTP/1.1
+Host: www.iana.org
+Connection: keep-alive
+Upgrade-Insecure-Requests: 1
+User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4300.0 Safari/537.36
+Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9
+Accept-Encoding: gzip, deflate
+Accept-Language: en-US,en;q=0.9,ru;q=0.8
+