8.8 KiB
8.8 KiB
⚡ About Tachyon
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 (formerly Podkop Plus).
Tachyon combines the power of sing-box, local DPI bypass engines (Zapret v1 / Zapret v2 / ByeDPI), an interactive Telegram bot, and a cutting-edge AI Stack (autonomous AI Doctor & HTTP REST Agent API / OpenAPI 3.0).
The entire backend logic is written in ucode — OpenWrt's native, lightweight scripting language — delivering instant response times with minimal RAM footprint (starting from 128 MB RAM devices).
🔥 Core Features & Architecture
🛡️ 1. Multi-Protocol Proxying & Local DPI Bypass
- sing-box Engine: Native support for modern proxy protocols — VLESS (Reality / gRPC / WS), VMess, Shadowsocks, Trojan, and WireGuard.
- Local DPI Bypass Without External VPS:
- Full built-in integration with Zapret v1 (
nfqws), Zapret v2 (nfqws2), and ByeDPI (ciadpi) desync engines for local packet manipulation directly on the router.
- Full built-in integration with Zapret v1 (
- 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.
🌐 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 (
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.
🤖 2. AI Doctor & HTTP REST Agent API (AI Stack)
- Tachyon AI Doctor (v2): Advanced AI diagnostic engine supporting modern LLMs (OpenAI, Anthropic Claude, DeepSeek, or local models via OpenRouter / Ollama).
- Deep Contextual Intelligence: Feeds real-time service health, Watchdog failure history (OOM events, error streaks), and compressed system logs into the LLM prompt.
- Multi-Fix Execution Chains: Generates multi-action repair sequences with dedicated UI buttons per fix or a single "Fix All" action.
- 13 Built-in Quick Fix Codes: Automated repairs for sing-box, nftables, dnsmasq, resolv.conf, DNS cache clearing, subscription refreshing, and network stack restarts.
- Language Modes: Configurable diagnosis output language (
ru/en).
- 🤖 Interactive Telegram Commands (
/ai_doctor&/fix):- Trigger AI diagnostics directly from Telegram using
/ai_doctorwith interactive Inline Keyboards for instant quick-fix execution.
- Trigger AI diagnostics directly from Telegram using
- 🌐 HTTP REST Agent API & OpenAPI 3.0 (Swagger):
- Full-featured API at
/cgi-bin/tachyon-agent/with granular READ/WRITE permission controls secured by a Bearer token (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).
- Full-featured API at
📱 3. 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.
- Diagnostics & Commands:
/doctor,/ai_doctor,/fix <code_name>,/restart,/backup.
🛡️ 4. Watchdog — Protection & Self-Healing System
Watchdog is the heart of Tachyon's stability, running every 5–15 seconds without external dependencies:
- Atomic Operations & UCI Backups: Configuration writes via
tmp+mvprevent file corruption during sudden power losses. - Restart-Loop Protection: Maximum 3 restarts per 10 minutes (
safe_proxy_restart()),PROXY_RESTART_LOCKmutex, and DNS query loop cooldowns. - Memory Optimization (OOM Watchdog): Dynamic
GOMEMLIMITadjustment 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).
- WAN & Gateway Recovery: Active interface monitoring and automated route recovery during ISP outages.
🖥️ 5. Modern Web Interface (LuCI - TypeScript)
- Native integration into OpenWrt's LuCI dashboard.
- Interactive Dashboard: Real-time latency tracking, subscription manager, rule editor, and service controls in a few clicks.
- 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.
🛠️ CLI & API Quick Reference
# === System 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
# === 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
# === HTTP REST API Checks ===
curl http://192.168.1.1/cgi-bin/tachyon-agent/health
curl http://192.168.1.1/cgi-bin/tachyon-agent/openapi.json
💻 Installation
Run the following single command in your router's SSH terminal:
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/tachyonwithout data loss.
🤝 Upstream Projects & Credits
Tachyon stands on the shoulders of incredible open-source projects:
- 🍴 Forkop (ushan0v) — Direct parent repository (formerly Podkop Plus).
- 🐕 Podkop (itdoginfo) — The original project that inspired the architecture.
- 📦 sing-box — Universal proxy engine.
- 🚀 zapret (bol-van) — DPI desync framework (
nfqws/nfqws2). - 🌐 ByeDPI — Local SOCKS desync proxy.
💖 Support & Donations
If Tachyon powers your daily networking and keeps your connection fast and secure, consider supporting ongoing development! ☕ 🧀 🌭
💳 Credit Cards / SBP / Tinkoff Pay:
👉 Support the project via CloudTips
Made with ❤️ for OpenWrt Community