Skip to content
santex85Public

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

StealthVPN

Полностью анонимный VPN-сервис с оплатой криптовалютой и управлением через Telegram-бота.

Особенности

  • 🔒 Полная анонимность (без регистрации по Email/телефону)
  • 💳 Оплата только криптой или P2P (карта плательщика не видна; через Cryptomus)
  • 🤖 Управление через Telegram-бота
  • 🚀 Протокол VLESS-Reality для обхода блокировок (для новых подписок)
  • 📊 Веб-админ-панель для управления
  • ⚡ Автоматическое управление подписками

Архитектура

[Пользователь] <-> [Telegram Bot] <-> [Master Backend] <-> [VPN Nodes (Marzban)]
                                              |
                                              v
                                        [PostgreSQL + Redis]

Требования

  • Docker и Docker Compose
  • Python 3.11+ (для локальной разработки)
  • Marzban установлен и настроен на VPN-серверах
  • Аккаунт Cryptomus для приема платежей

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

1. Клонирование и настройка

git clone <repository>
cd VPN
cp .env.example .env

2. Настройка переменных окружения

Отредактируйте .env файл:

# Telegram Bot
TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here

# Cryptomus Payment Gateway
CRYPTOMUS_API_KEY=your_cryptomus_api_key
CRYPTOMUS_MERCHANT_ID=your_merchant_id
CRYPTOMUS_WEBHOOK_SECRET=your_webhook_secret

# Marzban VPN Panel
MARZBAN_API_URL=https://your-marzban-instance.com/api/v1
MARZBAN_ADMIN_TOKEN=your_marzban_admin_token

# Admin Configuration
ADMIN_TELEGRAM_IDS=123456789,987654321
ADMIN_API_TOKEN=your_secure_admin_api_token_here

# Database (можно оставить по умолчанию для разработки)
DATABASE_URL=postgresql://stealthvpn:changeme@postgres:5432/stealthvpn
REDIS_URL=redis://redis:6379/0

3. Запуск через Docker Compose

docker-compose up -d

Это запустит:

  • PostgreSQL (база данных)
  • Redis (кэш и FSM для бота)
  • Backend (FastAPI + Telegram Bot)

4. Инициализация базы данных

# Создать миграции (если нужно)
docker-compose exec backend alembic revision --autogenerate -m "Initial migration"

# Применить миграции
docker-compose exec backend alembic upgrade head

5. Создание начальных данных

Подключитесь к базе данных и создайте тарифы:

INSERT INTO plans (name, period_days, price_usd, price_rub, is_active) VALUES
('1 месяц', 30, 5.00, 500.00, true),
('3 месяца', 90, 12.00, 1200.00, true),
('6 месяцев', 180, 20.00, 2000.00, true),
('1 год', 365, 35.00, 3500.00, true);

INSERT INTO servers (name, marzban_api_url, marzban_admin_token, is_active, location) VALUES
('Server 1', 'https://your-marzban.com/api/v1', 'your_token', true, 'US');

Разработка

Локальная разработка

  1. Установите зависимости:
pip install -r requirements.txt
  1. Запустите PostgreSQL и Redis через Docker:
docker-compose up -d postgres redis
  1. Настройте переменные окружения в .env

  2. Запустите миграции:

alembic upgrade head
  1. Запустите API сервер:
uvicorn backend.api.main:app --reload
  1. Запустите Telegram бота (в отдельном терминале):
python run_bot.py

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

VPN/
├── backend/              # Основной бэкенд
│   ├── bot/             # Telegram бот (Aiogram 3.x)
│   │   ├── handlers/    # Обработчики команд
│   │   ├── keyboards.py # Клавиатуры
│   │   └── states.py   # FSM состояния
│   ├── api/             # FastAPI приложение
│   │   └── routes/      # API маршруты
│   ├── core/            # Общая бизнес-логика
│   ├── services/        # Сервисы (Marzban, Cryptomus)
│   ├── models/          # SQLAlchemy модели
│   └── tasks/           # Фоновые задачи
├── frontend/            # Web админ-панель
├── migrations/          # Alembic миграции
└── docker-compose.yml   # Оркестрация сервисов

