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

# 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** (Инструкция): там короткая подсказка по шагам прямо в программе.