AIxPROTECT

FAQ - Часто задаваемые вопросы


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

1. Получение Bot Token
  1. Откройте Telegram и найдите @BotFather
  2. Отправьте команду /newbot
  3. Следуйте инструкциям и сохраните полученный Bot Token
2. Получение вашего User ID
  1. Откройте @userinfobot
  2. Отправьте /start
  3. Сохраните ваш User ID
3. Получение OpenAI API Key
  1. Зарегистрируйтесь на OpenAI
  2. Создайте API ключ в разделе API Keys
  3. Сохраните API Key
4. Настройка через веб-админку
Все настройки теперь через веб-интерфейс!
Перейдите в раздел Settings и заполните:
  • TELEGRAM_BOT_TOKEN - токен от @BotFather
  • OWNER_USER_ID - ваш Telegram ID
  • OPENAI_API_KEY - ключ OpenAI (опционально)
Все инструкции с ссылками есть прямо на странице Settings!

Пароль по умолчанию: admin123 (измените в production!)

5. Перезапуск после настройки
cd /root/telegram-ai-moderation
docker-compose restart

Подключение канала/группы

Шаги подключения:
  1. Откройте вашу Telegram группу/канал
  2. Добавьте бота как администратора
  3. Выдайте права:
    • ✅ Delete messages (удаление сообщений)
    • ✅ Ban users (бан пользователей)
    • ✅ Restrict members (ограничение участников)
  4. Бот автоматически определит подключение
  5. Канал появится в разделе Chats
Важно: Без прав администратора модерация работать не будет!

Политика модерации

Zero Tolerance - Наркотики
⚠️ КРИТИЧНО: Любое упоминание наркотиков приводит к:
  • Немедленному удалению сообщения
  • Перманентному бану пользователя
  • Уведомлению владельца
Нет предупреждений. Нет второго шанса.
Система 1-2-3 для спама/дубликатов
  • 1-е нарушение: Удаление + предупреждение
  • 2-е нарушение: Удаление + предупреждение
  • 3-е нарушение: Удаление + перманентный бан
Что детектируется:
  • Наркотики (прямые названия, сленг, эмодзи-коды, обфускация)
  • Точные дубликаты сообщений
  • Похожие сообщения (fuzzy matching ≥85%)
  • Шаблонный спам от одного пользователя
  • Кастомные правила (настраиваются в Rules)

Платные криптовалютные объявления

Статус: Система реализована и готова к тестированию. Требуется настройка перед использованием.
💰 Как это работает

Система автоматически определяет криптовалютные объявления через AI и требует оплату $1 за каждое объявление.

$1

За объявление

$50

Минимальный депозит

TRC20

USDT Tron
🎯 Сценарий использования
  1. Пользователь БЕЗ баланса отправляет крипто-рекламу:
    • ❌ Сообщение удаляется
    • 📨 Получает PM с уникальным TRC20 адресом
    • 💰 Инструкции: минимум $50 USDT
  2. Пользователь делает депозит:
    • ⏳ Система мониторит blockchain (каждые 60 сек)
    • ✅ После 19 подтверждений (~1 мин) кредиты зачисляются
    • 📨 Отправляется уведомление о депозите
  3. Пользователь С балансом отправляет крипто-рекламу:
    • ✅ Списывается 1 кредит ($1)
    • ✅ Сообщение РАЗРЕШАЕТСЯ
    • 📊 Обновляется баланс
⚙️ Настройка (для администратора)

pip3 install tronpy==0.4.0
docker-compose restart app

КРИТИЧНО: Master seed используется для генерации ВСЕХ пользовательских кошельков. Храните в безопасности!
python3 << 'EOF'
import sqlite3, secrets

# Generate seed
master_seed = secrets.token_hex(32)

# Add to database
conn = sqlite3.connect('data/moderation.db')
cursor = conn.cursor()
cursor.execute("""
    INSERT OR REPLACE INTO settings (key, value, value_type, description, is_sensitive)
    VALUES (?, ?, ?, ?, ?)
""", ('TRON_MASTER_SEED', master_seed, 'string', 'Master seed for HD wallet derivation', 1))
conn.commit()
conn.close()

print(f"✅ TRON_MASTER_SEED: {master_seed}")
print("\n⚠️  BACKUP THIS SEED SECURELY!")
EOF

  1. Перейдите в раздел Chats
  2. Нажмите "Edit" на нужном канале
  3. Включите опцию "Enable Crypto Payments"
  4. Сохраните изменения
Важно: Crypto payments работают только для каналов, где эта опция включена. По умолчанию - выключено для всех каналов.

Внимание: НЕ запускайте мониторинг без предварительного тестирования!

Тестирование:

python3 << 'EOF'
import asyncio
from app.services.crypto_monitor_service import get_crypto_monitor_service

async def test():
    monitor = get_crypto_monitor_service()
    await monitor.initialize()
    current_block = await monitor.get_current_block()
    print(f"✅ Current Tron block: {current_block}")

