Kaskad

Каскадная маршрутизация русских сайтов через свой набор RU-серверов (WireGuard) с автоматическим failover, Telegram-ботом и веб-интерфейсом.

Что это

Несколько зарубежных серверов с X-ray («ам.») держат WireGuard-туннели к одному из RU-серверов. Российские IP/домены идут через RU, всё остальное — через зарубежный. Если RU упал — за минуту переключение на следующий по приоритету. Когда восстановился — пробный failback с автоматическим откатом если WG не отвечает.

телефон/клиент ──> ам. сервер (X-ray) ──┬──> RU primary  ──> RU-сайты
                                        ├──> RU backup   (failover)
                                        └──> RU N        (по приоритету)
                  └──> остальное идёт напрямую через ам.

Возможности

N RU-серверов в конфиге, упорядочены по приоритету
Авто-failover по handshake age + TCP-проба; cooldown между переключениями; автоматический failback с проверкой
Telegram-бот для всех операций: смотреть статус, переключать вручную, добавлять/удалять серверы, домены, IP
Веб-интерфейс с тем же функционалом
Маршруты по доменам: бот резолвит vk.com → IP, добавляет в маршруты на всех ам. серверах. Cron каждые 6ч переподнимает резолв
Доп. подсети/IP добавляются на лету через бот или WebUI; переживают рестарт туннеля и сервера
Уведомления в TG при каждом failover/failback

Структура репозитория

kaskad/
├── bin/                     # скрипты для ам. серверов (failover, switch, routes, domains)
├── bot/                     # Telegram-бот + systemd unit
├── webui/                   # Flask-приложение
├── examples/                # шаблоны конфигов
├── docs/                    # подробная документация
└── README.md

Быстрый старт

См. docs/install.md для полной установки.

Краткая последовательность:

Настроить первый RU-сервер вручную (см. docs/install.md § «RU-сервер»)
Настроить первый ам. сервер (см. § «Ам. сервер»)
Создать /etc/wireguard/ru-servers.json по шаблону examples/ru-servers.example.json
Запустить TG-бот на одном из ам. серверов (bot/ru-tg-bot.service)
(опц.) Запустить WebUI на том же ам. сервере (webui/ru-webui.service)
Дальше — добавлять RU/ам./домены/IP через бот или WebUI

Команды бота

Категория	Команды
Туннели	`/status`, `/use <id>`, `/primary`, `/backup`
RU-серверы	`/server-list`, `/server-add`, `/server-remove`, `/bot-key`
Ам. серверы	`/ams-list`, `/ams-add`, `/ams-remove`
Маршруты	`/ips`, `/list`, `/add <IP/CIDR>`, `/remove <IP/CIDR>`, `/clear`
Домены	`/list-domains`, `/add-domain <domain>`, `/remove-domain <domain>`, `/show-domain <domain>`, `/refresh-domains`
Прочее	`/help`

Полный синтаксис: docs/bot.md.

Веб-интерфейс

Запускается на любом ам. сервере (там же где бот), HTTP basic auth.

После запуска: http://<ам-сервер>:8088

Подробнее: docs/webui.md.

Архитектура

См. docs/architecture.md — как устроены failover, маршрутизация, синхронизация конфига между серверами.

Безопасность

Конфиги (ru-servers.json, notify.env, webui.env) с правами 600, не коммитятся в репо
SSH между серверами — по ключам; пароли используются только при первичной онбординге нового сервера через password= в боте/WebUI и сразу затираются после установки ключа
Веб-интерфейс через basic auth, рекомендуется ставить за HTTPS reverse-proxy (nginx/caddy)
Telegram-бот принимает команды только от заранее заданного TG_CHAT_ID

Лицензия

MIT

5.2 KiB Raw Blame History Unescape Escape