KDS Server Panel Bot
Мощный и безопасный Telegram-бот для управления вашими Linux-серверами по SSH. Позволяет выполнять команды, управлять файлами, отслеживать нагрузку на систему, а также включает в себя полнофункциональную админ-панель и систему платных подписок.
🚀 Основные возможности
Для Пользователей
- Управление серверами: Добавляйте, переименовывайте и удаляйте неограниченное количество серверов.
- Интерактивный SSH-терминал: Выполняйте команды на вашем сервере в режиме реального времени.
- Мониторинг: Получайте актуальную информацию о статусе сервера, времени его работы (Uptime), а также о нагрузке на CPU, RAM и дисковое пространство.
- Управление питанием: Безопасно перезагружайте (reboot) и выключайте (shutdown) ваш сервер.
- Встроенный файловый менеджер:
- Просматривайте файлы и папки на сервере.
- Скачивайте файлы с сервера прямо в чат Telegram (до 50 МБ).
- Загружайте файлы с компьютера или телефона на сервер (до 20 МБ).
- Безопасность: Смена пароля от сервера прямо из меню настроек.
- VIP-подписка: Покупайте VIP-статус для получения расширенных возможностей через ЮKassa или CryptoBot (USDT).
🛠️ Для Администратора
- Комплексная Админ-панель: Полноценная панель управления ботом.
- Массовая рассылка: Отправляйте информационные сообщения всем пользователям бота (поддерживается любой тип контента).
- Управление пользователями:
- Находите любого пользователя по его Telegram ID.
- Просматривайте подробную информацию о пользователе (статус VIP, количество серверов).
- Выдавайте и отзывайте VIP-статус вручную.
- Отправляйте личные сообщения любому пользователю.
- Управление серверами:
- Находите любой сервер в базе данных по его ID.
- Просматривайте информацию о сервере и его владельце.
- Удаляйте любой сервер из системы.
- VIP-управление:
- Просматривайте постраничный список всех активных VIP-пользователей с датами окончания подписки.
- Динамическое управление контентом:
- Изменяйте ключевые тексты бота (приветствие, информация о VIP, текст поддержки) прямо из админ-панели без перезапуска.
- Экспорт данных:
- Выгружайте полные бэкапы таблиц users и servers в CSV-формате.
💻 Стек технологий
- Язык: Python 3.10+
- Telegram Framework: Aiogram 3.x
- Веб-сервер: Aiohttp (для обработки вебхуков Telegram и платежных систем)
- База данных: PostgreSQL
- Взаимодействие с БД: Asyncpg
- SSH/SFTP: AsyncSSH
- Шифрование: Cryptography (Fernet)
- Оркестрация: Docker & Docker Compose
⚙️ Установка и запуск
Проект полностью упакован в Docker, что делает его запуск максимально простым и изолированным.1. Предварительные требования
Убедитесь, что на вашем сервере установлены:- git
- docker
- docker-compose
2. Клонирование репозитория
Код:
git clone https://github.com/svod011929/KDS_Server_Panel.git
cd KDS_Server_Panel 3. Создание файла конфигурации
В проекте используется .env файл для хранения всех секретных данных. Скопируйте пример, чтобы создать свой файл конфигурации. Код:
cp .env.example .env ВНИМАНИЕ: Файл .env содержит чувствительные данные. Убедитесь, что он добавлен в .gitignore и никогда не попадет в публичный репозиторий!
4. Настройка переменных окружения
Откройте файл .env любым текстовым редактором (например, nano .env) и заполните все переменные. Подробное описание каждой переменной находится ниже.5. Запуск проекта
Просто выполните команду в корневой папке проекта: Код:
sudo docker-compose up --build -d - --build — флаг для пересборки контейнеров, если вы вносили изменения в код.
- -d — флаг для запуска в фоновом (detached) режиме.
Полезные команды Docker
- Просмотр логов бота в реальном времени:
Код:sudo docker-compose logs -f bot
- Остановка проекта:
Код:sudo docker-compose down
🔑 Переменные окружения (.env)
Это самый важный шаг конфигурации.| Переменная | Описание | Пример |
|---|---|---|
| BOT_TOKEN | Токен вашего бота. Получить у @BotFather. | 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
| ADMIN_ID | Telegram ID главного администратора. Получить у @userinfobot. | 123456789 |
| SUPPORT_USERNAME | Юзернейм для связи с поддержкой. Будет показан пользователям. | @your_support_username |
| ENCRYPTION_KEY | (Критически важно!) Ключ для шифрования паролей. Сгенерируйте один раз и никогда не меняйте! | ... (см. инструкцию ниже) |
| POSTGRES_USER | Имя пользователя для базы данных. | myuser |
| POSTGRES_PASSWORD | Пароль для пользователя базы данных. | mystrongpassword |
| POSTGRES_DB | Название базы данных. | kds_panel |
| DB_HOST | Хост для подключения к БД из контейнера бота. Оставьте db. | db |
| DB_PORT | Порт базы данных. Оставьте 5432. | 5432 |
| YK_SHOP_ID | ID вашего магазина в ЮKassa. | ... |
| YK_SECRET_KEY | Секретный ключ вашего магазина в ЮKassa. | ... |
| CRYPTO_PAY_TOKEN | Токен вашего приложения в CryptoBot. | ... |
Как сгенерировать ENCRYPTION_KEY
Этот ключ используется для шифрования паролей от серверов в базе данных. Если вы его поменяете, доступ ко всем ранее добавленным серверам будет утерян.Выполните эту команду на машине с Python, чтобы получить ключ, и вставьте его в .env файл:
Код:
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())" 📂 Структура проекта
KDS_Server_Panel/├── app/ # Основной код приложения
│ ├── keyboards/ # Модули для создания клавиатур
│ │ └── inline.py
│ ├── utils/ # Вспомогательные утилиты
│ │ ├── crypto.py # Шифрование паролей
│ │ └── ssh.py # Вся логика SSH и SFTP
│ └── app.py # Главный файл бота: хендлеры, FSM, запуск
├── .env # (Локальный) Файл с секретными переменными
├── .env.example # Пример файла .env для репозитория
├── .gitignore # Файл с исключениями для Git
├── create_tables.sql # SQL-схема для инициализации таблиц
├── docker-compose.yml # Файл для оркестрации Docker-контейнеров
└── Dockerfile # Инструкция по сборке Docker-образа для бота
📄 Лицензия
Проект распространяется под лицензией MIT. Подробности в файле LICENSE.
UPD: понизил планку хайда, смотрите пользуйтесь, на GitHub залил полностью всю документацию, в том числе и для разработчиков (см. DEVELOPER.md)
Последнее редактирование:
реакций нема, но годно
а он данные не сливает никуда моих серваков? А тоу меня куча серверов пздц в putty невсегда удобно, так бы было топ разбить по категориям, по проектам серваки например и через ТГ управлять ими или тамкоманды прям с ТГ писать либо установить что-то, есть куча альтернатив putty но там как-то привык уже