mikrotik-bot/README.md

Telegram-бот для мониторинга и управления MikroTik

Описание

Бот для 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