asyncio.run(test())
EOF

Запуск мониторинга: Добавьте в startup код приложения после успешного тестирования.

📱 Команды для пользователей
  • /balance - Проверить баланс, адрес кошелька, статистику
  • /cryptotx - История депозитов и объявлений
🔧 Troubleshooting
Проблема Решение
"tronpy not installed" pip3 install tronpy==0.4.0
"TRON_MASTER_SEED not configured" Выполните Шаг 2 выше
Депозиты не обнаруживаются 1. Проверьте что monitoring запущен
2. Транзакция = USDT TRC20 (не TRX!)
3. Минимум $50 USDT
4. Правильный адрес
Объявления удаляются с балансом 1. Проверьте что crypto_payment_enabled=true для канала
2. Проверьте баланс в базе
3. Смотрите логи pipeline
🔐 Безопасность
TRON_MASTER_SEED - КРИТИЧЕСКИЙ СЕКРЕТ!

НЕОБХОДИМО:

  • ✅ Хранить в password manager (зашифровано)
  • ✅ Создать backup (зашифрованный, offline)
  • ✅ Ограничить доступ (только owner)
  • ❌ НИКОГДА не коммитить в git
  • ❌ НИКОГДА не логировать в plaintext
📊 Как проверить статус
# Проверить TRON_MASTER_SEED настроен
python3 -c "from app.config import settings; print(f'Configured: {settings.tron_master_seed is not None}')"

# Проверить crypto tables
python3 -c "import sqlite3; conn = sqlite3.connect('data/moderation.db'); cursor = conn.cursor(); cursor.execute(\"SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'crypto%'\"); print([r[0] for r in cursor.fetchall()])"

# Проверить каналы с включенным crypto payment
python3 -c "import sqlite3; conn = sqlite3.connect('data/moderation.db'); cursor = conn.cursor(); cursor.execute(\"SELECT title, crypto_payment_enabled FROM moderated_chats\"); print([r for r in cursor.fetchall()])"

Использование веб-админки

Разделы:
  • Dashboard - метрики и статистика
  • Messages - все обработанные сообщения
  • Users - управление пользователями, баны
  • Rules - настройка правил модерации
  • Reports - суточные отчёты
  • Chats - управление подключёнными каналами
  • System - статус системы, настройки
Логин по умолчанию:
Username: admin
Password: admin123
⚠️ Измените пароль в production!

Решение проблем

Бот не отвечает
# Проверьте логи
docker-compose logs -f app

# Проверьте .env файл
nano /root/telegram-ai-moderation/.env

# Перезапустите
docker-compose restart
Веб-админка не открывается
# Проверьте статус контейнеров
docker-compose ps

# Проверьте порт 8000
netstat -tlnp | grep 8000

# Проверьте firewall
ufw status
ufw allow 8000/tcp
Redis connection error
# Перезапустите Redis
docker-compose restart redis

# Проверьте логи
docker-compose logs redis
OpenAI ошибки
  • Проверьте OPENAI_API_KEY в .env
  • Проверьте баланс на OpenAI
  • Временно отключите AI: ENABLE_AI_CLASSIFICATION=false

Полезные команды

Docker управление
# Просмотр логов
docker-compose logs -f

# Статус контейнеров
docker-compose ps

# Перезапуск
docker-compose restart

# Остановка
docker-compose down

# Полная пересборка
docker-compose down
docker-compose build --no-cache
docker-compose up -d
База данных
# Применить миграции
docker-compose exec app alembic upgrade head

# Откат миграции
docker-compose exec app alembic downgrade -1

# Создать новую миграцию
docker-compose exec app alembic revision --autogenerate -m "description"
Backup
# Backup базы данных
cp /root/telegram-ai-moderation/data/moderation.db \
   /root/telegram-ai-moderation/data/moderation.db.backup.$(date +%Y%m%d)

# Автоматический backup (добавить в cron)
0 3 * * * cp /root/telegram-ai-moderation/data/moderation.db \
   /root/telegram-ai-moderation/data/moderation.db.backup.$(date +\%Y\%m\%d)

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

Рекомендации для production:
  1. Измените пароль администратора!
    python3 -m app.utils.create_admin
  2. Настройте HTTPS (nginx или traefik)
  3. Ограничьте доступ к портам
    ufw allow 80/tcp
    ufw allow 443/tcp
    ufw deny 8000/tcp  # закрыть прямой доступ
  4. Регулярно обновляйте зависимости
  5. Настройте backup базы данных
  6. Мониторинг логов на подозрительную активность
Никогда не коммитьте .env файл в git!

API Documentation

Автоматическая документация API доступна по адресам:

Пример использования API:
# Получить токен
curl -X POST "http://localhost:8000/api/auth/login" \
  -F "username=admin" \
  -F "password=admin123"

# Использовать токен
curl -H "Authorization: Bearer TOKEN" \
  "http://localhost:8000/api/dashboard/stats"

Полезные ссылки