Панель управления Minecraft серверами + агрегатор JAR-файлов из официальных источников
Возможности · Быстрый старт · Конфигурация · API · Архитектура
🖥️ Управление серверами — создание, запуск, остановка через веб-интерфейс
💬 Консоль реального времени — WebSocket-подключение к консоли сервера
📁 Файловый менеджер — редактирование конфигураций прямо из браузера
📊 Аналитика ресурсов — CPU, RAM, диск (система + каждый сервер отдельно)
📈 Графики нагрузки — историческая статистика за 1ч / 6ч / 24ч
🧩 Агрегатор JAR-файлов — встроенная замена serverjars.com, 16 типов из 4 категорий
| Категория | Типы |
|---|---|
| 🟢 Vanilla | vanilla · snapshot |
| ⚡ Servers | paper · purpur · spigot · folia · pufferfish · leaves · sponge |
| 🔧 Modded | fabric · forge · neoforge · mohist |
| 🌐 Proxies | velocity · waterfall · bungeecord |
Создайте docker-compose.yml:
services:
serverjars:
image: livelypuer/serverjars:latest
container_name: serverjars
restart: unless-stopped
ports:
- "8580:8080"
volumes:
- serverjars_cache:/data/cache
environment:
- CACHE_TTL=3600
- GITHUB_TOKEN=${GITHUB_TOKEN:-}
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
interval: 30s
timeout: 5s
retries: 3
panel:
image: livelypuer/minepanel:latest
container_name: minepanel
restart: unless-stopped
ports:
- "8585:8585"
- "25565-25600:25565-25600"
volumes:
- panel_data:/data
environment:
- SERVERJARS_URL=http://serverjars:8080
- JAVA_PATH=java
- DATA_DIR=/data
- MC_PORT_MIN=25565
- MC_PORT_MAX=25600
depends_on:
- serverjars
volumes:
serverjars_cache:
panel_data:# Запуск
docker compose up -d
# Остановка
docker compose down
# Обновление
docker compose pull && docker compose up -d💡 GitHub Token (опционально): для обхода rate limits создайте
.envрядом сdocker-compose.yml:GITHUB_TOKEN=ghp_your_token_here
| Сервис | URL |
|---|---|
| 🖥️ Панель управления | http://localhost:8585 |
| 📦 ServerJars API | http://localhost:8580 |
📦 Ручной запуск через Docker (без Compose)
1. Сеть и тома:
docker network create minepanel
docker volume create serverjars_cache
docker volume create panel_data2. ServerJars API:
docker run -d \
--name serverjars \
--network minepanel \
--restart unless-stopped \
-p 8580:8080 \
-v serverjars_cache:/data/cache \
-e CACHE_TTL=3600 \
livelypuer/serverjars:latest3. MinePanel:
docker run -d \
--name minepanel \
--network minepanel \
--restart unless-stopped \
-p 8585:8585 \
-p 25565-25600:25565-25600 \
-v panel_data:/data \
-e SERVERJARS_URL=http://serverjars:8080 \
-e JAVA_PATH=java \
-e DATA_DIR=/data \
-e MC_PORT_MIN=25565 \
-e MC_PORT_MAX=25600 \
livelypuer/minepanel:latestОстановка / удаление / обновление:
docker stop minepanel serverjars && docker rm minepanel serverjars
# Обновление — pull + повторный запуск
docker pull livelypuer/minepanel:latest
docker pull livelypuer/serverjars:latest| Переменная | По умолчанию | Описание |
|---|---|---|
SERVERJARS_URL |
http://serverjars:8080 |
URL ServerJars API |
DATA_DIR |
/data |
Директория данных |
JAVA_PATH |
java |
Путь к Java |
MC_PORT_MIN |
25565 |
Минимальный порт MC |
MC_PORT_MAX |
25600 |
Максимальный порт MC |
| Переменная | По умолчанию | Описание |
|---|---|---|
CACHE_TTL |
3600 |
Время жизни кеша (сек) |
GITHUB_TOKEN |
— | GitHub токен для rate limits |
Полностью совместим с форматом serverjars.com.
GET /api/fetchTypes — все категории и типы
GET /api/fetchAll/{type} — все версии типа
GET /api/fetchLatest/{type} — последняя версия
GET /api/fetchJar/{type}/{version} — скачать JAR (302 redirect)
GET /api/typeInfo/{type} — информация о типе
GET /api/stats — статистика API
GET /api/servers — список серверов
POST /api/servers — создать сервер
POST /api/servers/:id/start — запустить
POST /api/servers/:id/stop — остановить
GET /api/analytics/system — метрики системы
GET /api/analytics/servers — метрики серверов
GET /api/analytics/history — история нагрузки
WS /ws/console/:id — консоль (WebSocket)
| Слой | Технологии |
|---|---|
| Backend | Python 3.12 · FastAPI · SQLite · psutil |
| Frontend | React 19 · Vite · Recharts |
| Runtime | OpenJDK 21 |
| Infra | Docker · Docker Compose |
Все JAR-файлы загружаются исключительно из официальных источников:
| Источник | Типы серверов |
|---|---|
| Mojang | vanilla, snapshot |
| PaperMC API | paper, folia, velocity, waterfall |
| PurpurMC API | purpur |
| FabricMC Meta | fabric |
| MinecraftForge Maven | forge |
| NeoForged Maven | neoforge |
| MohistMC API | mohist |
| GitHub Releases | pufferfish, leaves |
| SpigotMC / md-5 CI | spigot, bungeecord |
| SpongePowered | sponge |
Распространяется под лицензией MIT.