Статья 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.
Установка в Docker
Заголовок раздела «Установка в Docker»Официальный образ: registry.gitlab.com/crafty-controller/crafty-4 (зеркало на Docker Hub: arcadiatechnology/crafty-4).
mkdir -p /opt/crafty && cd /opt/craftynano docker-compose.ymlservices: 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/import8443— веб-интерфейс по HTTPS. Здесь он открыт только на127.0.0.1, наружу его выпустит Nginx.25500-25600— диапазон для серверов Java. Порт сервера при создании выбирайте из него (25565 туда входит).19132/udp— нужен только для Bedrock.
docker compose up -ddocker 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 выбирается в профиле пользователя.
HTTPS через Nginx
Заголовок раздела «HTTPS через Nginx»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 nginxcertbot --nginx -d crafty.example.comclient_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:
- Тип сервера:
Minecraft servers(илиMinecraft proxiesдля Velocity и подобных). - Выбрать сервер:
vanilla,paper,purpur,folia,fabric,forge-installer,neoforge-installer. - Версия сервера: например,
26.3. - Имя, минимальная и максимальная память в ГБ, порт из проброшенного диапазона.
- Создать сервер! Crafty скачает jar и создаст папку в
docker/servers/<UUID>.

Справа можно импортировать готовый сервер из zip-архива. Про выбор между Paper, Fabric и Forge: Paper и Velocity, Forge и Fabric.
Первый запуск и EULA
Заголовок раздела «Первый запуск и EULA»Откройте сервер и нажмите Запустить на вкладке Терминал. При первом запуске Crafty спросит о согласии с лицензией Minecraft. Прочитайте Minecraft EULA и подтвердите Yes, если согласны: панель запишет eula=true и запустит сервер.

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

Откройте игровой порт в файрволе: ufw allow 25565/tcp (UFW). Docker публикует порты в обход UFW, поэтому проверьте доступность извне: port-check. Защита от ботов: hardening.
На вкладке Резервная копия уже есть Default Backup: копия, которую Crafty делает перед обновлением сервера. Кнопка со стрелками запускает бэкап вручную, карандаш открывает настройки: что исключить, сколько копий хранить, сжатие. Кнопка Создать новую резервную копию добавляет ещё одну политику, например с другим местом хранения.

Готовые архивы лежат на хосте в /opt/crafty/docker/backups/<UUID сервера>/. В тесте ручной бэкап пустого мира Paper занял 230 МБ. Копируйте их за пределы VPS: бэкапы.
Расписания
Заголовок раздела «Расписания»Вкладка График → Создать новое расписание. Режимы: Основной (интервал), Cron (cron-выражение) и Реакция (запуск после другой задачи). Действия: запустить, перезапустить, остановить сервер, резервная копия, пользовательская команда. Для бэкапа выберите политику в поле Политика резервного копирования: без неё расписание не сохранится.

Удобная связка: ежедневный бэкап ночью и через Реакцию перезапуск после него.
Обновление и бэкап самой панели
Заголовок раздела «Обновление и бэкап самой панели»cd /opt/craftytar -czf /root/crafty-$(date +%F).tar.gz docker/config docker/serversdocker compose pulldocker compose up -ddocker/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 |