Параллель

Семейный VPN-сервис с Telegram-ботом. Один скрипт — и всё работает.

Пользователь нажимает пару кнопок в Telegram и получает защищённое подключение. Никаких технических терминов, никаких инструкций — всё просто.

Что внутри

• VPN-сервер — VLESS + REALITY на порту 443 (неотличим от обычного HTTPS-трафика)
• Telegram Proxy — MTProto-прокси для доступа к Telegram при блокировке
• Telegram-бот — управление подключениями: получить ключ, проверить статус, получить ссылку на прокси
• CLI-утилита parallel — управление всем сервисом из терминала

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

Подключитесь к VPS (Ubuntu/Debian) и выполните:

curl -sL https://raw.githubusercontent.com/d4sd9dbjrb-create/parallel-bot/main/setup.sh | sudo bash

Скрипт задаст несколько вопросов и автоматически:

1. Установит Docker и системные пакеты
2. Настроит файрвол
3. Развернёт VPN-сервер с VLESS + REALITY
4. Запустит Telegram Proxy (MTProto)
5. Склонирует и запустит Telegram-бота
6. Установит CLI-утилиту parallel
7. Покажет итоговый отчёт со всеми ссылками

Требования

Параметр	Минимум
ОС	Ubuntu 20.04+ / Debian 11+
RAM	1 ГБ
Диск	10 ГБ
Доступ	root

Рекомендуется VPS за пределами РФ (Hetzner, DigitalOcean, Vultr).

Что понадобится заранее

1. Telegram Bot Token — создайте бота через @BotFather
2. Ваш Telegram ID — узнайте через @userinfobot
3. VPS с чистой Ubuntu/Debian

CLI-утилита

После установки на сервере доступна команда parallel:

parallel status     — статус всех сервисов и ресурсов сервера
parallel restart    — перезапустить всё
parallel stop       — остановить всё
parallel start      — запустить всё
parallel logs       — логи бота (также: logs vpn / logs proxy)
parallel users      — таблица пользователей с трафиком
parallel update     — обновить бота из GitHub
parallel backup     — резервная копия конфигов и базы
parallel config     — показать ссылки и настройки
parallel uninstall  — полное удаление

Команды работают и на русском: parallel статус, parallel логи, parallel пользователи.

Telegram-бот

Бот — единственный интерфейс для семьи. Возможности:

• Подключение — получить ключ для VPN-приложения (одна кнопка)
• Статус — проверить, работает ли подключение, сколько трафика использовано
• Proxy — получить ссылку на Telegram-прокси
• Обновить ключ — пересоздать подключение при проблемах
• Помощь — инструкции по настройке для iOS/Android/Windows/macOS
• Админ-панель — статистика, управление пользователями (только для админа)

Сценарий для пользователя

1. Открыть бота → нажать «Начать»
2. Ввести семейный код-приглашение
3. Нажать «Подключиться» → получить ключ
4. Скопировать ключ в приложение (V2rayNG, Hiddify, Streisand)
5. Готово — интернет работает

Структура проекта

parallel-bot/
├── setup.sh              # Автоустановщик (разворачивает всё на VPS)
├── parallel-cli.sh       # CLI-утилита управления
├── bot.py                # Точка входа Telegram-бота
├── config.py             # Конфигурация из .env
├── requirements.txt      # Python-зависимости
├── .env.example          # Пример настроек
└── app/
    ├── handlers/         # Обработчики команд бота
    │   ├── start.py      #   /start + авторизация по коду
    │   ├── menu.py       #   Главное меню
    │   ├── connection.py #   Подключение (получить/создать ключ)
    │   ├── status.py     #   Статус подключения
    │   ├── proxy.py      #   Telegram Proxy
    │   ├── refresh.py    #   Обновить ключ
    │   ├── help.py       #   Помощь и инструкции
    │   └── admin.py      #   Админ-панель
    ├── keyboards/
    │   └── inline.py     # Inline-кнопки
    ├── middlewares/
    │   └── access.py     # Проверка авторизации
    ├── models/
    │   └── user.py       # Модель пользователя
    └── services/
        ├── backend.py        # Фасад над Marzban API
        └── marzban_client.py # HTTP-клиент к Marzban

Что создаётся на сервере после установки

/opt/parallel/
├── config.json           # Конфигурация сервиса
├── bot/                  # Telegram-бот (клон этого репозитория)
│   ├── .venv/            # Python-окружение
│   └── .env              # Настройки бота
├── mtproto/              # Docker Compose для MTProto Proxy
└── backups/              # Резервные копии (parallel backup)

/opt/marzban/             # Панель управления VPN
/var/lib/marzban/         # Данные: Xray-конфиг, база пользователей

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

• Пароли вводятся в скрытом режиме
• Конфигурация с правами 600 (только root)
• Файрвол: открыты только 22 (SSH), 443 (VPN), 8000 (панель), 8443 (прокси)
• REALITY-ключи генерируются на сервере и не покидают машину
• Бот доступен только авторизованным пользователям (код-приглашение)

Ручная установка бота (без скрипта)

Если VPN-сервер уже настроен и нужен только бот:

git clone https://github.com/d4sd9dbjrb-create/parallel-bot.git
cd parallel-bot
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Отредактируйте .env — укажите BOT_TOKEN, ADMIN_ID, настройки Marzban
python3 bot.py

Технологии

• Python 3.10+ / aiogram 3.x
• Marzban Panel + Xray-core
• Docker / Docker Compose
• systemd
• Bash

Лицензия

Для личного и семейного использования.