{"id":22203814,"url":"https://github.com/flathead/kvas_bot","last_synced_at":"2026-05-17T01:41:36.489Z","repository":{"id":264227095,"uuid":"892753009","full_name":"flathead/kvas_bot","owner":"flathead","description":"Полностью готовый Telegram-бот для роутеров Keenetic, позволяющий управлять КВАСом не прибегая к SSH.","archived":false,"fork":false,"pushed_at":"2024-11-30T02:42:40.000Z","size":17543,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T03:43:34.244Z","etag":null,"topics":["keenetic","kvas","shadowsocks","vpn"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flathead.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-22T17:57:15.000Z","updated_at":"2024-11-30T02:42:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"c45c18f5-4c3e-42c4-b17c-fb6237552d97","html_url":"https://github.com/flathead/kvas_bot","commit_stats":null,"previous_names":["flathead/kvas_bot"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flathead%2Fkvas_bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flathead%2Fkvas_bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flathead%2Fkvas_bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flathead%2Fkvas_bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flathead","download_url":"https://codeload.github.com/flathead/kvas_bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245388748,"owners_count":20607163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["keenetic","kvas","shadowsocks","vpn"],"created_at":"2024-12-02T17:14:29.537Z","updated_at":"2026-05-17T01:41:31.453Z","avatar_url":"https://github.com/flathead.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 KVAS VPN Bot: Telegram-бот для управления списками сайтов на роутере\n\n[![GitHub License](https://img.shields.io/github/license/flathead/kvas_bot?color=blue)](https://github.com/flathead/kvas_bot/blob/main/LICENSE)\n[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\n## 🔍 Обзор\n\nKVAS VPN Bot - это Telegram-бот для управления списками блокировки сайтов на роутерах с использованием [утилиты КВАС](https://github.com/qzeleza/kvas). С помощью этого бота вы можете легко добавлять, удалять и просматривать списки заблокированных сайтов прямо из Telegram.\n\n## 🚨 Предварительные требования\n\n### Необходимые компоненты\n- Роутер Keenetic с SSH-доступом\n- Установленный Shadowsocks. Можно использовать мой скрипт для быстрой установки: [Shadowsocks easy installer](https://github.com/flathead/shadowsocks-installer)\n- Установленная [утилита КВАС](https://github.com/qzeleza/kvas)\n- Токен Telegram-бота от [@BotFather](https://t.me/botfather)\n\n### Поддерживаемые платформы\n- Роутеры Keenetic c OpenWRT, установленном на USB-накопителе.\n\n## 🛠 Установка\n\n### Шаг 1: Установка КВАС\nПеред установкой бота убедитесь, что КВАС установлен:\n```bash\n# Следуйте руководству по установке КВАС:\n# https://github.com/qzeleza/kvas/wiki/Установка-пакета\n```\n\n### Шаг 2: Установка бота\n\nЗапустите скрипт установки:\n\n```bash\nhash -r \u0026\u0026 curl -sLf -o /opt/tmp/install_bot.sh https://github.com/flathead/kvas_bot/raw/main/scripts/install_bot.sh \u0026\u0026 sh /opt/tmp/install_bot.sh\n```\n\n### Шаг 3: Конфигурация\nВ процессе установки вам потребуется указать:\n\n- Токен Telegram-бота\u003cspan style=\"color:red\"\u003e*\u003c/span\u003e (обязательно)\n- ID разрешенных пользователей\u003cspan style=\"color:red\"\u003e*\u003c/span\u003e (обязательно)\n- Уровень логирования (опционально)\n\n## 🛠 Обновление\n\nДля обновления, находясь на сервере, выполните команду `vpnbot upgrade`\n\n## 📋 Команды бота\n\n`/start`: Запуск бота и доступ к главному меню\n\n## 🖥 Функциональность\n\n- Добавление сайтов в список разблокировки\n- Удаление сайтов из списка разблокировки\n- Просмотр текущего списка разблокировки\n- Перезагрузка роутера\n- Контроль доступа пользователей\n\n## 🔒 Функции безопасности\n\n- Белый список пользователей\n- Ведение журнала ошибок\n- Управление таймаутами\n\n## 📦 Зависимости\n\n- Python 3.10+\n- `python-telegram-bot`\n- `asyncio`\n- `python-dotenv`\n\n## 🛡️ Рекомендации по безопасности\n\n- Ограничьте доступ к боту доверенными пользователями Telegram\n- Регулярно обновляйте бот и [утилиту КВАС](https://github.com/qzeleza/kvas)\n\n## 🔧 Устранение неполадок\n\n- Убедитесь, что КВАС установлен корректно\n- Проверьте сетевое подключение\n- Изучите файлы журнала для получения подробной информации об ошибках\n  Логи можно найти в `/opt/apps/vpnbot/logs/router_bot.log`, ошибки при монтировании бота можно найти в `/var/log/vpnbot.log`\n\n## 🤝 Вклад\n\nПриветствуются вклады, сообщения об ошибках и предложения функций!\n\n## 📞 Поддержка\n\nПо вопросам и поддержке, пожалуйста, создайте issue на GitHub\n\n## 🙏 Благодарности\n\n- [Проект КВАС](https://github.com/qzeleza/kvas)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflathead%2Fkvas_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflathead%2Fkvas_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflathead%2Fkvas_bot/lists"}