https://github.com/flatex1/winstonvpn-bot
Telegram бот для продажи подписок на VPN-сервис. Использует GrammY для работы с Telegram Bot API, Convex для базы данных и серверной логики, и интегрируется с 3x-ui API для управления VPN-аккаунтами.
https://github.com/flatex1/winstonvpn-bot
bot convex grammy telegram vpn
Last synced: 6 months ago
JSON representation
Telegram бот для продажи подписок на VPN-сервис. Использует GrammY для работы с Telegram Bot API, Convex для базы данных и серверной логики, и интегрируется с 3x-ui API для управления VPN-аккаунтами.
- Host: GitHub
- URL: https://github.com/flatex1/winstonvpn-bot
- Owner: flatex1
- License: mit
- Created: 2025-04-08T19:53:09.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-12T16:43:31.000Z (6 months ago)
- Last Synced: 2025-04-13T06:43:50.431Z (6 months ago)
- Topics: bot, convex, grammy, telegram, vpn
- Language: TypeScript
- Homepage:
- Size: 110 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WinstonVPN Bot
Telegram бот для продажи подписок на VPN-сервис. Использует GrammY для работы с Telegram Bot API, Convex для базы данных и серверной логики, и интегрируется с 3x-ui API для управления VPN-аккаунтами.
## Технологический стек
- Node.js
- TypeScript
- GrammY (фреймворк для Telegram ботов)
- Convex (база данных и бэкенд)
- 3x-ui API (управление VPN)
## Установка и запуск
### Предварительные требования
- Node.js 18+ и npm
- Аккаунт Convex (https://www.convex.dev/)
- Сервер с установленным 3x-ui
### Установка зависимостей
```bash
npm install
```
### Настройка окружения
1. Скопируйте файл `.env.example` в `.env`:
```bash
cp .env.example .env
```
2. Заполните необходимые переменные окружения в файле `.env`:
- `BOT_TOKEN` - токен вашего Telegram бота (получите у [@BotFather](https://t.me/BotFather))
- `ADMIN_TELEGRAM_IDS` - Telegram ID администраторов (через запятую)
- `CONVEX_DEPLOYMENT` - ID деплоя Convex
- `XUI_API_URL` - URL вашего сервера с 3x-ui
- `XUI_API_USERNAME` - Имя пользователя для доступа к API 3x-ui
- `XUI_API_PASSWORD` - Пароль для доступа к API 3x-ui
- `XUI_DEFAULT_INBOUND_ID` - ID inbound сервера в 3x-ui
- `DEPLOYMENT_URL` - URL развернутого приложения для вызова actions
### Инициализация Convex
```bash
npx convex dev
```
### Запуск в режиме разработки
```bash
npm run dev
```
### Запуск в production режиме
```bash
npm run build
npm start
```
## Основные функции бота
- Регистрация пользователя
- Выбор и покупка подписки VPN
- Просмотр информации о подписке и использованном трафике
- Автоматическое уведомление о скором истечении срока подписки
- Продление и смена тарифа
- Административные функции для управления пользователями и подписками
## Структура проекта
```
├── convex/ # Серверный код Convex
│ ├── schema.ts # Схема данных Convex
│ ├── users.ts # Логика работы с пользователями
│ ├── subscriptionPlans.ts # Управление тарифами
│ ├── userSubscriptions.ts # Управление подписками пользователей
│ ├── vpnAccounts.ts # Управление VPN-аккаунтами
│ ├── vpnAccountActions.ts # Actions для работы с VPN-аккаунтами
│ ├── notifications.ts # Система уведомлений пользователей
│ ├── crons.ts # Периодические задачи
│ └── http.ts # HTTP хендлеры для вебхуков
│
├── src/
│ ├── api/ # Интеграция с 3x-ui API
│ │ ├── xui-client.ts # Класс для работы с 3x-ui API
│ │ └── models.ts # Типы данных для API
│ │
│ ├── bot/ # Код Telegram бота
│ │ ├── bot.ts # Инициализация бота
│ │ ├── commands/ # Обработчики команд
│ │ │ ├── start.ts # Команда /start
│ │ │ ├── help.ts # Команда /help
│ │ │ ├── profile.ts # Команда /profile
│ │ │ ├── tariffs.ts # Команда /tariffs
│ │ │ ├── connection.ts # Команда /connection
│ │ │ ├── instructions.ts # Команда /instructions
│ │ │ └── index.ts # Экспорт всех команд
│ │ ├── middlewares/ # Промежуточные обработчики
│ │ │ ├── auth.ts # Аутентификация пользователя
│ │ │ ├── error-handler.ts # TODO: Обработка ошибок
│ │ │ └── index.ts # Экспорт всех middleware
│ │ └── keyboards.ts # Клавиатуры и кнопки
│ │
│ ├── services/ # Сервисы для работы с API
│ │ └── convex-client.ts # Клиент для работы с Convex API
│ │
│ ├── utils/ # Вспомогательные функции
│ │ ├── config.ts # Конфигурация приложения
│ │ └── logger.ts # Логирование
│ │
│ └── index.ts # Точка входа
│
├── .env.example # Пример .env файла
├── .gitignore
├── convex.json # Конфигурация Convex
├── package.json
├── tsconfig.json
└── README.md
```
## Дальнейшее развитие
- Интеграция платежных систем:
- YooKassa
- Telegram Stars
- Многоязычность (русский, английский, китайский)
- Дополнительные тарифы и планы подписок
- Реферальная система
- Статистика и аналитика для администраторов
- Автоматическое продление подписок
- Панель управления для администраторов
- Полная JSDoc документация