Перейти к содержимому

Статья 77 из 141

Гайды

Crafty Controller: веб-панель для серверов Minecraft в Docker на VPS

Crafty Controller — бесплатная веб-панель для серверов Minecraft. Через браузер вы создаёте серверы Java и Bedrock, запускаете и останавливаете их, смотрите консоль, правите файлы, делаете бэкапы и ставите задачи по расписанию. Панель подходит, если серверов несколько или ими управляют не только через SSH. Для разных игр сразу посмотрите Pterodactyl.

Проверено на Ubuntu 24.04 с Crafty 4.11.0 (ноябрь 2026): панель, создание сервера Paper 26.3, запуск, бэкап и расписание.

Ресурс Панель Панель + 1 сервер Paper
vCPU 1 2–4
RAM 512 МБ 4 ГБ и больше
Диск 3 ГБ 20+ ГБ под миры и бэкапы

Образ включает Java 8, 11, 17, 21 и 25, ставить Java на хост не нужно. Нужен Docker с Compose.

Официальный образ: registry.gitlab.com/crafty-controller/crafty-4 (зеркало на Docker Hub: arcadiatechnology/crafty-4).

Окно терминала
mkdir -p /opt/crafty && cd /opt/crafty
nano docker-compose.yml
services:
crafty:
container_name: crafty_container
image: registry.gitlab.com/crafty-controller/crafty-4:latest
restart: always
environment:
- TZ=Europe/Moscow
ports:
- "127.0.0.1:8443:8443"
- "25500-25600:25500-25600"
- "19132:19132/udp"
volumes:
- ./docker/backups:/crafty/backups
- ./docker/logs:/crafty/logs
- ./docker/servers:/crafty/servers
- ./docker/config:/crafty/app/config
- ./docker/import:/crafty/import
  • 8443 — веб-интерфейс по HTTPS. Здесь он открыт только на 127.0.0.1, наружу его выпустит Nginx.
  • 25500-25600 — диапазон для серверов Java. Порт сервера при создании выбирайте из него (25565 туда входит).
  • 19132/udp — нужен только для Bedrock.
Окно терминала
docker compose up -d
docker compose logs -f

Панель готова, когда в логе появится Crafty has fully started and is now ready for use!.

Crafty сам создаёт пользователя admin со случайным паролем. В логе будет строка Default password too short using Crafty's created default. Find it in app/config/default-creds.txt. На хосте файл лежит в смонтированной папке:

Окно терминала
cat /opt/crafty/docker/config/default-creds.txt
{
"username": "admin",
"password": "...",
"info": "This is NOT where you change your password. This file is only a means to give you a default password."
}

После первого входа смените пароль в настройках пользователя и удалите файл. При первом входе панель предлагает анонимный опрос, его можно пропустить кнопкой Skip Survey/Done. Интерфейс переведён на русский: язык ru_RU выбирается в профиле пользователя.

Crafty отдаёт интерфейс по HTTPS с самоподписанным сертификатом, поэтому Nginx проксирует на https://. Консоль сервера и окна подтверждения работают через WebSocket, нужны заголовки Upgrade и Connection. Заголовок Host должен совпадать с доменом: иначе Crafty отклоняет WebSocket с кодом 403, и в панели висит предупреждение «WebSockets are required for Crafty to work».

server {
listen 80;
server_name crafty.example.com;
client_max_body_size 1024M;
location / {
proxy_pass https://127.0.0.1:8443;
proxy_ssl_verify off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
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;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/crafty /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d crafty.example.com

client_max_body_size нужен для загрузки архивов с мирами. Подробнее: Nginx, Let’s Encrypt. В Caddy работает reverse_proxy https://127.0.0.1:8443 с header_up Host {host} и tls_insecure_skip_verify в блоке transport http.

Откройте Серверы → Создать новый сервер. Вкладки сверху: Minecraft-Java, Minecraft-Bedrock и Hytale. Для Java:

  1. Тип сервера: Minecraft servers (или Minecraft proxies для Velocity и подобных).
  2. Выбрать сервер: vanilla, paper, purpur, folia, fabric, forge-installer, neoforge-installer.
  3. Версия сервера: например, 26.3.
  4. Имя, минимальная и максимальная память в ГБ, порт из проброшенного диапазона.
  5. Создать сервер! Crafty скачает jar и создаст папку в docker/servers/<UUID>.

Форма создания сервера Paper 26.3 в Crafty Controller

Справа можно импортировать готовый сервер из zip-архива. Про выбор между Paper, Fabric и Forge: Paper и Velocity, Forge и Fabric.

Откройте сервер и нажмите Запустить на вкладке Терминал. При первом запуске Crafty спросит о согласии с лицензией Minecraft. Прочитайте Minecraft EULA и подтвердите Yes, если согласны: панель запишет eula=true и запустит сервер.

Окно подтверждения Minecraft EULA при первом запуске сервера

Через минуту статус сменится на Онлайн, в терминале появится лог запуска. Команды сервера вводятся в строку под логом.

Запущенный сервер Paper и консоль в Crafty Controller

Откройте игровой порт в файрволе: ufw allow 25565/tcp (UFW). Docker публикует порты в обход UFW, поэтому проверьте доступность извне: port-check. Защита от ботов: hardening.

На вкладке Резервная копия уже есть Default Backup: копия, которую Crafty делает перед обновлением сервера. Кнопка со стрелками запускает бэкап вручную, карандаш открывает настройки: что исключить, сколько копий хранить, сжатие. Кнопка Создать новую резервную копию добавляет ещё одну политику, например с другим местом хранения.

Список резервных копий сервера в Crafty Controller

Готовые архивы лежат на хосте в /opt/crafty/docker/backups/<UUID сервера>/. В тесте ручной бэкап пустого мира Paper занял 230 МБ. Копируйте их за пределы VPS: бэкапы.

Вкладка График → Создать новое расписание. Режимы: Основной (интервал), Cron (cron-выражение) и Реакция (запуск после другой задачи). Действия: запустить, перезапустить, остановить сервер, резервная копия, пользовательская команда. Для бэкапа выберите политику в поле Политика резервного копирования: без неё расписание не сохранится.

Ежедневный бэкап в 04 в списке расписаний

Удобная связка: ежедневный бэкап ночью и через Реакцию перезапуск после него.

Окно терминала
cd /opt/crafty
tar -czf /root/crafty-$(date +%F).tar.gz docker/config docker/servers
docker compose pull
docker compose up -d

docker/config хранит базу панели с пользователями и расписаниями, docker/servers — сами серверы.

Симптом Причина и решение
Предупреждение «WebSockets are required», консоль пустая Прокси не передаёт Upgrade/Connection или подменяет Host. Исправьте конфиг Nginx
Нажал «Запустить», ничего не происходит Окно EULA не показалось из-за WebSocket. Почините прокси и нажмите снова
Игроки не подключаются Порт сервера вне проброшенного диапазона 25500-25600. Смените порт или пробросьте его
502 Bad Gateway в Nginx Проксирование на http:// вместо https://. Используйте https://127.0.0.1:8443 и proxy_ssl_verify off
Не найти пароль admin docker/config/default-creds.txt на хосте
Расписание бэкапа не сохраняется Не выбрана политика резервного копирования
Сервер падает с OutOfMemoryError Мало максимальной памяти в настройках сервера или RAM на тарифе: ресурсы Minecraft