Added Daemon system and fixed interface
All checks were successful
continuous-integration/drone/push Build is passing

This commit is contained in:
2026-01-16 18:56:21 +06:00
parent fbfddf3c7a
commit d188cec1f0
24 changed files with 1974 additions and 4985 deletions

11
daemon/.env Normal file
View File

@@ -0,0 +1,11 @@
# Daemon Configuration
DAEMON_ID=daemon-1
DAEMON_NAME=Main
DAEMON_PORT=24444
DAEMON_KEY=JLgYFjTlFOqdyT49vmCqlXrLAuVE6FjiCdqf3zsZfr4
# Panel Connection (optional, for WebSocket)
PANEL_URL=ws://0.0.0.0:8000
# Servers Directory
SERVERS_DIR=./servers

20
daemon/.env.example Normal file
View File

@@ -0,0 +1,20 @@
# MC Panel Daemon Configuration
# Уникальный ID демона
DAEMON_ID=daemon-1
# Название демона (отображается в панели)
DAEMON_NAME=Main Server
# Порт, на котором будет работать демон
DAEMON_PORT=24444
# Секретный ключ для аутентификации (должен совпадать с ключом в панели)
# Сгенерируйте случайный ключ: python -c "import secrets; print(secrets.token_urlsafe(32))"
DAEMON_KEY=your-secret-key-here
# URL основной панели (для WebSocket подключения, опционально)
PANEL_URL=http://your-panel-url:8000
# Директория для серверов
SERVERS_DIR=./servers

195
daemon/README.md Normal file
View File

@@ -0,0 +1,195 @@
# MC Panel Daemon
Удаленный демон для управления серверами Minecraft. Устанавливается на отдельные физические серверы и подключается к основной панели управления.
## Установка
### Windows
1. Установите Python 3.8 или выше
2. Скопируйте папку `daemon` на удаленный сервер
3. Откройте командную строку в папке daemon
4. Запустите установку зависимостей:
```
install.bat
```
### Linux
1. Установите Python 3.8 или выше
2. Скопируйте папку `daemon` на удаленный сервер
3. Установите зависимости:
```bash
pip install -r requirements.txt
```
## Настройка
1. Скопируйте `.env.example` в `.env`:
```
copy .env.example .env
```
2. Отредактируйте `.env` файл:
```env
DAEMON_ID=daemon-1
DAEMON_NAME=Main Server
DAEMON_PORT=24444
DAEMON_KEY=your-secret-key-here
SERVERS_DIR=./servers
```
- `DAEMON_ID` - уникальный ID демона
- `DAEMON_NAME` - отображаемое имя демона
- `DAEMON_PORT` - порт для API (по умолчанию 24444)
- `DAEMON_KEY` - секретный ключ для аутентификации
- `SERVERS_DIR` - директория для серверов
3. Создайте секретный ключ:
```python
import secrets
print(secrets.token_urlsafe(32))
```
## Запуск
### Windows
```
start.bat
```
### Linux
```bash
python main.py
```
### Как сервис (Linux)
Создайте файл `/etc/systemd/system/mcpanel-daemon.service`:
```ini
[Unit]
Description=MC Panel Daemon
After=network.target
[Service]
Type=simple
User=mcpanel
WorkingDirectory=/path/to/daemon
ExecStart=/usr/bin/python3 /path/to/daemon/main.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
```
Запустите сервис:
```bash
sudo systemctl enable mcpanel-daemon
sudo systemctl start mcpanel-daemon
sudo systemctl status mcpanel-daemon
```
## Подключение к панели
1. Откройте основную панель управления
2. Перейдите в раздел "Демоны"
3. Нажмите "Добавить демон"
4. Заполните данные:
- **Название**: Main Server
- **IP адрес**: IP адрес сервера с демоном
- **Порт**: 24444 (или ваш порт)
- **Ключ демона**: ваш DAEMON_KEY из .env
5. Нажмите "Добавить"
## API Endpoints
Демон предоставляет следующие API endpoints:
- `GET /` - Информация о демоне
- `GET /api/status` - Статус демона и системы
- `GET /api/servers` - Список серверов
- `POST /api/servers/{name}/start` - Запустить сервер
- `POST /api/servers/{name}/stop` - Остановить сервер
- `POST /api/servers/{name}/command` - Отправить команду
- `GET /api/servers/{name}/stats` - Статистика сервера
## Безопасность
1. **Используйте сильный ключ** - генерируйте случайный ключ длиной минимум 32 символа
2. **Настройте файрвол** - разрешите доступ к порту демона только с IP основной панели
3. **Используйте HTTPS** - в продакшене используйте reverse proxy (nginx) с SSL
4. **Регулярно обновляйте** - следите за обновлениями и устанавливайте их
## Пример конфигурации nginx (с SSL)
```nginx
server {
listen 443 ssl http2;
server_name daemon.example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://127.0.0.1:24444;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
```
## Структура директорий
```
daemon/
├── main.py # Основной файл демона
├── requirements.txt # Зависимости Python
├── .env # Конфигурация (создайте из .env.example)
├── .env.example # Пример конфигурации
├── install.bat # Скрипт установки (Windows)
├── start.bat # Скрипт запуска (Windows)
├── README.md # Эта документация
└── servers/ # Директория с серверами
├── server1/
│ ├── config.json
│ └── ...
└── server2/
├── config.json
└── ...
```
## Формат config.json для сервера
```json
{
"name": "server1",
"displayName": "My Minecraft Server",
"startCommand": "java -Xmx2G -Xms1G -jar server.jar nogui"
}
```
## Troubleshooting
### Демон не запускается
- Проверьте, что Python установлен: `python --version`
- Проверьте, что все зависимости установлены: `pip list`
- Проверьте логи в консоли
### Панель не может подключиться к демону
- Проверьте, что демон запущен
- Проверьте файрвол и порты
- Проверьте, что ключ в панели совпадает с DAEMON_KEY
- Проверьте IP адрес и порт
### Сервер не запускается
- Проверьте startCommand в config.json
- Проверьте права доступа к файлам
- Проверьте логи сервера
## Поддержка
Если у вас возникли проблемы, создайте тикет в системе поддержки панели.

