Kaskad PRO v2.0: cascading VPN/proxy manager with Telegram bot, live ping, monitoring and alerts

Made-with: Cursor

README.md

@@ -0,0 +1,140 @@
+# Kaskad PRO v2.0
+
+**Каскадный менеджер VPN / Proxy с Telegram-ботом, мониторингом и пингом.**
+
+> Канал: [YouTube @antenkaru](https://www.youtube.com/@antenkaru)
+
+---
+
+## Возможности
+
+| Функция | Описание |
+|---|---|
+| **Каскад UDP** | AmneziaWG, WireGuard — одна команда |
+| **Каскад TCP** | VLESS, XRay, VMess, Reality, Trojan |
+| **Каскад MTProto** | Telegram-прокси |
+| **Custom Rule** | Разные порты входа/выхода, SSH, RDP и т.д. |
+| **Live Ping** | Пинг целевого сервера в терминале (обновление 1 сек) |
+| **Telegram Bot** | Полное управление через кнопки прямо из Telegram |
+| **Ping в боте** | 1 раз / 10 раз (среднее) / 60 секунд (непрерывно) |
+| **Мониторинг** | Автопинг каждые 10с / 1мин / 5мин с алертами в Telegram |
+| **BBR Turbo** | Автоматическое включение Google BBR |
+| **Безопасность** | Валидация IP/портов, маркировка правил, изоляция iptables |
+
+---
+
+## Установка
+
+Подключитесь к VPS (Ubuntu/Debian/CentOS) под `root`:
+
+```bash
+wget -O install.sh "URL_СКРИПТА" && chmod +x install.sh && ./install.sh
+```
+
+Повторный запуск:
+
+```bash
+gokaskad
+```
+
+---
+
+## Быстрый старт
+
+### 1. Создать каскад (пример WireGuard)
+
+```
+Меню → 1
+IP: 45.10.20.30
+Порт: 51820
+Подтвердить: y
+```
+
+В клиенте замените Endpoint на IP этого сервера.
+
+### 2. Настроить Telegram-бота
+
+```
+Меню → 8 → 1  →  Вставить токен от @BotFather
+Меню → 8 → 2  →  Отправить сообщение боту, нажать Enter
+Меню → 8 → 4  →  Запустить бота
+```
+
+В Telegram: `/start` — появится меню с кнопками.
+
+### 3. Включить мониторинг
+
+```
+Меню → 7 → 1  →  Выбрать сервер → Интервал → Порог (мс)
+Меню → 7 → 3  →  Запустить службу
+```
+
+Алерты приходят в Telegram, когда пинг превышает порог.
+
+---
+
+## Структура меню
+
+```
+ 1) AmneziaWG / WireGuard (UDP)
+ 2) VLESS / XRay (TCP)
+ 3) TProxy / MTProto (TCP)
+ 4) Кастомное правило
+ 5) Активные правила
+ 6) Ping сервера (live)
+ 7) Мониторинг
+ 8) Telegram Bot
+ 9) Удалить правило
+10) Сбросить правила
+11) Обновить скрипт
+12) PROMO
+13) Инструкция (7 страниц)
+ 0) Выход
+```
+
+---
+
+## Telegram Bot — кнопки
+
+```
+🔀 AWG/WireGuard (UDP)     — добавить UDP каскад
+🔀 VLESS/XRay (TCP)        — добавить TCP каскад
+🔀 MTProto/TProxy (TCP)    — добавить TCP каскад
+🛠 Custom Rule             — произвольное правило
+📋 Правила                 — список активных правил
+🏓 Ping                    — пинг (1x / 10x / 60 сек)
+📊 Мониторинг              — добавить/удалить/список мониторов
+❌ Удалить правило          — удалить конкретный каскад
+🗑 Сбросить всё            — полная очистка (с подтверждением)
+```
+
+---
+
+## Файлы и пути
+
+| Путь | Назначение |
+|---|---|
+| `/usr/local/bin/gokaskad` | Глобальная команда запуска |
+| `/etc/kaskad/config` | Токен бота и Chat ID |
+| `/etc/kaskad/monitors/` | Конфигурации мониторов |
+| `/var/log/kaskad.log` | Лог всех действий |
+
+---
+
+## Системные службы
+
+```bash
+# Telegram-бот
+systemctl status kaskad-bot
+journalctl -u kaskad-bot -f
+
+# Мониторинг
+systemctl status kaskad-monitor
+journalctl -u kaskad-monitor -f
+```
+
+---
+
+## Лицензия
+
+Для частного использования. Распространение запрещено.