diff --git a/README.en.md b/README.en.md index 4e546a7d..1f155fcd 100644 --- a/README.en.md +++ b/README.en.md @@ -88,15 +88,19 @@ 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. -* **🌐 HTTP REST Agent API & OpenAPI 3.0 (Swagger)**: - * Full-featured API at `/cgi-bin/tachyon-agent/` with granular Bearer token security (`agent_api_token`). - * Native **OpenAPI 3.0.3** spec (`GET /cgi-bin/tachyon-agent/openapi.json`) for seamless integration with **ChatGPT Custom GPTs**, N8N, Dify, Flowise, and autonomous LLM agents (Cursor, AutoGPT, Claude Code).

divider

### πŸ“± 3. Interactive Telegram Control Bot + +
+ +![Telegram Bot Showcase](assets/readme/telegram_bot_showcase.svg) + +
+ A 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. @@ -109,6 +113,13 @@ A feature-rich control center right inside your messenger:

### πŸ›‘οΈ 4. Watchdog β€” Protection & Self-Healing System + +
+ +![Watchdog Showcase](assets/readme/watchdog_showcase.svg) + +
+ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds without external dependencies: * **Atomic Operations & UCI Backups**: Configuration writes via `tmp` + `mv` prevent file corruption during sudden power losses. * **Restart-Loop Protection**: Maximum 3 restarts per 10 minutes (`safe_proxy_restart()`), `PROXY_RESTART_LOCK` mutex, and DNS query loop cooldowns. @@ -121,6 +132,13 @@ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds witho

### πŸ–₯️ 5. Modern Web Interface (LuCI - TypeScript) + +
+ +![LuCI Web UI Showcase](assets/readme/luci_web_showcase.svg) + +
+ * Native integration into OpenWrt's LuCI dashboard. * **Interactive Dashboard**: Real-time latency tracking, subscription manager, rule editor, and service controls in a few clicks. * **Streaming Terminal Modal**: Real-time console logs for component installations and updates without UI freezes. @@ -131,7 +149,13 @@ Watchdog is the heart of Tachyon's stability, running every 5–15 seconds witho divider

