Kaskad PRO v2.3: progress bar on startup, full uninstall with double confirmation, docs and user guide

Made-with: Cursor

ИНСТРУКЦИЯ_ДЛЯ_ПОЛЬЗОВАТЕЛЯ.md

@@ -0,0 +1,165 @@
+# Kaskad PRO v2.3 — инструкция простыми словами
+
+Эта инструкция для тех, кто не разбирается в компьютерах. Всё по шагам, без сложных слов.
+
+---
+
+## Что это такое?
+
+**Kaskad PRO** — это программа для сервера. Она делает так: вы подключаетесь к **вашему серверу в России**, а он незаметно отправляет ваш трафик на **зарубежный VPN или прокси**. Провайдер видит только подключение к российскому серверу.
+
+**Проще:** вы заходите на российский сервер, а он сам «дозванивается» до зарубежного. Вы этим не занимаетесь — всё настроено один раз.
+
+---
+
+## Что вам понадобится
+
+1. **Сервер (VPS)** — арендованный компьютер в интернете с Linux. Обычно у хостера есть адрес сервера (IP), логин и пароль. Без сервера программа некуда ставить.
+2. **Программа для входа на сервер** — например **Termius** (телефон/планшет) или **PuTTY** (компьютер). В ней вы вводите IP сервера, логин и пароль и попадаете в «чёрное окно» — это и есть доступ к серверу.
+3. **Данные вашего зарубежного VPN/прокси** — IP-адрес и порт. Их даёт тот, у кого вы купили VPN или прокси (или вы их видите в приложении Amnezia, v2rayNG и т.п.).
+
+---
+
+## Шаг 1. Войти на сервер
+
+1. Откройте Termius (или PuTTY).
+2. Создайте новое подключение: укажите **IP-адрес** сервера, **логин** (часто `root`) и **пароль**.
+3. Подключитесь. Откроется окно с чёрным фоном и текстом — это терминал.
+
+Дальше все команды нужно **вводить в это окно** и нажимать **Enter**.
+
+---
+
+## Шаг 2. Установить Kaskad PRO
+
+Вам дадут **одну длинную команду**. Её нужно:
+
+1. **Скопировать целиком** (от начала до конца).
+2. **Вставить** в чёрное окно (правой кнопкой мыши или долгим нажатием → Вставить).
+3. Нажать **Enter**.
+
+Пример команды (вам могут дать другую, с вашей ссылкой или токеном):
+
+```
+curl -sL https://raw.githubusercontent.com/anten-ka/kaskad-pro/main/install.sh -o install.sh && chmod +x install.sh && ./install.sh
+```
+
+Что будет: появятся надписи, возможно попросят нажать Enter. В конце откроется **меню с цифрами** — это главное меню Kaskad PRO. Установка закончена.
+
+---
+
+## Шаг 3. Открыть меню в следующий раз
+
+Когда вы снова зайдёте на сервер, чтобы что-то изменить, в чёрном окне нужно просто напечатать:
+
+```
+gokaskad
+```
+
+и нажать **Enter**. Снова откроется меню с цифрами.
+
+---
+
+## Шаг 4. Добавить «мост» (каскад)
+
+В меню есть пункты **1, 2, 3, 4** — это разные типы подключений.
+
+- **1** — для AmneziaWG, WireGuard (обычно для телефона/планшета).
+- **2** — для VLESS, XRay (часто в приложениях типа v2rayNG, NekoBox).
+- **3** — для прокси Telegram (MTProto).
+- **4** — для всего остального (разные порты, SSH, RDP и т.д.).
+
+**Что делать:**
+
+1. Введите цифру (например **1**) и нажмите Enter.
+2. Программа спросит **IP-адрес**. Введите адрес вашего **зарубежного** сервера (четыре числа через точку, например `45.10.20.30`). Enter.
+3. Потом покажется проверка (страна, пинг) и попросят **имя** — можно написать любое, например «Мой VPN», или нажать Enter и пропустить.
+4. Попросят **примечание** — тоже по желанию, можно Enter.
+5. Попросят **порт** — введите число (например `51820`). Enter.
+6. Покажут, что будет сделано, и спросят «Применить? (y/n)». Напечатайте **y** и Enter.
+
+Готово. Теперь в **приложении на телефоне или компьютере** (Amnezia, v2rayNG и т.д.) нужно в настройках соединения **поменять адрес сервера**: вместо зарубежного IP указать **IP этого (российского) сервера**. Порт оставить тот же. Тогда трафик пойдёт: вы → российский сервер → зарубежный VPN.
+
+---
+
+## Шаг 5. Настроить бота в Telegram
+
+Бот в Telegram позволяет управлять сервером с телефона: смотреть правила, пинг, добавлять мосты и т.д.
+
+### 5.1. Создать бота и получить токен
+
+1. Откройте **Telegram**.
+2. В поиске введите: **@BotFather** (один бот, с галочкой).
+3. Нажмите «Запустить» или напишите **/start**.
+4. Напишите **/newbot**.
+5. BotFather спросит **имя** бота — любое (например: «Мой Kaskad»). Отправьте.
+6. Потом попросит **username** — должно заканчиваться на **bot** (например: `my_kaskad_bot`). Отправьте.
+7. В ответ BotFather пришлёт **длинную строку** (токен). Она выглядит так: `7123456789:AAH...` — это **токен бота**. Скопируйте её целиком и сохраните.
+
+### 5.2. Вставить токен в Kaskad PRO
+
+1. На сервере откройте меню: введите **gokaskad** и Enter.
+2. В меню выберите **8** (Telegram Bot). Enter.
+3. Выберите **1** (Установить токен бота). Enter.
+4. Вставьте скопированный токен и нажмите Enter.
+5. Напишут, что сохранено. Нажмите Enter.
+
+### 5.3. Привязать свой Telegram (Chat ID)
+
+Чтобы бот слушал только вас, нужно «познакомить» его с вашим аккаунтом.
+
+1. В меню бота на сервере выберите **2** (Получить Chat ID). Enter.
+2. **Не нажимая пока Enter в терминале**, откройте Telegram, найдите **вашего бота** (по имени, которое вы дали) и напишите ему любое сообщение, например **Привет** или **/start**.
+3. Вернитесь в чёрное окно на сервере и нажмите **Enter**.
+4. Программа покажет ваш Chat ID и сохранит его. Готово.
+
+### 5.4. Включить бота
+
+В том же меню (8 — Telegram Bot) выберите **4** (Запустить бота). Enter. Должно написать, что бот запущен.
+
+Теперь откройте бота в Telegram и напишите **/start** — появится меню с кнопками.
+
+---
+
+## Как пользоваться ботом в Telegram
+
+- **Кнопки внизу сообщения** — нажимайте на них, бот будет показывать новые сообщения и новые кнопки.
+- **Добавить мост:** нажмите нужный тип (AWG, VLESS, MTProto или Custom). Бот попросит ввести IP — напишите в чат и отправьте. Дальше он будет просить порт, имя и т.д. — просто отвечайте в чате.
+- **Посмотреть правила:** кнопка «Правила» — покажет список настроенных мостов.
+- **Пинг:** кнопка «Ping» — выберите сервер, потом «1 раз», «10 раз» или «60 сек» — бот пришлёт результат.
+- **Мониторинг:** кнопка «Монитор» — можно добавить проверку сервера; если связь станет плохой, бот пришлёт уведомление.
+- **Большие кнопки внизу экрана:** если нажали «Reply-клавиатура», под полем ввода появятся большие кнопки. Нажимайте их как меню. Чтобы вернуть обычные кнопки под сообщениями, напишите боту **/inline**.
+
+---
+
+## Что делать, если не получается
+
+- **«Запустите с правами root»** — вы зашли на сервер не под главным пользователем. Обычно нужно подключаться с логином **root** и паролем, который дал хостинг.
+- **Бот не отвечает** — проверьте: токен вставлен (п. 5.2), Chat ID получен (п. 5.3), бот запущен (п. 5.4). Если всё сделали — перезапустите бота: меню 8 → пункт 5 (Остановить), потом пункт 4 (Запустить).
+- **Не знаю IP сервера** — IP арендованного сервера (VPS) пишет хостинг в панели управления. Это четыре числа через точку.
+- **Не знаю порт VPN** — смотрите в приложении, где подключаетесь к VPN (Amnezia, v2rayNG и т.д.), в настройках сервера обычно указан порт (например 51820, 443).
+
+---
+
+## Кратко: что нажимать в меню
+
+| Цифра | Что это |
+|-------|--------|
+| 1 | Настроить WireGuard/Amnezia (UDP) |
+| 2 | Настроить VLESS (TCP) |
+| 3 | Настроить прокси Telegram |
+| 4 | Настроить своё правило (разные порты) |
+| 5 | Показать все мои правила |
+| 6 | Проверить пинг сервера (живой график) |
+| 7 | Мониторинг (уведомления в Telegram) |
+| 8 | Настройка Telegram-бота |
+| 9 | Удалить одно правило |
+| 10 | Сбросить все правила |
+| 11 | Обновить программу |
+| 12 | Промо хостингов |
+| 13 | Инструкция в программе |
+| 14 | Имена и примечания серверов |
+| 15 | Полностью удалить Kaskad PRO с сервера |
+| 0 | Выход |
+
+Если что-то непонятно — выбирайте в меню **13** (Инструкция): там короткая подсказка по шагам прямо в программе.