🐳 Кастомные Docker образы
Svortex использует Docker образы для развертывания VDS и игровых серверов. Вы можете выбирать из предустановленных образов или использовать собственные кастомные образы.
💡 Важно: Все серверы работают на базе Pterodactyl Panel, который использует Docker контейнеры для изоляции и управления ресурсами.
📦 Типы образов
VDS образы
Полноценные операционные системы для виртуальных серверов. Включают Linux дистрибутивы и Windows.
Игровые образы
Специализированные образы для игровых серверов: Minecraft, Rust, ARK, Python, Node.js и другие.
💿 Доступные VDS образы
При создании VDS вы можете выбрать из 21 предустановленного образа:
Linux дистрибутивы:
Desktop версии:
Windows образы:
🎮 Игровые Docker образы
Для игровых серверов используются специализированные образы, оптимизированные под конкретные игры:
Minecraft
Используется образ ghcr.io/pterodactyl/yolks:java_17 или java_21
Поддерживает Vanilla, Paper, Spigot, Fabric и другие серверы Minecraft.
Coding (Python/Node.js)
Python: ghcr.io/pterodactyl/yolks:python_3.11
Node.js: ghcr.io/pterodactyl/yolks:nodejs_20
Для разработки и запуска приложений на Python или Node.js.
Rust / ARK
Rust: ghcr.io/pterodactyl/games:rust
ARK: ghcr.io/pterodactyl/games:ark
Специализированные образы для игровых серверов Rust и ARK: Survival Evolved.
🔄 Смена Docker образа для VDS
Вы можете изменить Docker образ для существующего VDS сервера через API или панель управления.
Через API:
POST /api/vds/:id/change-os
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"docker_image": "ghcr.io/david1117dev/lumenvm:ubuntu-24"
}⚠️ Внимание: Смена образа может привести к потере данных. Рекомендуется создать резервную копию перед сменой образа.
🎯 Смена образа игрового сервера
Для игровых серверов Docker образ можно изменить через раздел "Startup" в панели управления:
Инструкция:
- Откройте панель управления сервером
- Перейдите в раздел "Startup"
- Найдите поле "Docker Image"
- Выберите нужный образ из списка или введите кастомный
- Сохраните изменения
- Перезапустите сервер
Через API:
PUT /api/server-management/:id/startup/docker-image
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"docker_image": "ghcr.io/pterodactyl/yolks:java_21"
}🛠️ Использование кастомных образов
Вы можете использовать собственные Docker образы из Docker Hub, GitHub Container Registry или других реестров.
Формат образа:
registry.io/username/image:tag registry.io - реестр (docker.io, ghcr.io, quay.io)username - имя пользователя или организацииimage - название образаtag - версия или тег (latest, 1.0, alpine)Примеры кастомных образов:
docker.io/myusername/my-custom-server:latestghcr.io/myorg/game-server:v1.2.3quay.io/company/custom-image:alpine💡 Совет: Убедитесь, что ваш кастомный образ совместим с Pterodactyl. Образ должен поддерживать переменные окружения и иметь правильную структуру файловой системы.
✅ Требования к кастомным образам
Для VDS образов:
- Образ должен быть основан на Linux (Ubuntu, Debian, Alpine и т.д.)
- Должен поддерживать SSH доступ
- Должен иметь предустановленный пользователь root или возможность его создания
- Должен поддерживать переменные окружения для настройки (PASSWORD, HOSTNAME и т.д.)
- Рекомендуется использовать образы на базе lumenvm для совместимости
Для игровых серверов:
- Образ должен запускать процесс в foreground режиме
- Должен поддерживать переменные окружения из Pterodactyl
- Должен работать от пользователя
container(UID 1000) - Должен иметь рабочую директорию
/home/container - Рекомендуется использовать образы из серии yolks для игровых серверов
🔨 Создание собственного образа
Если вы хотите создать собственный Docker образ для использования на Svortex:
Пример Dockerfile для игрового сервера:
FROM ghcr.io/pterodactyl/yolks:java_17
# Установка дополнительных пакетов
RUN apt-get update && apt-get install -y \
curl \
wget \
&& rm -rf /var/lib/apt/lists/*
# Настройка рабочей директории
WORKDIR /home/container
# Копирование файлов (если нужно)
# COPY ./files /home/container/
# Установка пользователя
USER container
ENV USER=container HOME=/home/container
# Команда запуска
CMD ["/bin/bash"]Сборка и публикация:
# Сборка образа
docker build -t my-custom-image:latest .
# Тегирование для публикации
docker tag my-custom-image:latest ghcr.io/username/my-custom-image:latest
# Публикация в GitHub Container Registry
echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin
docker push ghcr.io/username/my-custom-image:latest⚠️ Ограничения и рекомендации
Размер образа
Рекомендуемый размер образа не должен превышать 5GB. Большие образы могут замедлить создание сервера.
Безопасность
Используйте только проверенные образы из доверенных источников. Не используйте образы с потенциально опасным кодом.
Совместимость
Не все образы совместимы с Pterodactyl. Тестируйте образы на тестовом сервере перед использованием в продакшене.