-## πŸ› οΈ CLI & API Quick Reference +## πŸ› οΈ CLI & REST Agent API Reference + +
+ +![CLI & API Showcase](assets/readme/cli_showcase.svg) + +
```bash # === System & Offline Diagnostics === @@ -206,6 +230,6 @@ If Tachyon powers your daily networking and keeps your connection fast and secur
-Made with ❀️ for OpenWrt Community +![Tachyon Community Footer](assets/readme/footer_tachyon.svg)
diff --git a/README.md b/README.md index 4b0f0332..87c50e72 100644 --- a/README.md +++ b/README.md @@ -88,15 +88,19 @@ Tachyon ΠΏΠ΅Ρ€Π΅Ρ…Π²Π°Ρ‚Ρ‹Π²Π°Π΅Ρ‚ сСтСвой стСк Ρ‡Π΅Ρ€Π΅Π· ядро * * **ΠžΠΏΡ‚ΠΈΠΌΠΈΠ·Π°Ρ†ΠΈΡ MTU Ρ‚ΡƒΠ½Π½Π΅Π»Π΅ΠΉ (`optimize_mtu`)**: Расчёт ΠΎΠΏΡ‚ΠΈΠΌΠ°Π»ΡŒΠ½ΠΎΠ³ΠΎ Ρ€Π°Π·ΠΌΠ΅Ρ€Π° ΠΏΠ°ΠΊΠ΅Ρ‚Π° для AWG/WireGuard. * **🚨 АварийноС восстановлСниС ΠΈΠ½Ρ‚Π΅Ρ€Π½Π΅Ρ‚Π° (Native Internet Fallback)**: * ΠœΠ³Π½ΠΎΠ²Π΅Π½Π½Ρ‹ΠΉ Π²ΠΎΠ·Π²Ρ€Π°Ρ‚ ΠΎΠ±Ρ‹Ρ‡Π½ΠΎΠ³ΠΎ ΠΈΠ½Ρ‚Π΅Ρ€Π½Π΅Ρ‚Π° ΠΎΠ΄Π½ΠΎΠΉ ΠΊΠ½ΠΎΠΏΠΊΠΎΠΉ Π² UI ΠΈΠ»ΠΈ ΠΊΠΎΠΌΠ°Π½Π΄ΠΎΠΉ `tachyon restore_native_internet`. Полная чистая остановка прокси ΠΈ сброс nftables/ip rule Π±Π΅Π· ΠΏΠ΅Ρ€Π΅Π·Π°Π³Ρ€ΡƒΠ·ΠΊΠΈ Ρ€ΠΎΡƒΡ‚Π΅Ρ€Π°. -* **🌐 HTTP REST Agent API & OpenAPI 3.0 (Swagger)**: - * БСзопасный REST API ΠΏΠΎ адрСсу `/cgi-bin/tachyon-agent/` с Π°Π²Ρ‚ΠΎΡ€ΠΈΠ·Π°Ρ†ΠΈΠ΅ΠΉ Bearer-Ρ‚ΠΎΠΊΠ΅Π½ΠΎΠΌ (`agent_api_token`). - * БпСцификация **OpenAPI 3.0.3** (`GET /cgi-bin/tachyon-agent/openapi.json`) для ΠΌΠ³Π½ΠΎΠ²Π΅Π½Π½ΠΎΠ³ΠΎ ΠΏΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΡ ΠΊ **ChatGPT Custom GPTs**, N8N, Dify, Flowise ΠΈ Π°Π²Ρ‚ΠΎΠ½ΠΎΠΌΠ½Ρ‹ΠΌ ИИ-Π°Π³Π΅Π½Ρ‚Π°ΠΌ (Cursor, AutoGPT, Claude Code).

divider

### πŸ“± 3. Π˜Π½Ρ‚Π΅Ρ€Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹ΠΉ Telegram-Π±ΠΎΡ‚ управлСния + +
+ +![Telegram Bot Showcase](assets/readme/telegram_bot_showcase.svg) + +
+ ΠŸΠΎΠ»Π½ΠΎΡ†Π΅Π½Π½Ρ‹ΠΉ ΠΏΡƒΠ»ΡŒΡ‚ управлСния Ρ€ΠΎΡƒΡ‚Π΅Ρ€ΠΎΠΌ ΠΈΠ· мСссСндТСра: * **Π£ΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ ΠΏΡ€Π°Π²ΠΈΠ»Π°ΠΌΠΈ Β«Π½Π° Π»Π΅Ρ‚ΡƒΒ»**: ΠŸΡ€ΠΎΡΠΌΠΎΡ‚Ρ€ списков ΠΎΠ±Ρ…ΠΎΠ΄Π° ΠΈ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅ Π½ΠΎΠ²Ρ‹Ρ… Π΄ΠΎΠΌΠ΅Π½ΠΎΠ² ΠΈΠ»ΠΈ IP-сСтСй. * **ΠœΠ³Π½ΠΎΠ²Π΅Π½Π½Ρ‹ΠΉ ΠΊΠΎΠ½Ρ‚Ρ€ΠΎΠ»ΡŒ сСкций**: Π’ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ ΠΈ ΠΎΡ‚ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ ΠΌΠ°Ρ€ΡˆΡ€ΡƒΡ‚ΠΎΠ² ΠΎΠ΄Π½ΠΎΠΉ ΠΊΠ½ΠΎΠΏΠΊΠΎΠΉ. @@ -109,6 +113,13 @@ Tachyon ΠΏΠ΅Ρ€Π΅Ρ…Π²Π°Ρ‚Ρ‹Π²Π°Π΅Ρ‚ сСтСвой стСк Ρ‡Π΅Ρ€Π΅Π· ядро *

### πŸ›‘οΈ 4. Watchdog β€” Π—Π°Ρ‰ΠΈΡ‚Π° ΠΈ БамовосстановлСниС + +
+ +![Watchdog Showcase](assets/readme/watchdog_showcase.svg) + +
+ Watchdog β€” сСрдцС ΡΡ‚Π°Π±ΠΈΠ»ΡŒΠ½ΠΎΡΡ‚ΠΈ Tachyon. Π Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ ΠΊΠ°ΠΆΠ΄Ρ‹Π΅ 5–15 сСкунд Π±Π΅Π· Π²Π½Π΅ΡˆΠ½ΠΈΡ… зависимостСй: * **АтомарныС записи ΠΈ UCI-бэкапы**: Π—Π°ΠΏΠΈΡΡŒ ΠΊΠΎΠ½Ρ„ΠΈΠ³ΡƒΡ€Π°Ρ†ΠΈΠΉ Ρ‡Π΅Ρ€Π΅Π· `tmp` + `mv` ΠΏΡ€Π΅Π΄ΠΎΡ‚Π²Ρ€Π°Ρ‰Π°Π΅Ρ‚ ΠΏΠΎΠ²Ρ€Π΅ΠΆΠ΄Π΅Π½ΠΈΠ΅ Ρ„Π°ΠΉΠ»ΠΎΠ² ΠΏΡ€ΠΈ Π°Π²Π°Ρ€ΠΈΠΉΠ½ΠΎΠΌ Π²Ρ‹ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠΈ питания. * **Π—Π°Ρ‰ΠΈΡ‚Π° ΠΎΡ‚ зацикливания пСрСзапусков (Restart-Loop Prevention)**: Π›ΠΈΠΌΠΈΡ‚ Π½Π΅ Π±ΠΎΠ»Π΅Π΅ 3 пСрСзапусков Π·Π° 10 ΠΌΠΈΠ½ΡƒΡ‚ (`safe_proxy_restart()`), ΠΌΡŒΡŽΡ‚Π΅ΠΊΡ `PROXY_RESTART_LOCK` ΠΈ ΠΊΡƒΠ»Π΄Π°ΡƒΠ½ DNS-ΠΏΠ΅Ρ‚Π΅Π»ΡŒ. @@ -121,6 +132,13 @@ Watchdog β€” сСрдцС ΡΡ‚Π°Π±ΠΈΠ»ΡŒΠ½ΠΎΡΡ‚ΠΈ Tachyon. Π Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ ΠΊ

### πŸ–₯️ 5. Π‘ΠΎΠ²Ρ€Π΅ΠΌΠ΅Π½Π½Ρ‹ΠΉ Web-интСрфСйс LuCI (TypeScript) + +
+ +![LuCI Web UI Showcase](assets/readme/luci_web_showcase.svg) + +
+ * Полная интСграция Π² ΡˆΡ‚Π°Ρ‚Π½Ρ‹ΠΉ Web-интСрфСйс OpenWrt. * **Π˜Π½Ρ‚Π΅Ρ€Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹ΠΉ Π΄Π°ΡˆΠ±ΠΎΡ€Π΄**: Π“Ρ€Π°Ρ„ΠΈΠΊΠ° Π·Π°Π΄Π΅Ρ€ΠΆΠ΅ΠΊ, ΡƒΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ подписками, ΠΏΡ€Π°Π²ΠΈΠ»Π°ΠΌΠΈ ΠΈ ΠΊΠΎΠΌΠΏΠΎΠ½Π΅Π½Ρ‚Π°ΠΌΠΈ Π² нСсколько ΠΊΠ»ΠΈΠΊΠΎΠ². * **ΠŸΠΎΡ‚ΠΎΠΊΠΎΠ²Ρ‹ΠΉ Ρ‚Π΅Ρ€ΠΌΠΈΠ½Π°Π» установки**: Π–ΠΈΠ²ΠΎΠΉ Π²Ρ‹Π²ΠΎΠ΄ Π»ΠΎΠ³ΠΎΠ² процСссов установки ΠΈ ΠΎΠ±Π½ΠΎΠ²Π»Π΅Π½ΠΈΠΉ ΠΊΠΎΠΌΠΏΠΎΠ½Π΅Π½Ρ‚ΠΎΠ² Π±Π΅Π· зависаний. @@ -131,7 +149,13 @@ Watchdog β€” сСрдцС ΡΡ‚Π°Π±ΠΈΠ»ΡŒΠ½ΠΎΡΡ‚ΠΈ Tachyon. Π Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ ΠΊ divider

-## πŸ› οΈ Π‘ΠΏΡ€Π°Π²ΠΎΡ‡Π½ΠΈΠΊ консоли (CLI & API Quick Reference) +## πŸ› οΈ Π‘ΠΏΡ€Π°Π²ΠΎΡ‡Π½ΠΈΠΊ консоли (CLI & REST Agent API) + +
+ +![CLI & API Showcase](assets/readme/cli_showcase.svg) + +
```bash # === БистСмная ΠΈ ΠΎΡ„Π»Π°ΠΉΠ½-диагностика === @@ -206,6 +230,6 @@ Tachyon опираСтся Π½Π° Ρ„ΡƒΠ½Π΄Π°ΠΌΠ΅Π½Ρ‚Π°Π»ΡŒΠ½Ρ‹Π΅ Ρ€Π°Π·Ρ€Π°Π±ΠΎΡ‚
-Made with ❀️ for OpenWrt Community +![Tachyon Community Footer](assets/readme/footer_tachyon.svg)
diff --git a/assets/readme/cli_showcase.svg b/assets/readme/cli_showcase.svg new file mode 100644 index 00000000..4a8d762c --- /dev/null +++ b/assets/readme/cli_showcase.svg @@ -0,0 +1,94 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + πŸ› οΈ + CLI Terminal Control & HTTP REST Agent API (OpenAPI 3.0) + ΠŸΠΎΠ»Π½ΠΎΡ„ΡƒΠ½ΠΊΡ†ΠΈΠΎΠ½Π°Π»ΡŒΠ½Ρ‹ΠΉ ΠΊΠΎΠ½ΡΠΎΠ»ΡŒΠ½Ρ‹ΠΉ интСрфСйс ΠΈ REST API для ΠΈΠ½Ρ‚Π΅Π³Ρ€Π°Ρ†ΠΈΠΈ с LLM-Π°Π³Π΅Π½Ρ‚Π°ΠΌΠΈ (GPTs, N8N, Dify) + + + + + + + + + + + + + + + OPENAPI 3.0.3 + /openapi.json Schema + + + + + + + BEARER AUTH TOKEN + Granular READ / WRITE + + + + + + + LLM AGENT READY + ChatGPT, N8N, Dify + + + + + + + RESTORE INTERNET + 1-Click Native Fallback + + + diff --git a/assets/readme/footer_tachyon.svg b/assets/readme/footer_tachyon.svg new file mode 100644 index 00000000..23acbc7d --- /dev/null +++ b/assets/readme/footer_tachyon.svg @@ -0,0 +1,49 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ❀️ + Crafted with passion for the global OpenWrt & Tachyon Community + + diff --git a/assets/readme/luci_web_showcase.svg b/assets/readme/luci_web_showcase.svg new file mode 100644 index 00000000..54d86b35 --- /dev/null +++ b/assets/readme/luci_web_showcase.svg @@ -0,0 +1,94 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + πŸ–₯️ + Modern LuCI Web UI (TypeScript & Reactive State) + Π˜Π½Ρ‚Π΅Ρ€Π°ΠΊΡ‚ΠΈΠ²Π½Ρ‹ΠΉ Π΄Π°ΡˆΠ±ΠΎΡ€Π΄ OpenWrt: Π·Π°ΠΌΠ΅Ρ€ Π·Π°Π΄Π΅Ρ€ΠΆΠ΅ΠΊ RTT, ΠΏΠΎΡ‚ΠΎΠΊΠΎΠ²Ρ‹ΠΉ Ρ‚Π΅Ρ€ΠΌΠΈΠ½Π°Π» установки ΠΈ ΡƒΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ ΠΏΡ€Π°Π²ΠΈΠ»Π°ΠΌΠΈ + + + + + + + + + + + + + + + TYPESCRIPT CORE + Strict Type-Safe Build + + + + + + + RTT LATENCY MATRIX + Real-Time Ping Heatmap + + + + + + + STREAMING LOGS + Live RPC Output Stream + + + + + + + COMMIT-LEVEL TRACK + Same-Release SHA Check + + + diff --git a/assets/readme/telegram_bot_showcase.svg b/assets/readme/telegram_bot_showcase.svg new file mode 100644 index 00000000..8e47be71 --- /dev/null +++ b/assets/readme/telegram_bot_showcase.svg @@ -0,0 +1,110 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + πŸ“± + Interactive Telegram Bot Management & Remote Control + ΠœΠ³Π½ΠΎΠ²Π΅Π½Π½Ρ‹ΠΉ ΠΊΠΎΠ½Ρ‚Ρ€ΠΎΠ»ΡŒ Ρ€ΠΎΡƒΡ‚Π΅Ρ€Π° ΠΈΠ· мСссСндТСра: запуск AI Doctor, ΠΏΠ΅Ρ€Π΅ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ сСрвСров ΠΈ списков + + + + + + + + + + + + + + /ai_doctor + + + + + + /fix <code> + + + + + + /restart + + + + + + /status + + + + + + /backup + + + + + + + + + + BOT ACTIVE + + + + + + RTT: 18ms + + + + diff --git a/assets/readme/watchdog_showcase.svg b/assets/readme/watchdog_showcase.svg new file mode 100644 index 00000000..6defd9ce --- /dev/null +++ b/assets/readme/watchdog_showcase.svg @@ -0,0 +1,111 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + πŸ›‘οΈ + Autonomous Watchdog & Resilience Subsystem + НСпрСрывный ΠΌΠΎΠ½ΠΈΡ‚ΠΎΡ€ΠΈΠ½Π³ ΠΊΠ°ΠΆΠ΄Ρ‹Π΅ 5-15 сСкунд: Π·Π°Ρ‰ΠΈΡ‚Π° ΠΎΡ‚ ΡƒΡ‚Π΅Ρ‡Π΅ΠΊ памяти, DNS-ΠΏΠ΅Ρ‚Π΅Π»ΡŒ ΠΈ сбоСв питания + + + + + + + + + + + + + + + ATOMIC WRITE + tmp + mv Safe Configs + + + + + + + LOOP PREVENTION + Max 3 restarts / 10 min + + + + + + + OOM WATCHDOG + Dynamic GOMEMLIMIT + + + + + + + HOT-RELOAD + Zero TCP Dropped + + + + + + + + + + + + + + +