9
daemon/install.bat Normal file
View File

@@ -0,0 +1,9 @@
@echo off
echo Installing MC Panel Daemon dependencies...
pip install -r requirements.txt
echo.
echo Installation complete!
echo.
echo Please configure .env file before starting the daemon
echo Copy .env.example to .env and edit it
pause

307
daemon/main.py Normal file
View File

@@ -0,0 +1,307 @@
"""
MC Panel Daemon - Удаленный демон для управления серверами
Устанавливается на отдельные серверы и подключается к основной панели
"""
import asyncio
import json
import os
import psutil
import subprocess
from datetime import datetime
from pathlib import Path
from typing import Dict, Optional
import websockets
from fastapi import FastAPI, HTTPException, Header
from fastapi.middleware.cors import CORSMiddleware
import uvicorn
from dotenv import load_dotenv
load_dotenv()
app = FastAPI(title="MC Panel Daemon")
# CORS
app.add_middleware(
CORSMiddleware,
allow_origins=["*"],
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
# Конфигурация
DAEMON_ID = os.getenv("DAEMON_ID", "daemon-1")
DAEMON_NAME = os.getenv("DAEMON_NAME", "Main Server")
DAEMON_PORT = int(os.getenv("DAEMON_PORT", "24444"))
DAEMON_KEY = os.getenv("DAEMON_KEY", "") # Ключ для аутентификации
PANEL_URL = os.getenv("PANEL_URL", "") # URL основной панели для WebSocket
SERVERS_DIR = Path(os.getenv("SERVERS_DIR", "./servers"))
# Создаем директорию для серверов
SERVERS_DIR.mkdir(exist_ok=True)
# Хранилище процессов серверов
server_processes: Dict[str, subprocess.Popen] = {}
def verify_key(authorization: str = Header(None)) -> bool:
"""Проверка API ключа"""
if not DAEMON_KEY:
return True # Если ключ не установлен, разрешаем доступ
if not authorization:
raise HTTPException(status_code=401, detail="Missing authorization header")
if authorization != f"Bearer {DAEMON_KEY}":
raise HTTPException(status_code=403, detail="Invalid daemon key")
return True
@app.get("/")
async def root():
"""Информация о демоне"""
return {
"daemon_id": DAEMON_ID,
"daemon_name": DAEMON_NAME,
"status": "online",
"version": "1.0.0"
}
@app.get("/api/status")
async def get_status(authorization: str = Header(None)):
"""Получить статус демона и системы"""
# Проверка ключа опциональна для статуса
if DAEMON_KEY and authorization:
if authorization != f"Bearer {DAEMON_KEY}":
raise HTTPException(status_code=403, detail="Invalid daemon key")
cpu_percent = psutil.cpu_percent(interval=1)
memory = psutil.virtual_memory()
disk = psutil.disk_usage('/')
return {
"daemon_id": DAEMON_ID,
"daemon_name": DAEMON_NAME,
"status": "online",
"system": {
"cpu_usage": cpu_percent,
"memory_total": memory.total,
"memory_used": memory.used,
"memory_percent": memory.percent,
"disk_total": disk.total,
"disk_used": disk.used,
"disk_percent": disk.percent
},
"servers": {
"total": len(list(SERVERS_DIR.iterdir())),
"running": len(server_processes)
},
"timestamp": datetime.now().isoformat()
}
@app.get("/api/servers")
async def list_servers(authorization: str = Header(None)):
"""Список всех серверов на этом демоне"""
verify_key(authorization)
servers = []
for server_dir in SERVERS_DIR.iterdir():
if server_dir.is_dir():
config_file = server_dir / "config.json"
if config_file.exists():
with open(config_file, 'r', encoding='utf-8') as f:
config = json.load(f)
servers.append({
"name": server_dir.name,
"display_name": config.get("displayName", server_dir.name),
"status": "running" if server_dir.name in server_processes else "stopped",
"daemon_id": DAEMON_ID
})
return servers
@app.post("/api/servers/{server_name}/start")
async def start_server(server_name: str, authorization: str = Header(None)):
"""Запустить сервер"""
verify_key(authorization)
server_dir = SERVERS_DIR / server_name
if not server_dir.exists():
raise HTTPException(status_code=404, detail="Server not found")
if server_name in server_processes:
raise HTTPException(status_code=400, detail="Server already running")
config_file = server_dir / "config.json"
if not config_file.exists():
raise HTTPException(status_code=400, detail="Server config not found")
with open(config_file, 'r', encoding='utf-8') as f:
config = json.load(f)
start_command = config.get("startCommand", "")
if not start_command:
raise HTTPException(status_code=400, detail="Start command not configured")
try:
# Запускаем процесс
process = subprocess.Popen(
start_command,
shell=True,
cwd=str(server_dir),
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
stdin=subprocess.PIPE
)
server_processes[server_name] = process
return {
"success": True,
"message": f"Server {server_name} started",
"pid": process.pid
}
except Exception as e:
raise HTTPException(status_code=500, detail=f"Failed to start server: {str(e)}")
@app.post("/api/servers/{server_name}/stop")
async def stop_server(server_name: str, authorization: str = Header(None)):
"""Остановить сервер"""
verify_key(authorization)
if server_name not in server_processes:
raise HTTPException(status_code=400, detail="Server not running")
try:
process = server_processes[server_name]
process.terminate()
# Ждем завершения процесса
try:
process.wait(timeout=10)
except subprocess.TimeoutExpired:
process.kill()
del server_processes[server_name]
return {
"success": True,
"message": f"Server {server_name} stopped"
}
except Exception as e:
raise HTTPException(status_code=500, detail=f"Failed to stop server: {str(e)}")
@app.post("/api/servers/{server_name}/command")
async def send_command(server_name: str, command: dict, authorization: str = Header(None)):
"""Отправить команду в консоль сервера"""
verify_key(authorization)
if server_name not in server_processes:
raise HTTPException(status_code=400, detail="Server not running")
try:
process = server_processes[server_name]
cmd = command.get("command", "")
if process.stdin:
process.stdin.write(f"{cmd}\n".encode())
process.stdin.flush()
return {
"success": True,
"message": "Command sent"
}
except Exception as e:
raise HTTPException(status_code=500, detail=f"Failed to send command: {str(e)}")
@app.get("/api/servers/{server_name}/stats")
async def get_server_stats(server_name: str, authorization: str = Header(None)):
"""Получить статистику сервера"""
verify_key(authorization)
server_dir = SERVERS_DIR / server_name
if not server_dir.exists():
raise HTTPException(status_code=404, detail="Server not found")
is_running = server_name in server_processes
cpu = 0
memory = 0
if is_running:
try:
process = server_processes[server_name]
p = psutil.Process(process.pid)
cpu = p.cpu_percent(interval=0.1)
memory = p.memory_info().rss / 1024 / 1024 # MB
except:
pass
# Размер директории
disk_usage = sum(f.stat().st_size for f in server_dir.rglob('*') if f.is_file()) / 1024 / 1024 # MB
return {
"status": "running" if is_running else "stopped",
"cpu": cpu,
"memory": memory,
"disk": disk_usage
}
@app.post("/api/servers/create")
async def create_server_on_daemon(data: dict, authorization: str = Header(None)):
"""Создать сервер на этом демоне"""
verify_key(authorization)
server_name = data.get("name", "").strip()
if not server_name:
raise HTTPException(status_code=400, detail="Server name is required")
server_path = SERVERS_DIR / server_name
if server_path.exists():
raise HTTPException(status_code=400, detail="Server already exists")
try:
server_path.mkdir(parents=True)
# Сохраняем конфигурацию
config = {
"name": server_name,
"displayName": data.get("displayName", server_name),
"startCommand": data.get("startCommand", "java -Xmx2G -jar server.jar nogui"),
"owner": data.get("owner", "unknown")
}
config_file = server_path / "config.json"
with open(config_file, 'w', encoding='utf-8') as f:
json.dump(config, f, indent=2, ensure_ascii=False)
return {"message": "Server created successfully", "name": server_name}
except Exception as e:
# Если что-то пошло не так, удаляем папку
if server_path.exists():
import shutil
shutil.rmtree(server_path)
raise HTTPException(status_code=500, detail=f"Failed to create server: {str(e)}")
if __name__ == "__main__":
print(f"Starting MC Panel Daemon: {DAEMON_NAME} ({DAEMON_ID})")
print(f"Port: {DAEMON_PORT}")
print(f"Servers directory: {SERVERS_DIR}")
uvicorn.run(
app,
host="0.0.0.0",
port=DAEMON_PORT,
log_level="info"
)

5
daemon/requirements.txt Normal file
View File

@@ -0,0 +1,5 @@
fastapi==0.104.1
uvicorn[standard]==0.24.0
websockets==12.0
psutil==5.9.6
python-dotenv==1.0.0

4
daemon/start.bat Normal file
View File

@@ -0,0 +1,4 @@
@echo off
echo Starting MC Panel Daemon...
python main.py
pause