Гайд - Исходники - Бот - KDS Server Panel Bot [САМОПИСНЫЙ ПРОЕКТ] | End Way — сообщество разработчиков и готовых решений
  • Больше материалов без ожидания и лишних условий
    Доступ к скрытым публикациям на 2 месяца, 3 месяца или навсегда. Ограничения «Команда форума» и «Личный» сохраняются.

    Сравнить варианты доступа →

    🔔 EndWay в Telegram

    Следите за новостями и релизами:
    EndWay | EndSoft

Гайд Исходники Бот KDS Server Panel Bot [САМОПИСНЫЙ ПРОЕКТ]

KodoDrive

Бот
Автор темы
5 Янв 2025
123
224

KDS Server Panel Bot​

Python Version Aiogram Version License Status

Мощный и безопасный 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_IDTelegram 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_IDID вашего магазина в Ю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)​

 
Последнее редактирование:
  • 10
Реакции: 9 users

andrubenko

Миддл
9 Янв 2024
68
15
KodoDrive, Та то у меня нема шобы скачать :brff а он данные не сливает никуда моих серваков? А тоу меня куча серверов пздц в putty невсегда удобно, так бы было топ разбить по категориям, по проектам серваки например и через ТГ управлять ими или тамкоманды прям с ТГ писать либо установить что-то, есть куча альтернатив putty но там как-то привык уже
 
Активность:
Пока что здесь никого нет