docs: обновление README.md и добавление англоязычной версии README.en.md

This commit is contained in:
Dushnilin
2026-07-30 10:01:42 +03:00
parent bd4c686479
commit 2bbc041686
3 changed files with 319 additions and 41 deletions
+72 -41
View File
@@ -1,65 +1,96 @@
# Tachyon
<div align="center">
[![Star](https://img.shields.io/github/stars/Dushnilin/tachyon?style=social)](https://github.com/Dushnilin/tachyon/stargazers)
[![Releases](https://img.shields.io/github/v/release/Dushnilin/tachyon?label=releases)](https://github.com/Dushnilin/tachyon/releases)
![Tachyon Banner](assets/readme/hero.svg)
> **Tachyon** — это форк проекта **Forkop** (ранее известного как **Podkop Plus**). Проект переименован и развивается как независимое, современное решение для OpenWrt. Мы сохранили всё лучшее из оригинального [Podkop](https://github.com/itdoginfo/podkop), из которого вырос наш код, и превратили его в мощный, надежный и удобный "комбайн" для управления сетью.
[![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%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)
Tachyon предоставляет мощный инструментарий для гибкой маршрутизации сетевого трафика (через прокси-серверы, средства обхода блокировок или напрямую) на основе доменов, IP-адресов и портов. Вся логика бэкенда написана на легковесном скриптовом языке **ucode**, который является родным для OpenWrt.
[**🇷🇺 Русский**](README.md) | [**🇬🇧 English**](README.en.md)
</div>
---
### Что умеет Tachyon?
## ⚡ О проекте
Tachyon значительно расширяет возможности классических решений и делает управление обходом блокировок автоматизированным, отказоустойчивым и очень удобным.
**Tachyon** — это форк проекта **Forkop** (ранее известного как **Podkop Plus**). Проект переименован и развивается как независимое, продвинутое и современное решение для роутеров под управлением **OpenWrt**.
#### 🛡 Обход блокировок и проксирование (Мульти-протоколы)
* **sing-box**: Поддержка современных протоколов (VLESS, VMess, Shadowsocks, Trojan, WireGuard) для проксирования трафика.
* **Интеграция с Zapret (nfqws / nfqws2)** и **ByeDPI**: Встроенные средства для локального обхода DPI (глубокого анализа пакетов) без использования сторонних серверов.
* **Умная маршрутизация**: Настраивайте правила (домены, IP, порты), чтобы пускать через прокси или средства обхода только то, что нужно.
* **Поддержка подписок**: Автоматическое фоновое обновление прокси-серверов по вашим ссылкам.
Мы сохранили лучшие инженерные идеи оригинального проекта [Podkop от @itdoginfo](https://github.com/itdoginfo/podkop), расширили архитектурный фундамент и превратили его в универсальный высокопроизводительный комбайн для управления сетевым трафиком, проксирования и обхода блокировок.
#### 🤖 Интерактивный Telegram-бот
Бот в Tachyon — это полноценный пульт управления вашим роутером прямо из мессенджера:
* **Управление списками «на лету»**: Просматривайте правила обхода и добавляйте в них новые домены/IP (даже целым списком). Бот сам всё применит.
* **Быстрое переключение**: Включайте и отключайте любые секции маршрутизации одной кнопкой.
* **Переключение серверов**: Выбирайте активный прокси-сервер (бот покажет текущие задержки).
* **Контроль устройств**: Просматривайте активных DHCP-клиентов и блокируйте/разблокируйте им интернет (по MAC-адресу) в один клик.
* **Диагностика**: Запускайте проверку сети прямо из чата.
#### 🩺 Инструмент автоматического ремонта — Tachyon Doctor
В систему встроена мощная система диагностики (доступна через `tachyon doctor` или из Web-интерфейса):
* Сканирует статус служб (`sing-box`, `zapret`, `byedpi`, `dnsmasq`, `watchdog`).
* Проверяет правила `nftables` и корректность DNS-запросов через `localhost`.
* При обнаружении проблем утилита **автоматически исправляет их** (перезапускает службы, чинит правила файрвола) без полной перезагрузки роутера.
#### ⚡ Надежность, Hot-reload и Watchdog
* **Горячая перезагрузка (Hot-reload)**: При обновлении правил или переключении серверов Tachyon использует мягкое обновление конфигурации. Ваши текущие загрузки и звонки в интернете не прервутся!
* **Watchdog и защита от нехватки памяти**: Фоновый процесс постоянно следит за здоровьем системы. Если роутеру не хватает памяти (OOM), система оптимизирует лимиты и пришлет оповещение в Telegram.
* **Корректный MTU Fix (MSS Clamping)**: Автоматическое решение проблем с зависанием TCP-соединений на VPN-интерфейсах.
#### 🖥 Современный Web-интерфейс (LuCI)
* Полноценная интеграция в графический интерфейс OpenWrt.
* Удобный дашборд с мониторингом задержек, управлением подписками, компонентами системы и правилами в несколько кликов.
Вся бэкенд-логика Tachyon написана на скриптовом языке **ucode** — нативном, сверхбыстром и экономичном движке OpenWrt, что обеспечивает минимальное потребление оперативной памяти и ресурсов процессора на любых роутерах.
---
### Установка
## 🔥 Ключевые возможности
Выполните команду в терминале вашего роутера:
### 🛡️ Мультипротокольное проксирование и локальный обход DPI
* **sing-box Engine**: Полная поддержка современных защищенных протоколов — **VLESS**, **VMess**, **Shadowsocks**, **Trojan**, **WireGuard**.
* **Локальный обход DPI (zapret2 / ByeDPI)**: Встроенная интеграция с `zapret2` (`nfqws2`) и `ByeDPI` для обхода глубокого анализа пакетов (DPI) непосредственно на роутере без необходимости использовать внешние прокси-серверы.
* **Гибкая селективная маршрутизация**: Разделение трафика по доменам, IP-сетям и портам. Направляйте через прокси или средства обхода только нужные сервисы.
* **Автоматические подписки**: Синхронизация и фоновое обновление прокси-серверов по вашим подписочным ссылкам.
```sh
### 🤖 Интерактивный Telegram-бот управления
Полноценный пульт дистанционного управления роутером прямо из мессенджера:
* **Управление правилами «на лету»**: Просмотр списков обхода и моментальное добавление новых доменов или IP-сетей (включая пакетное добавление).
* **Мгновенный контроль секций**: Включение и отключение любых маршрутов одной кнопкой.
* **Выбор серверов и задержки**: Переключение активных прокси-нод с автоматическим замером задержки (ping/RTT).
* **Управление устройствами LAN**: Просмотр активных DHCP-клиентов и блокировка/разблокировка доступа в интернет по MAC-адресам.
* **Диагностика сети**: Запуск тестов доступности прямо из чата.
### 🩺 Системный авторемонт — Tachyon Doctor
Встроенный модуль интеллектуальной диагностики и самовосстановления (`tachyon doctor` или из WebUI):
* Сканирование состояния всех ключевых служб (`sing-box`, `zapret2`, `byedpi`, `dnsmasq`, `watchdog`).
* Валидация правил файрвола `nftables` и проверка резолвинга DNS через `localhost`.
* **Автоматическое исправление**: Самостоятельно устраняет сбои (пересоздает цепочки `nftables`, перезапускает упавшие сервисы) без полной перезагрузки устройства.
### ⚡ Надежность, Hot-reload & Watchdog
* **Мягкая перезагрузка (Hot-Reload)**: Обновление правил и переключение серверов происходят без обрыва активных соединений (ваши звонки в Discord, Telegram или загрузки файлов не прервутся).
* **OOM Watchdog & Оптимизация памяти**: Непрерывный мониторинг использования RAM. При нехватке памяти система автоматически регулирует лимиты (`GOMEMLIMIT`) и отправляет уведомление в Telegram.
* **MSS Clamping (MTU Fix)**: Автоматическое решение проблем с "зависанием" TCP-пакетов и веб-страниц на туннельных интерфейсах.
### 🖥️ Современный Web-интерфейс (LuCI)
* Полная интеграция в стандартную панель управления OpenWrt.
* Наглядный дашборд: мониторинг задержек, управление подписками, списками правил и компонентами в несколько кликов.
---
## 💻 Установка
Для установки Tachyon выполните следующую команду в консоли (SSH) вашего роутера:
```bash
sh <(wget -O - https://raw.githubusercontent.com/Dushnilin/tachyon/main/install.sh)
```
> [!NOTE]
> Конфигурация от **Forkop** (или **Podkop Plus / Podkop**) полностью совместима. Во время установки скрипт автоматически перенесёт все ваши настройки в новый конфигурационный файл `/etc/config/tachyon`!
> **Автоматическая миграция:** Конфигурации от **Forkop**, **Podkop Plus** и оригинального **Podkop** полностью совместимы. Скрипт установки автоматически перенесет ваши правила и настройки в `/etc/config/tachyon` без потери данных.
---
### Поддержать проект
## 🤝 Оригинальные проекты и благодарности
Если вам нравится Tachyon и он оказался полезен, вы можете поддержать разработку проекта — на вдохновение, сыр и колбасу! 🧀 🌭 ☕
Tachyon развивается благодаря сообществу и опирается на фундаментальные разработки:
* 🐕 **[Podkop (itdoginfo)](https://github.com/itdoginfo/podkop)** — оригинальный проект, заложивший основу архитектуры.
* 📦 **[sing-box](https://github.com/SagerNet/sing-box)** — универсальный прокси-платформа.
* 🚀 **[zapret2](https://github.com/bol-van/zapret2)** & **[zapret2-mcp](https://github.com/rcd27/zapret2-mcp)** — средства локального обхода DPI и база знаний.
* 🌐 **[ByeDPI](https://github.com/hrbrmstr/byedpi)** — локальный SOCKS-прокси для десинка пакетов.
---
## 💖 Поддержать разработку
Если Tachyon помогает вам и делает работу в сети комфортной, вы можете поддержать проект и автора — на кофе, серверы и вдохновение! ☕ 🧀 🌭
💳 **Карты РФ / СБП / Tinkoff Pay:**
👉 [Донат на CloudTips](https://pay.cloudtips.ru/p/48c57581)
👉 [**Поддержать проект на CloudTips**](https://pay.cloudtips.ru/p/48c57581)
---
<div align="center">
Made with ❤️ for OpenWrt Community
</div>