![Tachyon Banner](assets/readme/hero.svg) [![Stars](https://img.shields.io/github/stars/Dushnilin/tachyon?style=for-the-badge&color=38BDF8)](https://github.com/Dushnilin/tachyon/stargazers) [![Releases](https://img.shields.io/github/v/release/Dushnilin/tachyon?style=for-the-badge&color=818CF8)](https://github.com/Dushnilin/tachyon/releases) [![OpenWrt](https://img.shields.io/badge/OpenWrt-23.05%20%7C%2024.10%20%7C%2025.x%20%7C%20SNAPSHOT-10B981?style=for-the-badge&logo=openwrt)](https://openwrt.org/) [![License](https://img.shields.io/github/license/Dushnilin/tachyon?style=for-the-badge&color=C084FC)](LICENSE) [**πŸ‡·πŸ‡Ί Русский**](README.md) | [**πŸ‡¬πŸ‡§ English**](README.en.md)
--- ## ⚑ About Tachyon **Tachyon** is a direct fork of **[Forkop by @ushan0v](https://github.com/ushan0v/forkop)** (formerly **Podkop Plus**). The project has evolved into an independent, high-performance network routing engine and DPI bypass framework designed specifically for **OpenWrt** (fully supporting **OpenWrt 23.05, 24.10, 25.x, and SNAPSHOT** builds). I built upon the solid engineering foundations of the original [Podkop by @itdoginfo](https://github.com/itdoginfo/podkop) and its evolution in [Forkop by @ushan0v](https://github.com/ushan0v/forkop), introducing enterprise-grade resilience, multi-protocol routing, and dynamic system self-healing. The core backend of Tachyon is written in **ucode** β€” OpenWrt's native, lightweight scripting language β€” delivering blazingly fast execution with minimal RAM footprint on embedded hardware. --- ## πŸ”₯ Key Features ### πŸ›‘οΈ Multi-Protocol Proxying & Local DPI Bypass * **sing-box Integration**: Native support for modern proxy protocols including **VLESS**, **VMess**, **Shadowsocks**, **Trojan**, and **WireGuard**. * **Local DPI Bypass (Zapret v1 / Zapret v2 / ByeDPI)**: * Full built-in integration with **Zapret v1 (`nfqws`)**, **Zapret v2 (`nfqws2`)**, and **ByeDPI** (`ciadpi`) desync engines for flexible local packet manipulation directly on the router without third-party proxy servers. * **Multi-Dimensional Selective Routing**: * **By Domains, IP Subnets & Ports**: Route only selected target traffic through proxy or DPI desync engines. * **By Client Devices (MAC / IP)**: Per-device routing rules for individual home network clients (Smart TVs, phones, PCs). * **By GeoIP & Countries**: Filter and route traffic based on destination country (GeoIP / GeoSite) with full inclusion/exclusion list controls. * **Automated Subscription Updates**: Background fetching and parsing of remote proxy subscription links. ### πŸ€– Interactive Telegram Control Bot 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. * **Server Selection & Latency**: Switch active proxy nodes with live RTT ping measurements. * **Device Access Control**: View active DHCP clients and block/unblock internet access by MAC address. * **Network Diagnostics**: Trigger connection tests directly from Telegram. ### 🩺 System Self-Healing β€” Tachyon Doctor An intelligent diagnostic and repair engine available via CLI (`tachyon doctor`) or WebUI: * Scans all core services (`sing-box`, `zapret`, `zapret2`, `byedpi`, `dnsmasq`, `watchdog`). * Validates `nftables` chains and local DNS resolution health. * **Auto-Repair**: Automatically rebuilds broken firewall rules and restarts crashed services without requiring a full router reboot. ### ⚑ Reliability, OpenWrt 25+ & Watchdog * **OpenWrt 25+ Full Compatibility**: Full support for upcoming release branches and bleeding-edge OpenWrt toolchains. * **Seamless Hot-Reload**: Rule updates and server switches apply softly without dropping active TCP connections (Discord calls, VoIP, and downloads remain uninterrupted). * **OOM Watchdog & Memory Tuning**: Continuous RAM health monitoring. Dynamically adjusts process limits (`GOMEMLIMIT`) under memory pressure and sends Telegram alerts. * **MSS Clamping (MTU Fix)**: Automated resolution of MTU fragmentation and frozen TCP handshakes over tunnel interfaces. ### πŸ–₯️ Modern Web Interface (LuCI) * Native integration into OpenWrt's LuCI dashboard. * Real-time latency tracking, subscription manager, rule editor, and service controls. --- ## πŸ’» Installation Run the following single command in your router's SSH terminal: ```bash sh <(wget -O - https://raw.githubusercontent.com/Dushnilin/tachyon/main/install.sh) ``` > [!NOTE] > **Automatic Migration:** Existing configurations from **Forkop**, **Podkop Plus**, or original **Podkop** are fully compatible. The installer will automatically migrate your settings to `/etc/config/tachyon`. --- ## 🀝 Upstream Projects & Credits Tachyon stands on the shoulders of incredible open-source projects: * 🍴 **[Forkop (ushan0v)](https://github.com/ushan0v/forkop)** β€” Direct parent repository (formerly Podkop Plus). * πŸ• **[Podkop (itdoginfo)](https://github.com/itdoginfo/podkop)** β€” The original project that inspired the architecture. * πŸ“¦ **[sing-box](https://github.com/SagerNet/sing-box)** β€” Universal proxy engine. * πŸš€ **[zapret (bol-van)](https://github.com/bol-van/zapret2)** β€” DPI desync framework (`nfqws` / `nfqws2`). * 🌐 **[ByeDPI](https://github.com/hrbrmstr/byedpi)** β€” Local SOCKS desync proxy. --- ## πŸ’– Support & Donations If Tachyon powers your daily networking and helps keep your connection fast and secure, consider supporting ongoing development! β˜• πŸ§€ 🌭 πŸ’³ **Credit Cards / SBP / Tinkoff Pay:** πŸ‘‰ [**Support the project via CloudTips**](https://pay.cloudtips.ru/p/48c57581) ---
Made with ❀️ for OpenWrt Community