Telegram Invite Bot

📋 Обзор проекта

Telegram Invite Bot v6 — это мощный асинхронный бот для автоматизации сбора участников из Telegram-групп (парсинг) и массового приглашения пользователей (инвайтинг). Построен на современном стеке aiogram 3.17 + kurigram 2.2.22 (Pyrogram-совместимый MTProto клиент).

✨ Ключевые возможности

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

/root/tg/ipvb/6/
├── ipvb6.py                   # Главный файл (точка входа)
├── config.py                  # Конфигурация, логирование
├── utils.py                   # Утилиты
├── requirements.txt           # Зависимости
├── .env                       # Переменные окружения
├── proxies.json               # Файл с прокси
├── bot.log                    # Логи работы
├── docs.html                  # Данная документация
├── handlers/
│   ├── __init__.py            # Экспорт роутеров
│   ├── admin.py               # Проверка администраторов
│   ├── menu.py                # Главное меню
│   ├── sessions.py            # Управление сессиями
│   ├── lists.py               # Управление списками
│   ├── chats.py               # Управление чатами
│   ├── parsing.py             # Парсинг участников
│   ├── inviting.py            # Инвайтинг (оптимизированный)
│   ├── proxy.py               # Управление прокси
│   └── status.py              # Статус и статистика
├── sessions/                  # .session файлы
├── data/
│   ├── lists/                 # Текстовые списки username
│   ├── groups/                # JSON сохранённых групп
│   ├── callback_map.json      # Маппинг callback_data
│   ├── session_cache.json     # Кэш проверки сессий
│   └── status.json            # Статистика

⚡ Архитектура

Технологический стек

Поток обработки команд

Поток инвайтинга (оптимизированный)

🔍 Парсинг участников

Режимы парсинга

Сохранение результатов

• Автоматическое сохранение в файл list{N}.txt
• Возможность переименовать в именованный список
• Проверка username (чекер) перед использованием
• Скачивание файла через Telegram

🚀 Инвайтинг (движок PRO)

Ключевые улучшения v6

• Удалена блокирующая pre-валидация — больше не тратится время на resolve_username (было ~0.3 сек на username), что могло приводить к ошибке "нет доступных юзернеймов"
• Round-Robin распределение — нагрузка равномерно распределяется по всем выбранным сессиям
• Параллельное присоединение к группам — все сессии присоединяются через asyncio.gather
• Автоматическое исключение замёрзших сессий — проверка кэша перед запуском
• Загрузка .txt файлов — теперь можно отправить текстовый файл со списком username
• Умные задержки — 8-20 сек между приглашениями, адаптивные паузы при FloodWait
• Детальный отчёт — добавлено/пропущено/ошибок с разбивкой по причинам

Процесс инвайтинга

1. Выбор группы (по ссылке или из сохранённых)
2. Выбор режима проверки прав (с проверкой / без)
3. Выбор сессий для работы
4. Выбор источника username (список, ручной ввод, .txt файл)
5. Подтверждение и запуск
6. Прогресс-бар с ETA, скоростью, текущим username
7. Финальный отчёт со статистикой

🔐 Управление сессиями

Возможности

• Проверка сессии — подключение к Telegram, получение информации об аккаунте
• Кэширование статусов — ✅ активна, ❄️ заморожена, 🚫 недействительна, ⚠️ не проверена
• Массовый чекер — проверка всех сессий с прогресс-баром и кнопкой отмены
• Фильтр нерабочих — автоматическое удаление замёрзших/недействительных сессий
• ZIP экспорт/импорт — скачать все сессии архивом или загрузить из архива
• Добавление/удаление — загрузка .session файла через Telegram

📋 Управление списками

• Создание списков username с именем
• Просмотр содержимого с пагинацией
• Переименование и удаление
• Скачивание файла
• Чекер username — проверка валидности username (длина, символы)

🛡️ Прокси

• Поддержка SOCKS5, SOCKS4, HTTP прокси
• Два источника: ENV переменные и файл proxies.json
• Автоматическая ротация при каждом подключении
• Маскирование IP при отображении (безопасность)
• Валидация формата при добавлении

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

Требования

• Python 3.9 или выше
• Telegram Bot Token (получить у @BotFather)
• API ID и API Hash (получить на my.telegram.org)
• .session файлы аккаунтов (создать через Pyrogram/Kurigram)

Установка

git clone <repository> /root/tg/ipvb/6
cd /root/tg/ipvb/6
pip install -r requirements.txt

# Настройка .env:
cp .env.example .env
# Отредактировать .env: BOT_TOKEN, ADMIN_IDS, API_ID, API_HASH

# Поместить .session файлы в папку sessions/

# Запуск:
python3 ipvb6.py

Команды

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

• Проверка прав доступа через ADMIN_IDS
• Лимиты загрузки: .session до 100KB, ZIP до 10MB
• Защита от ZIP-bomb (лимит 50MB распакованного)
• Санация имён файлов (только alphanumeric, ._-)
• Логирование всех действий с timestamp
• try/except в каждом обработчике
• Автоматическое закрытие MTProto клиентов при ошибках
• Глобальная блокировка инвайтинга (одновременно только один процесс)
• Маскирование прокси в выводе