Мощный Telegram-бот для защиты твоих чатов

1. Управление пользователями в обход квиза или с его повторной инициацией: Администратор может вручную добавлять или удалять пользователей в базе данных:

• Если администратор процитирует сообщение пользователя и отправит команду /pass, квиз будет засчитан как успешно пройденный, а пользователь будет добавлен в базу.
• Если процитировать пользователя и отправить команду /quiz-again, его ID будет удалён из базы данных, и пользователю потребуется пройти квиз заново.

Добро пожаловать в Defender Bot — стильный, гибкий и надежный бот для Telegram, который автоматизирует модерацию, проводит викторины для новых участников и интегрируется с MySQL или PostgreSQL. Если ты хочешь, чтобы твои группы и форумы были под контролем, этот бот — твой лучший друг!

• Что тебе понадобится
• Установка шаг за шагом
• Настройка файла .env
  • Общие параметры
  • Примеры для MySQL и PostgreSQL
• Запуск бота
• Почему этот бот крутой

Перед тем, как начать, убедись, что у тебя есть:

• Docker — для запуска бота в контейнере.
• Git — если хочешь клонировать репозиторий (необязательно).
• Токен от BotFather — чтобы бот ожил.
• База данных — MySQL или PostgreSQL, на твой вкус.

Если запускаешь без Docker, тебе еще пригодится:

• Python 3.8+
• Библиотеки: aiogram, python-dotenv, asyncpg (для PostgreSQL), aiomysql (для MySQL), pydantic.

1. Склонируй репозиторий (если он у тебя есть):

   git clone https://github.com/yourusername/defender_bot.git
   cd defender_bot

2. Создай файл .env:

   • Скопируй пример:

     cp .env.example .env

   • Открой .env в редакторе и заполни его (смотри Настройка файла .env).

3. Докажи, что ты крутой — запусти установку:

   • Дай права скрипту:

     chmod +x install.sh

   • Запусти его:

     ./install.sh

Файл .env — это сердце твоего бота. Сначала заполни его, а потом запускай install.sh. Вот что нужно указать:

Важно: Если используешь Unix-сокет для MySQL, не указывай DB_PORT.

BOT_TOKEN=111111111:ABCDEFG
DB_TYPE=mysql
DB_USER=12341234
DB_PASSWORD=12341234
DB_NAME=defender_test
DB_HOST=localhost
DB_PORT=3306
ALLOWED_CHAT_ID=-13131231313123

BOT_TOKEN=111111111:ABCDEFG
DB_TYPE=mysql
DB_USER=12341234
DB_PASSWORD=12341234
DB_NAME=defender_test
DB_SOCKET=/var/run/mysqld/mysqld.sock
ALLOWED_CHAT_ID=-13131231313123

BOT_TOKEN=111111111:ABCDEFG
DB_TYPE=postgres
DB_USER=12341234
DB_PASSWORD=12341234
DB_NAME=defender_test
DB_HOST=localhost
DB_PORT=5432
ALLOWED_CHAT_ID=-13131231313123

1. Заполни .env — выбери один из примеров выше и настрой под себя.

2. Запусти install.sh:

   ./install.sh

   Скрипт сам:

   • Соберет Docker-образ.
   • Подключит бота к базе данных.
   • Покажет логи, чтобы ты убедился, что все работает как часы.

3. Проверь, что бот жив: Напиши ему в Telegram — он готов защищать твои чаты!

• Викторины для новичков — никаких спамеров в твоих группах.
• Баны под контролем — автоматизация на уровне богов.
• MySQL или PostgreSQL — выбирай, что тебе по душе.
• Docker — настрой один раз и забудь про проблемы.

С этим ботом ты будешь выглядеть как настоящий профи!