🌐 KVAS VPN Bot: Telegram-бот для управления списками сайтов на роутере

🔍 Обзор

KVAS VPN Bot - это Telegram-бот для управления списками блокировки сайтов на роутерах с использованием утилиты КВАС. С помощью этого бота вы можете легко добавлять, удалять и просматривать списки заблокированных сайтов прямо из Telegram.

🚨 Предварительные требования

Необходимые компоненты

• Роутер Keenetic с SSH-доступом
• Установленный Shadowsocks. Можно использовать мой скрипт для быстрой установки: Shadowsocks easy installer
• Установленная утилита КВАС
• Токен Telegram-бота от @BotFather

Поддерживаемые платформы

• Роутеры Keenetic c OpenWRT, установленном на USB-накопителе.

🛠 Установка

Шаг 1: Установка КВАС

Перед установкой бота убедитесь, что КВАС установлен:

# Следуйте руководству по установке КВАС:
# https://github.com/qzeleza/kvas/wiki/Установка-пакета

Шаг 2: Установка бота

Запустите скрипт установки:

hash -r && curl -sLf -o /opt/tmp/install_bot.sh https://github.com/flathead/kvas_bot/raw/main/scripts/install_bot.sh && sh /opt/tmp/install_bot.sh

Шаг 3: Конфигурация

В процессе установки вам потребуется указать:

• Токен Telegram-бота* (обязательно)
• ID разрешенных пользователей* (обязательно)
• Уровень логирования (опционально)

🛠 Обновление

Для обновления, находясь на сервере, выполните команду vpnbot upgrade

📋 Команды бота

/start: Запуск бота и доступ к главному меню

🖥 Функциональность

• Добавление сайтов в список разблокировки
• Удаление сайтов из списка разблокировки
• Просмотр текущего списка разблокировки
• Перезагрузка роутера
• Контроль доступа пользователей

🔒 Функции безопасности

• Белый список пользователей
• Ведение журнала ошибок
• Управление таймаутами

📦 Зависимости

• Python 3.10+
• python-telegram-bot
• asyncio
• python-dotenv

🛡️ Рекомендации по безопасности

• Ограничьте доступ к боту доверенными пользователями Telegram
• Регулярно обновляйте бот и утилиту КВАС

🔧 Устранение неполадок

• Убедитесь, что КВАС установлен корректно
• Проверьте сетевое подключение
• Изучите файлы журнала для получения подробной информации об ошибках Логи можно найти в /opt/apps/vpnbot/logs/router_bot.log, ошибки при монтировании бота можно найти в /var/log/vpnbot.log

🤝 Вклад

Приветствуются вклады, сообщения об ошибках и предложения функций!

📞 Поддержка

По вопросам и поддержке, пожалуйста, создайте issue на GitHub

🙏 Благодарности

• Проект КВАС