129 lines
4.0 KiB
Markdown
129 lines
4.0 KiB
Markdown
# MC Panel - Панель управления Minecraft серверами
|
||
|
||
Панель управления для Minecraft серверов с FastAPI бэкендом и React фронтендом.
|
||
|
||
## Возможности
|
||
|
||
- ➕ Создание новых серверов
|
||
- 🎮 Запуск и остановка серверов
|
||
- 💻 Консоль с отправкой команд в реальном времени
|
||
- 📁 Менеджер файлов:
|
||
- Загрузка и скачивание файлов
|
||
- Просмотр содержимого файлов
|
||
- Редактирование текстовых файлов
|
||
- Переименование файлов и папок
|
||
- Удаление файлов и папок
|
||
- 📊 Мониторинг ресурсов (CPU, ОЗУ, диск)
|
||
- ⚙️ Настройки сервера (название, команда запуска)
|
||
- 🗑️ Удаление серверов
|
||
- 🔄 Автообновление статистики
|
||
|
||
## Установка
|
||
|
||
### Бэкенд
|
||
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
python main.py
|
||
```
|
||
|
||
Сервер запустится на http://0.0.0.0:8000
|
||
|
||
### Фронтенд
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev -- --host
|
||
```
|
||
|
||
Приложение откроется на http://localhost:3000
|
||
|
||
## Доступ через сеть (Radmin VPN, Hamachi и т.д.)
|
||
|
||
### Вариант 1: Автоматическое определение (рекомендуется)
|
||
|
||
Фронтенд автоматически определит IP адрес и подключится к бэкенду.
|
||
|
||
1. Запустите бэкенд (он слушает на всех интерфейсах)
|
||
2. Запустите фронтенд с флагом `--host`:
|
||
```bash
|
||
npm run dev -- --host
|
||
```
|
||
3. Откройте в браузере: `http://ВАШ_IP:3000`
|
||
- Например: `http://26.123.45.67:3000` (Radmin VPN IP)
|
||
|
||
### Вариант 2: Ручная настройка
|
||
|
||
Создайте файл `frontend/.env.local`:
|
||
```
|
||
VITE_API_URL=http://26.123.45.67:8000
|
||
```
|
||
|
||
Замените `26.123.45.67` на ваш IP адрес в Radmin VPN.
|
||
|
||
### Проверка IP адреса
|
||
|
||
Windows:
|
||
```bash
|
||
ipconfig
|
||
```
|
||
|
||
Ищите адрес адаптера Radmin VPN (обычно начинается с 26.x.x.x)
|
||
|
||
## Структура
|
||
|
||
```
|
||
backend/
|
||
main.py # FastAPI сервер
|
||
requirements.txt # Зависимости Python
|
||
servers/ # Папка с серверами Minecraft
|
||
|
||
frontend/
|
||
src/
|
||
components/
|
||
Console.jsx # Компонент консоли
|
||
FileManager.jsx # Менеджер файлов
|
||
Stats.jsx # Статистика
|
||
App.jsx # Главный компонент
|
||
main.jsx # Точка входа
|
||
package.json # Зависимости Node.js
|
||
```
|
||
|
||
## Использование
|
||
|
||
### Быстрый старт
|
||
|
||
**Windows:**
|
||
```bash
|
||
START_PANEL.bat
|
||
```
|
||
|
||
**Вручную:**
|
||
```bash
|
||
# Терминал 1 - Бэкенд
|
||
cd backend
|
||
python main.py
|
||
|
||
# Терминал 2 - Фронтенд
|
||
cd frontend
|
||
npm run dev
|
||
```
|
||
|
||
Откройте в браузере: http://localhost:3000
|
||
|
||
### Создание сервера
|
||
|
||
1. Нажмите кнопку "+" для создания нового сервера
|
||
2. Укажите имя, отображаемое название и команду запуска
|
||
3. Загрузите файлы сервера (server.jar и т.д.) через менеджер файлов
|
||
4. Создайте файл `eula.txt` с содержимым `eula=true`
|
||
5. Запустите сервер и управляйте им через вкладки:
|
||
- **Консоль** - просмотр логов и отправка команд
|
||
- **Файлы** - управление файлами сервера
|
||
- **Статистика** - мониторинг ресурсов
|
||
- **Настройки** - изменение параметров сервера
|
||
|
||
Подробнее: см. `QUICK_START.md`
|