API Endpoints

Публичные

  • GET / - Информация об API
  • GET /health - Health check
  • POST /webhooks/cryptomus - Webhook для Cryptomus
  • GET /api/subscription/{telegram_id} - Получить подписку пользователя

Админ (требует Bearer токен)

  • GET /api/admin/stats - Статистика системы
  • GET /api/admin/servers - Список серверов
  • POST /api/admin/broadcast - Рассылка сообщений
  • GET /admin/ - Веб-админ-панель
  • GET /admin/api/dashboard - Данные дашборда
  • GET /admin/api/plans - Список тарифов
  • GET /admin/api/users - Список пользователей

Telegram Bot Команды

Пользовательские

  • /start - Начать работу с ботом
  • 🛒 Купить подписку - Купить подписку
  • 👤 Мой профиль - Просмотр профиля и подписки
  • 📖 Инструкции - Инструкции по настройке
  • 💬 Поддержка - Контакты поддержки

Админские

  • /admin_stats - Статистика системы
  • /admin_user <telegram_id> - Информация о пользователе
  • /admin_ban <telegram_id> - Забанить пользователя
  • /admin_unban <telegram_id> - Разбанить пользователя
  • /admin_grant <telegram_id> <days> - Выдать подписку
  • /admin_broadcast - Начать рассылку сообщений

Деплой и сервер

Полный runbook (nginx, Marzban, VLESS-Reality, админ, токен) и эталонные конфиги: deploy/DEPLOY_STATUS.md.


Настройка Marzban

  1. Установите Marzban на VPN-сервере согласно официальной документации

  2. На каждой ноде должен быть настроен inbound VLESS-Reality с тегом VLESS_REALITY в конфиге Xray (файл на сервере: /var/lib/marzban/xray_config.json или /opt/marzban/xray_config.json). Эталонный фрагмент: deploy/xray-vless-reality-inbound.json. Конфигурация Xray выполняется на сервере (ключи x25519, порт 443, flow xtls-rprx-vision).

  3. Получите Admin Token: POST /api/admin/token с телом application/x-www-form-urlencoded (username=...&password=...), не JSON. См. deploy/DEPLOY_STATUS.md и скрипт scripts/marzban_get_token.sh.

  4. Добавьте сервер в базу данных:

INSERT INTO servers (name, marzban_api_url, marzban_admin_token, is_active, location)
VALUES ('Server Name', 'https://your-marzban.com/api/v1', 'your_token', true, 'Location');

Настройка Cryptomus

  1. Зарегистрируйтесь на Cryptomus

  2. Создайте проект и получите API ключи

  3. Настройте webhook URL: https://your-domain.com/webhooks/cryptomus

  4. Укажите webhook secret в .env

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

  • Все webhooks проверяются по подписи
  • Rate limiting на API endpoints
  • IP-адреса пользователей не логируются
  • Админ-панель защищена токеном
  • Чувствительные данные не сохраняются в логах

Мониторинг и логи

Логи доступны через:

# Все сервисы
docker-compose logs -f

# Только backend
docker-compose logs -f backend

Обновление

git pull
docker-compose build
docker-compose up -d
docker-compose exec backend alembic upgrade head

Устранение неполадок

Бот не отвечает

  1. Проверьте токен бота в .env
  2. Проверьте логи: docker-compose logs backend
  3. Убедитесь, что Redis запущен

Платежи не обрабатываются

  1. Проверьте настройки Cryptomus
  2. Убедитесь, что webhook URL доступен извне
  3. Проверьте логи webhook: docker-compose logs backend | grep webhook

Подписки не создаются

  1. Проверьте подключение к Marzban API
  2. Убедитесь, что токен Marzban правильный
  3. Проверьте логи: docker-compose logs backend | grep marzban

Лицензия

[Укажите лицензию]

Поддержка

Для вопросов и поддержки:

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages