hacker07/NeoTachyon
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: expand README.md and README.en.md with comprehensive feature set

Browse Source 
- add DPI Fuzzer Engine section (PAWS TCP timestamp spoofing, authentic blobs, seqovl, TCP SYN data, target suites, Netfilter queue isolation)
- add Smart DNS & Failover section (FakeIP pool, DoH/DoT/DoQ/H3, DNS Failover daemon, anti-hijack redirection, DNS Benchmark & Autotune)
- add Parental Controls, Quotas & Smart QoS section (per-device schedules, bandwidth quotas, DSCP packet marking in nftables)
- expand Telegram bot features (real-time connection monitor, quiet hours, live section editor, resilient dual-transport, 64-byte payload protection)
- add MCP (Model Context Protocol) server documentation and WARP / AmneziaWG generator
- expand CLI reference with complete practical command table
This commit is contained in:
Dushnilin
2026-09-03 05:14:55 +03:00
parent f2d846515c
commit ea85164646
2 changed files with 238 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.en.md
+115 -35
View File
@@ -20,7 +20,7 @@
**Tachyon** is an advanced, autonomous network routing, proxy orchestration, and anti-censorship engine designed specifically for **OpenWrt** routers (fully supporting **OpenWrt 23.05, 24.10, 25.x, and SNAPSHOT** builds). Direct fork of **[Forkop by @ushan0v](https://github.com/ushan0v/forkop)** (formerly **Podkop Plus**).
Tachyon combines the power of **sing-box**, local hardware DPI bypass engines (**Zapret v1 / Zapret v2 / ByeDPI**), an interactive **Telegram bot**, and a cutting-edge **AI Stack** (autonomous **AI Doctor v2.5** with offline local diagnostics & **HTTP REST Agent API / OpenAPI 3.0**).
Tachyon combines the power of **sing-box**, local hardware DPI bypass engines (**Zapret v1 / Zapret v2 / ByeDPI**), an interactive combinatorial **DPI Strategy Fuzzer**, a hardened **Telegram control bot**, and a cutting-edge **AI Stack** (autonomous **AI Doctor v2.5**, offline local diagnostics, **HTTP REST Agent API / OpenAPI 3.0**, and **Model Context Protocol (MCP)** server for autonomous AI agents).
The entire backend logic is written in **ucode** — OpenWrt's native, high-performance C scripting language — delivering instant response times with minimal RAM footprint (starting from 128 MB RAM devices).
@@ -39,9 +39,10 @@ The entire backend logic is written in **ucode** — OpenWrt's native, high-perf
Tachyon intercepts network flows via kernel **nftables** and dispatches requests without unnecessary latency:
1. **Direct WAN**: Local services, national banks, and trusted destinations proceed without proxy overhead (`0 ms overhead`).
2. **Zapret v1 (`nfqws`)**: Basic TCP/UDP packet desynchronization (`fake`, `disorder`, `split2`) directly on router without VPS.
3. **Zapret v2 (`nfqws2`)**: Advanced multi-vector DPI evasion (`multisplit`, `seqovl`, `wsize`) for YouTube 4K and Discord.
3. **Zapret v2 (`nfqws2`)**: Advanced multi-vector DPI evasion (`multisplit`, `seqovl`, `wsize`, PAWS `tcp_ts`, authentic `blobs`) for YouTube 4K, Discord, and streaming.
4. **ByeDPI (`ciadpi`)**: Local SOCKS5 desync engine with HTTP/TLS SNI payload fragmentation.
5. **Encrypted Proxy Tunnel (sing-box)**: Censored endpoints and private traffic are routed through modern protocols (VLESS Reality, Hysteria2, WireGuard).
5. **Encrypted Proxy Tunnel (sing-box)**: Censored endpoints and private traffic are routed through modern protocols (VLESS Reality, Hysteria2, WireGuard, AmneziaWG).
6. **Smart DNS Pipeline**: Isolated DNS processing via FakeIP (`198.18.0.0/15`), DoH/DoT/DoQ with anti-hijack transparent redirection and automated failover (DNS Failover).
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
@@ -49,28 +50,52 @@ Tachyon intercepts network flows via kernel **nftables** and dispatches requests
## 🔥 Core Features & Subsystems
### 🛡️ 1. Multi-Protocol Proxying & Local DPI Bypass
### 🛡️ 1. Multi-Protocol Proxying & Smart DNS Stack
* **sing-box Engine (v1.11+)**: Native support for modern proxy protocols — **VLESS (Reality / gRPC / WS)**, **VMess**, **Shadowsocks**, **Trojan**, **Hysteria2**, and **WireGuard / AmneziaWG**.
* **Local DPI Bypass Without External VPS**:
* Full built-in integration with **Zapret v1 (`nfqws`)**, **Zapret v2 (`nfqws2`)**, and **ByeDPI (`ciadpi`)** desync engines for hardware TCP segment manipulation.
* **Cloudflare WARP & AmneziaWG Generator (`generate_warp`)**: Instant generation of working WireGuard and AmneziaWG profiles directly on the router.
* **Multi-Dimensional Selective Routing**:
* **By Domains & IP Subnets**: Route only target traffic through proxies or desync engines.
* **By Client Devices (MAC / IP)**: Per-device routing rules for Smart TVs, smartphones, PCs, and gaming consoles.
* **By GeoIP & Countries**: Flexible inclusion/exclusion list controls based on destination country.
* **Automated Subscription Updates**: Background fetching, parsing, and node rotation from remote subscription URLs with automated latency (RTT) testing.
#### 🌐 Hosts Sections & DNS Overrides (Hosts Engine)
* **Static DNS Overriding (`dns_hosts`)**: Direct mapping of domains to static IP addresses in sing-box DNS and dnsmasq without editing `/etc/hosts`.
* **Remote Hosts Lists Ingestion (`hosts_list_urls`)**: Automatic background downloading and parsing of external host lists and blocklists (AdAway, StevenBlack, custom blocklists).
* **Unified Cache (`combined.txt`)**: High-performance deduplication, merging, and global caching of multiple remote host sources into a single lightweight cache.
* **GitHub Mirror Failover**: Resilient downloads that automatically retry via mirrors (`cdn.jsdelivr.net`, `gh-proxy.com`, `ghproxy.net`) if direct access to github.com is blocked or throttled.
* **Hosts-Only Action Sections (`action = hosts`)**: Dedicated routing sections operating purely as DNS override engines without requiring an outbound proxy association.
* **Automated Subscription Updates**: Background fetching, parsing, and node rotation from remote subscription URLs with automated latency (RTT) testing and server groups (URL-Test, Failover).
* **🌐 Smart DNS & Failover Pipeline**:
* **FakeIP Pool (`198.18.0.0/15`)**: Near-instant connection establishment without waiting for remote DNS responses.
* **Modern DNS Protocol Support**: DoH (DNS over HTTPS), DoT (DNS over TLS), DoQ (DNS over QUIC), and DNS over HTTP/3.
* **Autonomous DNS Failover Daemon (`dns_failover.uc`)**: Continuous upstream health probing with seamless automatic fallback to secondary resolvers upon failure.
* **Anti-DNS Hijack**: Transparent kernel-level interception of UDP/TCP port 53 via nftables, preventing ISP spoofing.
* **Interactive DNS Benchmark (`tachyon dns_benchmark`)**: Measure response times and censorship resistance of popular public resolvers with auto-tuning (`dns_autotune`).
* **🌐 Hosts Sections & DNS Overrides (Hosts Engine)**:
* **Static DNS Overriding (`dns_hosts`)**: Direct mapping of domains to static IP addresses in sing-box DNS and dnsmasq without modifying `/etc/hosts`.
* **Remote Hosts Lists Ingestion (`hosts_list_urls`)**: Automatic background downloading and parsing of external host lists and blocklists (AdAway, StevenBlack, custom blocklists).
* **Unified Cache (`combined.txt`)**: High-performance deduplication, merging, and global caching of multiple remote host sources into a single lightweight cache.
* **GitHub Mirror Failover**: Resilient downloads that automatically retry via mirrors (`cdn.jsdelivr.net`, `gh-proxy.com`, `ghproxy.net`) if direct access to github.com is blocked or throttled.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🤖 2. AI Doctor & HTTP REST Agent API (AI Stack v2.5)
### 🚀 2. God-Tier DPI Bypass Strategy Generator & Fuzzer (DPI Fuzzer Engine)
* **Autonomous Combinatorial Fuzzing**: Built-in intelligent benchmarking engine accessible via LuCI Web UI and CLI (`tachyon fuzzer_start`), testing and optimizing desync strategies for **Zapret2 (`nfqws2`)**, **Zapret v1 (`nfqws`)**, and **ByeDPI (`ciadpi`)**.
* **PAWS TCP Timestamp Spoofing (`tcp_ts=-600000:tcp_ts_up`)**:
Innovative DPI desync technique utilizing stale TCP timestamps. Fake ClientHello packets are sent with timestamps shifted 10 minutes into the past: the destination web server silently drops them under RFC 7323 PAWS, while the middlebox/DPI desynchronizes and allows legitimate traffic through.
* **Authentic Binary Dumps (Blobs)**:
Native support for realistic ClientHello, QUIC, and STUN payloads (`tls_max`, `tls_google`, `tls_gosuslugi`, `tls_sber`, `tls_iana`, `tls_vk`, `quic_google`, `stun_fake`, `discord_udp`). The fuzzer automatically discovers payloads on the router and injects arguments into the daemon.
* **Exact Sequence Overlap (SeqOvl Pattern Overlap)**:
Byte-accurate sequence overlapping strategies (`seqovl=664:seqovl_pattern=tls_max`, `seqovl=681:seqovl_pattern=tls_google`) that glue allowed SNIs over target SNIs inside the DPI reassembly window.
* **TCP SYN Data Injection (`--lua-desync=syndata`) & Compressed Lua Scripts**:
Payload injection directly inside the TCP SYN handshake paired with `multidisorder` and `multisplit`, alongside automated decompression of `.lua.gz` scripts.
* **Massive Library of Validated Strategies**:
* **286+ combinatorial Zapret2 strategies** (YouTube 4K Kyber, GoogleVideo CDN streams, Discord Full-Stack voice + RTC UDP, Fakedsplit, Fakeddisorder, Hostfakesplit, and Low-TTL 3–8 matrix with `badseq`, `md5sig`, `badack`, `datanoack`).
* 130 strategies for Zapret v1 and 65 for ByeDPI.
* **Pre-configured Target Suites**: Ready-to-use benchmark suites for `youtube_suite`, `discord_suite`, `twitch_suite` (HLS Usher), `twitter_suite`, and `chatgpt_suite`.
* **Isolated Netfilter Queue (`0x00200000`)**: Test traffic is isolated into a dedicated Netfilter queue without interfering with standard home LAN routing or TProxy.
* **1-Click Strategy Application (`🏆 Best Match`)**: Instantly commit the winning strategy directly into UCI configuration with a single click.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🤖 3. AI Doctor, REST Agent API & MCP Server (AI Stack v2.5)
<div align="center">
@@ -89,12 +114,16 @@ Tachyon intercepts network flows via kernel **nftables** and dispatches requests
* **Tunnel MTU Optimization (`optimize_mtu`)**: Automatic MTU tuning for WireGuard / AmneziaWG tunnels.
* **🚨 Emergency Native Internet Fallback**:
* Instant 1-click restore of clean WAN internet via UI or `tachyon restore_native_internet` CLI command without rebooting the router.
* **🔌 Model Context Protocol (MCP) Server**:
* Built-in MCP standard implementation (`tachyon mcp`) over JSON-RPC 2.0 stdio: connect your router directly to Claude Desktop, Cursor, Antigravity, and autonomous AI agents as an executable network tool.
* **🌐 HTTP REST Agent API (OpenAPI 3.0)**:
* Full programmatic REST API (`/cgi-bin/tachyon-agent/`) for external monitoring, rule management, and orchestration.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 📱 3. Interactive Telegram Control Bot
### 📱 4. Interactive Telegram Control Bot
<div align="center">
@@ -102,18 +131,21 @@ Tachyon intercepts network flows via kernel **nftables** and dispatches requests
</div>
A feature-rich control center right inside your messenger:
A resilient, feature-rich control center right inside your messenger:
* **Live Rule Management**: View active routing lists and instantly add new domains or IP subnets on the fly.
* **Instant Toggle**: Enable or disable routing sections with a single button.
* **Server Selection & Latency**: Switch active proxy nodes with live RTT ping measurements.
* **Interactive Section Editor**: Enable, disable, and configure routing rules with inline keyboard actions.
* **Server Selection & Latency**: Switch active proxy nodes with live RTT ping measurements and 64-byte payload limit protection (`cb_data`).
* **Real-time Connection Monitor (`/connections`)**: Inspect active client connections with paginated views and an emergency session termination button (`/close_connections`).
* **Quiet Hours (`/qh`)**: Configure alert mute windows to suppress notifications during nighttime hours.
* **Device Access Control**: View active DHCP clients and block/unblock internet access by MAC address.
* **Diagnostics & Commands**: `/doctor`, `/ai_doctor`, `/fix <code_name>`, `/restart`, `/backup`, `/status`.
* **Resilient Dual Transport**: Automatic fallback to direct WAN if proxy route stalls, segregated curl timeouts (12s commands / 35s polling), and HTML tag auto-closing.
* **Diagnostics & Commands**: `/doctor`, `/ai_doctor`, `/heal`, `/speed`, `/ping`, `/test`, `/logs`, `/info`, `/export_config`, `/restart`, `/lang`.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🛡️ 4. Watchdog — Protection & Self-Healing System
### 🛡️ 5. Watchdog — Protection, Self-Healing & Snapshots
<div align="center">
@@ -126,13 +158,26 @@ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds witho
* **Restart-Loop Protection**: Maximum 3 restarts per 10 minutes (`safe_proxy_restart()`), `PROXY_RESTART_LOCK` mutex, and DNS query loop cooldowns.
* **Memory Optimization (OOM Watchdog)**: Dynamic `GOMEMLIMIT` adjustment under memory pressure with automated Telegram alerts.
* **Seamless Hot-Reload**: Rule updates and server switches apply softly without dropping active TCP connections (Discord calls, gaming, and downloads remain uninterrupted).
* **Configuration Snapshots & Rollback**: Create named snapshots (`snapshot_save <name>`), list them, and safely roll back in case of error (`snapshot_restore <file>`).
* **WAN & Gateway Recovery**: Active interface monitoring and automated route recovery during ISP outages.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🖥️ 5. Modern Web Interface (LuCI - TypeScript)
### 👶 6. Parental Controls, Quotas & Smart QoS
* **Per-Device Access Scheduling**: Define allowed internet hours and days of the week individually for each smartphone, tablet, or Smart TV.
* **Bandwidth & Data Quotas**: Enforce ingress and egress volume caps per device with automated cron-based quota resets (`parental_quota.uc`).
* **Smart QoS & Priority Daemon**:
* DSCP packet classification in nftables prioritizing latency-sensitive traffic (VoIP, Discord, Zoom, gaming).
* Elimination of bufferbloat under saturated connection speeds during heavy torrenting or game downloads.
* **Instant Device Isolation**: 1-click internet disable/enable for any LAN client from LuCI or Telegram.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🖥️ 7. Modern LuCI Web Interface (TypeScript)
<div align="center">
@@ -141,10 +186,11 @@ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds witho
</div>
* Native integration into OpenWrt's LuCI dashboard.
* **Interactive Dashboard**: Real-time latency tracking, subscription manager, rule editor, and service controls in a few clicks.
* **Interactive Dashboard**: Real-time latency tracking, subscription manager, rule editor, client manager, and component controls.
* **Embedded Strategy Fuzzer Modal**: Real-time progress bar, green endpoint status badges (`HTTP 204` / `HTTP 200`), target availability indicator (`3/3 endpoints OK`), and `🏆 Best Match` detection.
* **Streaming Terminal Modal**: Real-time console logs for component installations and updates without UI freezes.
* **Dynamic Repository Links**: Component cards link directly to the installed variant's GitHub repository (extended, lx, stable).
* **Commit-Level Update Tracking**: Alerts for newer commits within the same release tag.
* **Dynamic Repository Links**: Component cards link directly to the installed variant's GitHub repository (extended, tiny, lx, stable).
* **Commit-Level Update Tracking**: Alerts for newer commits within the same release tag with safe version rollback support (`component_rollback`).
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
@@ -159,22 +205,56 @@ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds witho
</div>
```bash
# === DPI Strategy Fuzzer & Benchmarks ===
tachyon fuzzer_start youtube_suite zapret2 # Start YouTube bypass benchmark on Zapret2
tachyon fuzzer_start discord_suite zapret2 # Start Discord benchmark (voice + UDP RTC)
tachyon fuzzer_status # Current fuzzer progress & results (JSON)
tachyon fuzzer_stop # Immediately terminate fuzzer & clean Netfilter
tachyon fuzzer_apply <strategy_id> # Apply winning strategy to UCI configuration
# === DNS Testing & Network Stack ===
tachyon dns_benchmark # Benchmark latency & reachability of DNS resolvers
tachyon dns_autotune --apply # Auto-select and apply the fastest DNS resolver
tachyon test_rule google.com # Test which routing section matches a domain/IP
# === System & Offline Diagnostics ===
tachyon doctor # Run local diagnostics without LLM
tachyon ai_doctor # Run AI Doctor analysis (with LLM)
tachyon ai_doctor_last # View last saved AI report
tachyon apply_quick_fix clear_dns_cache # Apply specific quick fix code
tachyon diagnose_json # Output full diagnostic JSON
tachyon doctor # Run local diagnostics without LLM
tachyon ai_doctor # Run AI Doctor analysis (with LLM)
tachyon ai_doctor_last # View last saved AI report
tachyon apply_quick_fix clear_dns_cache # Apply specific quick fix code
tachyon diagnose_json # Output full diagnostic state snapshot (JSON)
# === Emergency Internet Fallback ===
tachyon restore_native_internet # Stop proxy and cleanly restore pure WAN internet
tachyon restore_native_internet # Stop proxy and cleanly restore pure WAN internet
# === Telegram Bot Management ===
tachyon telegram_status # Check Telegram bot daemon running state
tachyon telegram_diagnose # Run 8-step Telegram connection diagnostics (JSON)
tachyon telegram_start # Start Telegram bot worker
tachyon telegram_stop # Stop Telegram bot worker
# === Snapshots & Backups ===
tachyon snapshot_list # List saved configuration snapshots
tachyon snapshot_save my_working_setup # Create a named configuration snapshot
tachyon snapshot_restore /etc/config/snap.json # Restore configuration from snapshot
tachyon backup # Create full configuration backup archive
# === Rule Lists & Subscriptions ===
tachyon list_update # Force update remote domain and IP lists
tachyon subscription_update # Update all proxy subscriptions
tachyon hosts_list_update # Download and update remote Hosts blocklists
# === Service Management & Watchdog ===
tachyon ai_heal # Trigger manual self-healing cycle
tachyon ai_status # View concise Watchdog status
tachyon ai_status_full # View full Watchdog metrics
tachyon ai_heal # Trigger manual self-healing cycle
tachyon ai_status # View concise Watchdog status
tachyon ai_status_full # View full Watchdog metrics (JSON)
# === HTTP REST API Checks ===
# === Profile Generators ===
tachyon generate_warp # Generate Cloudflare WARP WireGuard configuration
tachyon generate_reality_keypair # Generate public/private keypair for VLESS Reality
# === AI Integration (MCP & HTTP REST API) ===
tachyon mcp # Start Model Context Protocol server (stdio)
curl http://192.168.1.1/cgi-bin/tachyon-agent/health
curl http://192.168.1.1/cgi-bin/tachyon-agent/openapi.json
```
README.md
+123 -43
View File
@@ -18,9 +18,9 @@
## ⚡ О проекте
**Tachyon** — это высокопроизводительное, автономное и современное решение для оркестрации сетевого трафика, проксирования и обхода цензуры на роутерах под управлением **OpenWrt** (полная совместимость с **OpenWrt 23.05, 24.10, 25.x и SNAPSHOT**). Прямой форк проекта **[Forkop от @ushan0v](https://github.com/ushan0v/forkop)** (ранее **Podkop Plus**).
**Tachyon** — это высокопроизводительное, автономное и бескомпромиссное решение для оркестрации сетевого трафика, проксирования и обхода цензуры на роутерах под управлением **OpenWrt** (полная совместимость с **OpenWrt 23.05, 24.10, 25.x и SNAPSHOT**). Прямой форк проекта **[Forkop от @ushan0v](https://github.com/ushan0v/forkop)** (ранее **Podkop Plus**).
Tachyon объединяет ядро **sing-box**, средства локального аппаратного обхода DPI (**Zapret v1 / Zapret v2 / ByeDPI**), интерактивного **Telegram-бота**, а также инновационный **AI Stack** (автономный **AI Doctor v2.5** с офлайн-диагностикой и **HTTP REST Agent API / OpenAPI 3.0**).
Tachyon объединяет ядро **sing-box**, средства локального аппаратного обхода DPI (**Zapret v1 / Zapret v2 / ByeDPI**), интерактивный комбинаторный **DPI Strategy Fuzzer**, защищённый **Telegram-бот управления**, а также инновационный **AI Stack** (автономный **AI Doctor v2.5**, офлайн-диагностику, **HTTP REST Agent API / OpenAPI 3.0** и **MCP Server** для подключения ИИ-агентов).
Вся внутренняя логика реализована на скриптовом движке **ucode** — нативном C-интерпретаторе OpenWrt, обеспечивающем ультранизкое потребление RAM (от 128 МБ ОЗУ) и мгновенный отклик.
@@ -39,9 +39,10 @@ Tachyon объединяет ядро **sing-box**, средства локал
Tachyon перехватывает сетевой стек через ядро **nftables** и распределяет запросы без лишних задержек:
1. **Прямой трафик (Direct WAN)**: Отечественные сервисы, банки, Госуслуги и доверенные ресурсы идут без прокси с нулевой задержкой (`0 ms overhead`).
2. **Zapret v1 (`nfqws`)**: Базовая десинхронизация TCP/UDP (`fake`, `disorder`, `split2`) прямо на роутере без VPS.
3. **Zapret v2 (`nfqws2`)**: Адаптивный многовекторный обход ТСПУ (`multisplit`, `seqovl`, `wsize`) для YouTube 4K и Discord.
3. **Zapret v2 (`nfqws2`)**: Адаптивный многовекторный обход ТСПУ (`multisplit`, `seqovl`, `wsize`, PAWS `tcp_ts`, аутентичные `blobs`) для YouTube 4K, Discord и стриминга.
4. **ByeDPI (`ciadpi`)**: Локальный SOCKS5-десинхронизатор с фрагментацией полезной нагрузки HTTP/TLS SNI.
5. **Зашифрованный прокси-туннель (sing-box)**: Заблокированные ресурсы и приватный трафик направляются через защищённые протоколы (VLESS Reality, Hysteria2, WireGuard).
5. **Зашифрованный прокси-туннель (sing-box)**: Заблокированные ресурсы и приватный трафик направляются через защищённые протоколы (VLESS Reality, Hysteria2, WireGuard, AmneziaWG).
6. **Smart DNS Pipeline**: Изолированная обработка DNS через FakeIP (`198.18.0.0/15`), DoH/DoT/DoQ с защитой от перехвата провайдером и автоматическим отказоустойчивым переключением (DNS Failover).
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
@@ -49,28 +50,52 @@ Tachyon перехватывает сетевой стек через ядро *
## 🔥 Главные возможности и подсистемы
### 🛡️ 1. Мультипротокольное проксирование и локальный обход DPI
### 🛡️ 1. Мультипротокольное проксирование и умный DNS-стек
* **Ядро sing-box Engine (v1.11+)**: Нативная поддержка современных защищённых протоколов — **VLESS (Reality / gRPC / WS)**, **VMess**, **Shadowsocks**, **Trojan**, **Hysteria2**, **WireGuard / AmneziaWG**.
* **Локальный обход DPI без внешних VPS**:
* Встроенная интеграция с движками **Zapret v1 (`nfqws`)**, **Zapret v2 (`nfqws2`)** и **ByeDPI (`ciadpi`)** для аппаратной десинхронизации TCP-сегментов.
* **Генератор профилей Cloudflare WARP / AmneziaWG (`generate_warp`)**: Быстрое создание готовых конфигураций WireGuard и AmneziaWG прямо на роутере без сторонних скриптов.
* **Многомерная селективная маршрутизация**:
* **По доменам и IP-сетям**: Направляйте через прокси или десинк только целевой трафик.
* **По клиентским устройствам (MAC / IP)**: Раздельные правила для Smart TV, смартфонов, ПК и консолей.
* **По клиентским устройствам (MAC / IP)**: Индивидуальные правила для Smart TV, смартфонов, ПК и консолей.
* **По GeoIP и странам**: Гибкие списки включения/исключения по странам назначения.
* **Автоматические подписки**: Фоновая загрузка, распарсинг и обновление прокси-нод по подписочным URL с авто-тестированием RTT задержки.
#### 🌐 Секции Hosts и Списки DNS-блокировок (Hosts Engine)
* **Статический DNS-Overriding (`dns_hosts`)**: Прямое переопределение IP-адресов для доменов в DNS-модуле sing-box и dnsmasq без необходимости подмены `/etc/hosts`.
* **Загрузка сторонних списков Hosts (`hosts_list_urls`)**: Автоматическая фоновая загрузка и интеграция внешних реестров и списков блокировок (AdAway, StevenBlack, РКН/Антизапрет списки).
* **Умный кэш (`combined.txt`)**: Автоматическое слияние, очистка и единое кэширование нескольких источников списков с поддержкой мгновенного переиспользования.
* **Резервирование через зеркала (GitHub Mirror Retry)**: При сетевых блокировках github.com модули загрузки автоматически переключаются на зеркала (`cdn.jsdelivr.net`, `gh-proxy.com`, `ghproxy.net`).
* **Секции чистого Hosts (`action = hosts`)**: Создание изолированных правил перенаправления DNS без обязательной привязки к прокси-нодам.
* **Автоматические подписки**: Фоновая загрузка, распарсинг и обновление прокси-нод по подписочным URL с авто-тестированием RTT задержки и группами серверов (URL-Test, Failover).
* **🌐 Умный сетевой стек DNS и Failover**:
* **FakeIP-пул (`198.18.0.0/15`)**: Мгновенное установление соединений без предварительного ожидания ответа удалённого DNS.
* **Поддержка современных протоколов DNS**: DoH (DNS over HTTPS), DoT (DNS over TLS), DoQ (DNS over QUIC) и DNS over HTTP/3.
* **Автономный DNS Failover демон (`dns_failover.uc`)**: Непрерывный мониторинг апстримов и мгновенное бесшовное переключение на резервные резолверы при сбоях.
* **Анти-перехват DNS**: Прозрачный перехват портов 53 UDP/TCP в ядре nftables, исключающий перехват запросов провайдерами.
* **Интерактивный DNS Benchmark (`tachyon dns_benchmark`)**: Тестирование скорости и доступности популярных DNS-серверов с функцией автотюнинга (`dns_autotune`).
* **🌐 Секции Hosts и Списки DNS-блокировок (Hosts Engine)**:
* **Статический DNS-Overriding (`dns_hosts`)**: Прямое переопределение IP для доменов в DNS-модуле sing-box и dnsmasq без правки `/etc/hosts`.
* **Загрузка сторонних списков Hosts (`hosts_list_urls`)**: Авто-загрузка и парсинг реестров блокировок (AdAway, StevenBlack, списки Антизапрет).
* **Умный кэш (`combined.txt`)**: Дедупликация, слияние и кэширование внешних источников списков.
* **Резервирование через зеркала (GitHub Mirror Retry)**: Автопереключение на зеркала (`cdn.jsdelivr.net`, `gh-proxy.com`, `ghproxy.net`) при блокировках GitHub.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🤖 2. ИИ-Доктор и HTTP REST Agent API (AI Stack v2.5)
### 🚀 2. God-Tier Генератор и Фаззер стратегий обхода ТСПУ (DPI Fuzzer Engine)
* **Автономный комбинаторный фаззинг**: Встроенный интеллектуальный фаззер прямо в веб-интерфейсе LuCI и CLI (`tachyon fuzzer_start`), тестирующий и подбирающий оптимальные параметры десинхронизации для **Zapret2 (`nfqws2`)**, **Zapret v1 (`nfqws`)** и **ByeDPI (`ciadpi`)**.
* **PAWS TCP Timestamp Spoofing (`tcp_ts=-600000:tcp_ts_up`)**:
Инновационная техника десинхронизации ТСПУ через устаревшие временные метки TCP. Фейковые ClientHello отправляются с timestamp, сдвинутым на 10 минут назад: конечный сервер отбрасывает их согласно RFC 7323 PAWS, а ТСПУ десинхронизируется и пропускает целевой трафик.
* **Аутентичные бинарные дампы (Blobs)**:
Встроенная поддержка дампов ClientHello, QUIC и STUN (`tls_max`, `tls_google`, `tls_gosuslugi`, `tls_sber`, `tls_iana`, `tls_vk`, `quic_google`, `stun_fake`, `discord_udp`). Фаззер автоматически находит нужные блобы на роутере и пробрасывает параметры в демон.
* **Точное перекрытие последовательностей (SeqOvl Pattern Overlap)**:
Стратегии с байтовым перекрытием (`seqovl=664:seqovl_pattern=tls_max`, `seqovl=681:seqovl_pattern=tls_google`), склеивающие доверенный SNI поверх блокируемого в reassembly-буфере ТСПУ.
* **TCP SYN Data (`--lua-desync=syndata`) и сжатые Lua-скрипты**:
Инъекция полезной нагрузки в TCP SYN-пакет в связке с `multidisorder` и `multisplit`, а также автозагрузка сценариев `.lua.gz`.
* **Огромная база валидированных стратегий**:
* **286+ комбинаторных стратегий Zapret2** (включая YouTube 4K Kyber, GoogleVideo CDN стримы, Discord Voice + RTC UDP, Fakedsplit, Fakeddisorder, Hostfakesplit и матрицу Low-TTL 3–8 с методами `badseq`, `md5sig`, `badack`, `datanoack`).
* 130 стратегий для Zapret v1 и 65 для ByeDPI.
* **Таргет-сьюты сервисов**: Готовые профили проверок для `youtube_suite`, `discord_suite`, `twitch_suite` (HLS Usher), `twitter_suite`, `chatgpt_suite`.
* **Изолированная очередь в nftables (`0x00200000`)**: Фаззер тестирует стратегии через прямую выделенную очередь Netfilter без влияния на обычный трафик домашней сети и TProxy.
* **Применение в 1 клик (`🏆 Best Match`)**: Возможность сразу применить найденную лучшую стратегию в конфигурацию UCI роутера.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🤖 3. ИИ-Доктор, REST Agent API и MCP Server (AI Stack v2.5)
<div align="center">
@@ -88,13 +113,17 @@ Tachyon перехватывает сетевой стек через ядро *
* **DNS Dead-lock Repair (`fix_bootstrap_dns`)**: Предотвращение циклических блокировок первичных DNS sing-box.
* **Оптимизация MTU туннелей (`optimize_mtu`)**: Расчёт оптимального размера пакета для AWG/WireGuard.
* **🚨 Аварийное восстановление интернета (Native Internet Fallback)**:
* Мгновенный возврат обычного интернета одной кнопкой в UI или командой `tachyon restore_native_internet`. Полная чистая остановка прокси и сброс nftables/ip rule без перезагрузки роутера.
* Мгновенный возврат чистого интернета одной кнопкой в UI или командой `tachyon restore_native_internet`. Полная чистая остановка прокси и сброс правил nftables/ip rule без перезагрузки роутера.
* **🔌 Model Context Protocol (MCP) Server**:
* Встроенная поддержка стандарта MCP (`tachyon mcp`) через JSON-RPC 2.0 stdio: прямое подключение роутера к Claude Desktop, Cursor, Antigravity и внешним ИИ-агентам в качестве сетевого инструмента.
* **🌐 HTTP REST Agent API (OpenAPI 3.0)**:
* Полноценный программный REST API (`/cgi-bin/tachyon-agent/`) для мониторинга, управления правилами и автоматизации.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 📱 3. Интерактивный Telegram-бот управления
### 📱 4. Интерактивный Telegram-бот управления
<div align="center">
@@ -102,18 +131,21 @@ Tachyon перехватывает сетевой стек через ядро *
</div>
Полноценный пульт управления роутером из мессенджера:
* **Управление правилами «на лету»**: Просмотр списков обхода и добавление новых доменов или IP-сетей.
* **Мгновенный контроль секций**: Включение и отключение маршрутов одной кнопкой.
* **Переключение серверов**: Выбор активных прокси-нод с автоматическим замером задержки (RTT ping).
Полноценный, отказоустойчивый пульт управления роутером прямо из мессенджера:
* **Управление правилами «на лету»**: Просмотр списков обхода и моментальное добавление новых доменов или IP-сетей.
* **Интерактивный редактор секций**: Включение, выключение и детальная настройка правил маршрутизации.
* **Переключение серверов**: Выбор активных прокси-нод с автоматическим замером задержки (RTT ping) и защитой от переполнения кнопок (токены `cb_data`).
* **Мониторинг соединений в реальном времени (`/connections`)**: Просмотр активных клиентских сессий с пагинацией и кнопкой экстренного закрытия всех соединений (`/close_connections`).
* **Тихие часы (`/qh`)**: Настройка периодов тишины без ночных оповещений.
* **Управление устройствами LAN**: Просмотр активных клиентов и блокировка/разблокировка доступа по MAC-адресам.
* **Диагностика и Команды**: `/doctor`, `/ai_doctor`, `/fix <код>`, `/restart`, `/backup`, `/status`.
* **Отказоустойчивый транспорт**: Автоматический фоллбек на прямой WAN при сбоях прокси, раздельные таймауты `curl` (12с для команд / 35с для long-polling) и защита от сбоев парсинга HTML-разметки.
* **Диагностика и Команды**: `/doctor`, `/ai_doctor`, `/heal`, `/speed`, `/ping`, `/test`, `/logs`, `/info`, `/export_config`, `/restart`, `/lang`.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🛡️ 4. Watchdog — Защита и Самовосстановление
### 🛡️ 5. Watchdog — Защита, Самовосстановление и Снапшоты
<div align="center">
@@ -121,18 +153,31 @@ Tachyon перехватывает сетевой стек через ядро *
</div>
Watchdog — сердце стабильности Tachyon. Работает каждые 5–15 секунд без внешних зависимостей:
* **Атомарные записи и UCI-бэкапы**: Запись конфигураций через `tmp` + `mv` предотвращает повреждение файлов при аварийном выключении питания.
Watchdog — сердце стабильности Tachyon, работающее каждые 5–15 секунд без внешних зависимостей:
* **Атомарные записи и UCI-бэкапы**: Запись конфигураций через паттерн `tmp` + `mv` предотвращает повреждение файлов при внезапном выключении питания роутера.
* **Защита от зацикливания перезапусков (Restart-Loop Prevention)**: Лимит не более 3 перезапусков за 10 минут (`safe_proxy_restart()`), мьютекс `PROXY_RESTART_LOCK` и кулдаун DNS-петель.
* **Оптимизация памяти (OOM Watchdog)**: Динамическая регулировка `GOMEMLIMIT` при нехватке ОЗУ с отправкой уведомлений в Telegram.
* **Оптимизация памяти (OOM Watchdog)**: Динамическая регулировка `GOMEMLIMIT` при нехватке ОЗУ с отправкой предупреждений в Telegram.
* **Мягкая перезагрузка (Hot-Reload)**: Смена серверов и правил без разрыва активных TCP-соединений (Discord, онлайн-игры и стримы не прерываются).
* **Снапшоты конфигурации (Snapshots & Rollback)**: Мгновенное создание снимков состояния (`snapshot_save <name>`), их просмотр и откат в случае ошибок (`snapshot_restore <file>`).
* **Восстановление WAN и шлюзов**: Мониторинг сетевых интерфейсов и авто-поднятие при сбоях провайдера.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🖥️ 5. Современный Web-интерфейс LuCI (TypeScript)
### 👶 6. Родительский контроль, квоты и Smart QoS
* **Поустройственные ограничения**: Установка расписания интернет-доступа (по часам и дням недели) индивидуально для каждого смартфона, планшета или ТВ.
* **Квотирование трафика**: Задание лимитов входящего и исходящего трафика на клиентские устройства с автоматическим сбросом по cron (`parental_quota.uc`).
* **Smart QoS & Priority Daemon**:
* Маркировка пакетов DSCP в ядре nftables для приоритизации критичного трафика (голос, Discord, Zoom, онлайн-игры).
* Предотвращение задержек и раздувания очередей (Bufferbloat) при максимальной загрузке интернет-канала торрентами или обновлениями.
* **Мгновенная изоляция**: Блокировка и разблокировка доступа в интернет для любого устройства в один клик из LuCI или Telegram.
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
</p>
### 🖥️ 7. Современный Web-интерфейс LuCI (TypeScript)
<div align="center">
@@ -141,10 +186,11 @@ Watchdog — сердце стабильности Tachyon. Работает к
</div>
* Полная интеграция в штатный Web-интерфейс OpenWrt.
* **Интерактивный дашборд**: Графика задержек, управление подписками, правилами и компонентами в несколько кликов.
* **Потоковый терминал установки**: Живой вывод логов процессов установки и обновлений компонентов без зависаний.
* **Динамические ссылки на репозитории**: Карточки компонентов ведут прямо на GitHub установленного варианта (extended, lx, stable).
* **Commit-level отслеживание обновлений**: Оповещения о свежих коммитах в рамках текущего релиза.
* **Интерактивный дашборд**: Графика задержек, управление подписками, правилами, клиентами и компонентами в несколько кликов.
* **Встроенный модал Фаззера стратегий**: Интерактивный запуск бенчмарков с прогресс-баром, зелёными бейджами успешности (`HTTP 204` / `HTTP 200`), индикацией рабочих эндпоинтов (`3/3 endpoints OK`) и выбором `🏆 Best Match`.
* **Потоковый терминал установки**: Живой вывод логов процессов установки и обновлений компонентов без зависаний страницы.
* **Динамические ссылки на репозитории**: Карточки компонентов ведут прямо на GitHub установленного варианта (extended, tiny, lx, stable).
* **Commit-level отслеживание обновлений**: Оповещения о свежих коммитах в рамках текущего релиза и безопасный откат версий (`component_rollback`).
<p align="center">
<img src="assets/readme/divider_stream.svg" width="100%" alt="divider" />
@@ -159,22 +205,56 @@ Watchdog — сердце стабильности Tachyon. Работает к
</div>
```bash
# === Фаззер и тестирование стратегий обхода DPI ===
tachyon fuzzer_start youtube_suite zapret2 # Запуск бенчмарка для YouTube на Zapret2
tachyon fuzzer_start discord_suite zapret2 # Запуск бенчмарка для Discord (голос + UDP)
tachyon fuzzer_status # Текущий прогресс и результаты фаззера (JSON)
tachyon fuzzer_stop # Немедленная остановка фаззера и очистка Netfilter
tachyon fuzzer_apply <strategy_id> # Применение найденной стратегии в конфигурацию UCI
# === Тестирование DNS и Сетевой стек ===
tachyon dns_benchmark # Замер задержки и доступности DNS-резолверов
tachyon dns_autotune --apply # Автоматический выбор и применение лучшего DNS
tachyon test_rule google.com # Проверка, под какое правило маршрутизации попадает домен
# === Системная и офлайн-диагностика ===
tachyon doctor # Запуск локальной диагностики без LLM
tachyon ai_doctor # Запуск анализа AI Doctor (с LLM)
tachyon ai_doctor_last # Просмотр последнего сохранённого отчёта ИИ
tachyon apply_quick_fix clear_dns_cache # Применение выбранного кода исправления
tachyon diagnose_json # Вывод полного снимка в формате JSON
tachyon doctor # Запуск локальной диагностики без LLM
tachyon ai_doctor # Запуск анализа AI Doctor (с LLM)
tachyon ai_doctor_last # Просмотр последнего сохранённого отчёта ИИ
tachyon apply_quick_fix clear_dns_cache # Применение выбранного кода исправления
tachyon diagnose_json # Вывод полного снимка состояния в формате JSON
# === Аварийное восстановление интернета ===
tachyon restore_native_internet # Мгновенная остановка прокси и возврат чистого WAN
tachyon restore_native_internet # Мгновенная остановка прокси и возврат чистого WAN
# === Управление Telegram-ботом ===
tachyon telegram_status # Проверка статуса демона Telegram-бота
tachyon telegram_diagnose # 8-этапная диагностика подключения бота (JSON)
tachyon telegram_start # Запуск воркера Telegram-бота
tachyon telegram_stop # Остановка воркера Telegram-бота
# === Снапшоты и резервные копии ===
tachyon snapshot_list # Список сохранённых снимков конфигурации
tachyon snapshot_save my_working_setup # Создание именованного снапшота
tachyon snapshot_restore /etc/config/snap.json # Восстановление конфигурации из снимка
tachyon backup # Создание полного архива конфигурации
# === Обновление списков и подписок ===
tachyon list_update # Принудительное обновление списков доменов/IP
tachyon subscription_update # Обновление всех прокси-подписок
tachyon hosts_list_update # Загрузка и обновление сторонних Hosts-листов
# === Управление службами и Watchdog ===
tachyon ai_heal # Принудительный цикл самовосстановления
tachyon ai_status # Краткий статус Watchdog
tachyon ai_status_full # Расширенные метрики Watchdog
tachyon ai_heal # Принудительный цикл самовосстановления
tachyon ai_status # Краткий статус Watchdog
tachyon ai_status_full # Расширенные метрики Watchdog (JSON)
# === Проверка HTTP REST API ===
# === Генераторы профилей ===
tachyon generate_warp # Генерация конфигурации Cloudflare WARP
tachyon generate_reality_keypair # Генерация пары ключей для VLESS Reality
# === Интеграция с ИИ (MCP & HTTP REST API) ===
tachyon mcp # Запуск Model Context Protocol сервера (stdio)
curl http://192.168.1.1/cgi-bin/tachyon-agent/health
curl http://192.168.1.1/cgi-bin/tachyon-agent/openapi.json
```