mikrotik-bot/README.md

MikroTik Telegram Bot

🤖 Телеграм бот для мониторинга MikroTik роутеров

🚀 Возможности

• 📊 Мониторинг WiFi клиентов
• 📈 Статистика подключений
• 🔔 Уведомления о событиях
• 💾 История подключений
• 🔧 Управление через FastAPI

📦 Автоматическая сборка

Проект использует Gitea Actions для автоматической сборки и деплоя:

• ✅ Docker сборка
• ✅ Загрузка в Registry
• ✅ Автоматический деплой

🛠️ Технологии

• Python 3.10+
• aiogram3 - Telegram Bot API
• librouteros - MikroTik API
• FastAPI - HTTP API
• SQLite - База данных
• Docker - Контейнеризация

Описание

Бот для Telegram, который позволяет:

• Получать уведомления о новых Wi-Fi-подключениях, пропадании интернета, статистике
• Управлять устройствами (VLAN, блокировка, просмотр клиентов)
• Работать только через RouterOS API (минимум fetch-скриптов)

Архитектура

• Python 3.10+
• aiogram (Telegram-бот)
• librouteros (интеграция с MikroTik API)
• Docker или virtualenv для изоляции

Быстрый старт (Docker)

1. Клонируй репозиторий или скопируй папку
2. Заполни .env (пример см. .env.example)
3. Собери и запусти контейнер:

   docker build -t mikrotik-telegram-bot .
   docker run --env-file .env --restart unless-stopped mikrotik-telegram-bot
   

4. Для автоматического обновления через Portainer используй Watchtower или настрой auto-pull (если репозиторий в GitHub/GitLab).

Быстрый старт (без Docker)

1. pip install -r requirements.txt
2. Заполни .env
3. python bot.py

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

• Токен Telegram и доступ к MikroTik храни только в .env
• Ограничь доступ к боту по user_id

Документация

• Все примеры и расширения смотри в файлах mikrotik_home/7step_telegram_bot.md и bot.py