Files
PrimoGuardBot/.env_example

269 lines
14 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║ КОНФИГУРАЦИЯ TELEGRAM БОТА ║
# ║ ║
# ║ Инструкция: ║
# ║ 1. Скопируйте этот файл и переименуйте в .env ║
# ║ 2. Заполните обязательные поля (отмечены [ОБЯЗАТЕЛЬНО]) ║
# ║ 3. Настройте опциональные параметры по необходимости ║
# ║ ║
# ╚═══════════════════════════════════════════════════════════════════════════╝
# ═══════════════════════════════════════════════════════════════════════════
# МИНИМАЛЬНАЯ КОНФИГУРАЦИЯ (только обязательные поля)
# ═══════════════════════════════════════════════════════════════════════════
# [ОБЯЗАТЕЛЬНО] Токен бота от @BotFather
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
# [ОБЯЗАТЕЛЬНО] ID владельцев (узнать: @userinfobot)
OWNER_ID=123456789
# [ОБЯЗАТЕЛЬНО] ID админского чата (узнать: @username_to_id_bot)
ADMIN_CHAT_ID=-1001234567890
# ═══════════════════════════════════════════════════════════════════════════
# 🤖 ТОКЕН БОТА
# ═══════════════════════════════════════════════════════════════════════════
# [ОБЯЗАТЕЛЬНО] Токен бота от @BotFather
# Как получить: отправьте /newbot боту @BotFather и следуйте инструкциям
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
# ═══════════════════════════════════════════════════════════════════════════
# 👤 АДМИНИСТРАТОРЫ И ID
# ═══════════════════════════════════════════════════════════════════════════
# [ОБЯЗАТЕЛЬНО] ID владельцев бота (список через запятую)
# Как узнать свой ID: отправьте сообщение боту @userinfobot
OWNER_ID=123456789,987654321
# [ОБЯЗАТЕЛЬНО] ID чата для уведомлений админов (куда бот будет слать логи о спаме)
# Для группы: добавьте бота в группу и используйте бота @username_to_id_bot
ADMIN_CHAT_ID=-1001234567890
# Дополнительные админы (не суперадмины, но имеют доступ к командам)
# Необязательно, можно оставить пустым
ADMIN_ID=111111111,222222222
# ═══════════════════════════════════════════════════════════════════════════
# ⚙️ ОСНОВНЫЕ НАСТРОЙКИ БОТА
# ═══════════════════════════════════════════════════════════════════════════
# Имя бота (отображается в /start и описании)
BOT_NAME=Первозданная Жемчужина
# Описание бота (длинное, до 512 символов)
# Если не указано, будет сгенерировано автоматически
# BOT_DESCRIPTION=Бот-модератор для защиты чата от спама и нецензурных слов
# Короткое описание (до 120 символов)
# Если не указано, будет сгенерировано автоматически
# BOT_SHORT_DESCRIPTION=Тех.поддержка: @verdise
# Путь к фото профиля бота (необязательно)
# BOT_PHOTO=./assets/bot_avatar.jpg
# ═══════════════════════════════════════════════════════════════════════════
# 💬 НАСТРОЙКИ СООБЩЕНИЙ
# ═══════════════════════════════════════════════════════════════════════════
# Режим разметки текста (HTML, Markdown, MarkdownV2)
PARSE_MODE=HTML
# Префиксы команд (символы, которые могут начинать команды)
PREFIX=/!.&?
# Отключить звуковые уведомления при отправке сообщений ботом
DISABLE_NOTIFICATION=false
# Защитить контент от пересылки и сохранения
PROTECT_CONTENT=false
# Разрешить отправку без ответа на реплай
ALLOW_SENDING_WITHOUT_REPLY=true
# Настройки превью ссылок
LINK_PREVIEW_IS_DISABLED=false
LINK_PREVIEW_PREFER_SMALL_MEDIA=false
LINK_PREVIEW_PREFER_LARGE_MEDIA=true
LINK_PREVIEW_SHOW_ABOVE_TEXT=true
# Показывать подпись над медиа
SHOW_CAPTION_ABOVE_MEDIA=false
# ═══════════════════════════════════════════════════════════════════════════
# 📝 ЛОГИРОВАНИЕ
# ═══════════════════════════════════════════════════════════════════════════
# Включить логи в консоль
LOG_CONSOLE=true
# Включить логи в файл
LOG_FILE=true
# Директория для логов
LOG_DIR=Logs
# Имя файла с общей информацией
LOG_FILE_INFO=bot_info.log
# Ротация логов (размер файла для создания нового)
# Примеры: 100 MB, 500 MB, 1 GB
LOG_ROTATION=100 MB
# Время хранения старых логов
# Примеры: 7 days, 30 days, 1 week, 1 month
LOG_RETENTION=7 days
# Выводить информацию о старте в консоль
START_INFO_CONSOLE=true
# Выводить информацию о старте в файл
START_INFO_TO_FILE=true
# ═══════════════════════════════════════════════════════════════════════════
# 🌐 WEBHOOK (опционально)
# ═══════════════════════════════════════════════════════════════════════════
# Использовать вебхук вместо long polling
# false = long polling (рекомендуется для начинающих)
# true = webhook (требует публичный HTTPS домен)
WEBHOOK=false
# URL вебхука (обязателен если WEBHOOK=true)
# Должен быть публичный HTTPS адрес
# WEBHOOK_URL=https://your-domain.com/webhook
# Секретный токен для вебхука (генерируется автоматически если не указан)
# SECRET_TOKEN=your-secret-token-here
# Хост для uvicorn (внутренний адрес сервера)
WEBAPP_HOST=0.0.0.0
# Порт для uvicorn
WEBAPP_PORT=3131
# Уровень логов для uvicorn (debug, info, warning, error, critical)
LOG_LEVEL=warning
# Включить access log для uvicorn
ACCES_LOG=false
# ═══════════════════════════════════════════════════════════════════════════
# 🔑 API КЛЮЧИ (опционально)
# ═══════════════════════════════════════════════════════════════════════════
# Различные API ключи для интеграций
# Заполните только те, которые используете
# Общий API ключ
# API_KEY=your-api-key-here
# Web API ключ
# WEB_API_KEY=your-web-api-key-here
# API ключ для погоды (например, OpenWeatherMap)
# WEATHER_API_KEY=your-weather-api-key-here
# ═══════════════════════════════════════════════════════════════════════════
# 👮 ПРАВА АДМИНИСТРАТОРА БОТА
# ═══════════════════════════════════════════════════════════════════════════
# Разрешить боту редактировать свой профиль при старте
BOT_EDIT=false
# Анонимный администратор
ANONYMOUS=false
# Управление чатом
MANAGE_CHAT=true
# Изменение информации о чате
CHANGE_INFO=true
# Повышение участников
PROMOTE_MEMBERS=true
# Ограничение участников (бан, мут)
RESTRICT_MEMBERS=true
# Публикация сообщений (для каналов)
POST_MESSAGE=true
# Управление темами (топиками)
MANAGE_TOPICS=true
# Приглашение пользователей
INVITE_USER=true
# Удаление сообщений
DELETE_MESSAGES=true
# Управление видеочатами
MANAGE_VIDEO_CHATS=true
# Редактирование сообщений (для каналов)
EDIT_MESSAGES=true
# Закрепление сообщений
PIN_MESSAGE=true
# Публикация историй
POST_STORIES=true
# Редактирование историй
EDIT_STORIES=true
# Удаление историй
DELETE_STORIES=true
# ═══════════════════════════════════════════════════════════════════════════
# 🚫 МОДЕРАТОР (банворды и фильтры)
# ═══════════════════════════════════════════════════════════════════════════
# Файл с запрещенными словами (JSON)
WORDS_FILE=banwords.json
# Директория для постов
POSTS_DIR=posts
# ═══════════════════════════════════════════════════════════════════════════
# 📌 ДОПОЛНИТЕЛЬНЫЕ НАСТРОЙКИ
# ═══════════════════════════════════════════════════════════════════════════
# === BACKGROUND TASKS ===
# Интервал очистки временных банвордов (часы)
CLEANUP_INTERVAL=1
# Интервал backup базы данных (часы)
BACKUP_INTERVAL=24
# Количество хранимых backup'ов
KEEP_BACKUPS=7
# Возраст старой статистики для удаления (дни)
STATS_MAX_AGE_DAYS=30
# ============ АВТОКОММЕНТАРИИ ============
# ID каналов через запятую (узнать через @userinfobot)
AUTO_COMMENT_CHANNELS=-1001234567890
# Настройки по умолчанию (будут использоваться для новых каналов)
AUTO_COMMENT_TEXT=🔍 <b>Нужна помощь?</b>\n\nИспользуй наш сервис!
AUTO_COMMENT_BUTTON_TEXT=🌐 Искать в Google
AUTO_COMMENT_BUTTON_URL=https://www.google.com
AUTO_COMMENT_PHOTO_URL=https://via.placeholder.com/800x600.png