Перейти к содержанию

Как запустить выделенный сервер Windrose на Linux через Docker

Требования к хосту, установка сервера, подключение по коду приглашения, резервное копирование и устранение неполадок.
Обновлено

Это руководство описывает сторонний способ запуска выделенного сервера Windrose на Linux с Docker, Wine и SteamCMD. Отдельный компьютер с Windows не требуется. Для обычного подключения игроков по коду приглашения проброс портов не нужен.

Возможности и системные требования

Проект запускает игру в безголовом режиме через Wine и Xvfb, устанавливает и обновляет сервер через SteamCMD, поддерживает мастер первоначальной настройки, резервное копирование по расписанию и несколько миров. Есть переключение миров, перенос сохранений из одиночной игры или с другого сервера, уведомления Discord и Gotify, а также варианты образов stable, latest, staging и debug.

КомпонентМинимум
ОСUbuntu 22.04+ или Debian 12+
Docker24.x+
Docker Composev2.x, команда docker compose
Оперативная память8 ГБ; рекомендуется 16 ГБ для четырёх игроков
Свободное место8 ГБ для файлов игры

Для виртуальной машины или контейнера Proxmox установите тип CPU host в настройках оборудования. По руководству, тип kvm64 по умолчанию может привести к незаметному сбою Wine.

Servarium

Первый сервер бесплатно

Играйте с друзьями без хоста: выделенный сервер с автоматическими бэкапами и модами

Установка через мастер настройки

Интерактивный мастер создаёт файл .env, настраивает резервное копирование и при желании сразу запускает сервер.

git clone https://github.com/UberDudePL/windrose-dedicated-server-docker.git
cd windrose-dedicated-server-docker
chmod +x ./windrose ./serverctl.sh
./windrose setup

Мастер запросит имя сервера и код приглашения; дополнительно можно задать пароль, максимальное число игроков, расписание и формат копий, а также адрес для необязательной загрузки резервных копий в Discord. При первом запуске SteamCMD скачивает около 3 ГБ игровых файлов.

Ручной быстрый запуск

Если не использовать мастер, скопируйте пример конфигурации, заполните .env и запустите контейнер:

cp .env.example .env
nano .env
docker compose pull
docker compose up -d
docker compose logs -f windrose

В руководстве в качестве стабильного образа указан тег ghcr.io/uberdudepl/windrose-dedicated-server-docker:v1.6.0.

Как подключиться к серверу

  1. Запустите сервер и дождитесь, пока его состояние станет healthy.
  2. Откройте data/R5/ServerDescription.json.
  3. Скопируйте значение InviteCode и отправьте его игрокам.
  4. В игре игроки выбирают Play → Connect to Server → Join via Code и вводят код.

Код чувствителен к регистру и должен содержать не менее шести символов. Для обычного подключения по коду проброс портов не нужен.

Чтобы использовать прямое подключение по IP, укажите USE_DIRECT_CONNECTION=true в .env. В этом режиме потребуется проброс портов.

Команды управления

КомандаНазначение
./windrose setupПервоначальная настройка через мастер.
./windrose statusСостояние контейнера, игроки и возраст последней копии.
./windrose doctorПолная предварительная проверка.
./windrose logsПросмотр текущих журналов.
./windrose backupСоздать резервную копию вручную.
./windrose switchИнтерактивно переключить игровой мир.
./windrose worldsПоказать список миров.
./windrose worlds-checkНайти повреждённые или оставшиеся записи миров.
./windrose notifyЗапустить наблюдение за входом и выходом игроков для уведомлений.
./windrose notify testПроверить систему уведомлений.
./windrose updateБезопасно скачать обновление и пересоздать контейнер.
./windrose diagnosticsСобрать журналы для отчёта об ошибке.

Уведомления и резервное копирование

Для уведомлений Discord и Gotify укажите параметры в .env:

NOTIFY_PROVIDER=both
DISCORD_WEBHOOK_URL=<Discord webhook URL>
GOTIFY_URL=https://gotify.example.com
GOTIFY_TOKEN=<Gotify token>

Перед включением уведомлений проверьте их командой ./windrose notify test.

Резервную копию можно создать командой ./windrose backup. Для установки ежедневного расписания на 06:00 используйте ./windrose install-backup-cron. Собственное расписание передаётся аргументом, например ./windrose install-backup-cron "0 3 * * *".

В .env задайте область копирования, формат архива, срок хранения и необходимость загрузки в Discord. В примере используется полная копия, архив tar.gz, хранение в течение 7 дней и отключённая загрузка в Discord:

BACKUP_SCOPE=full
BACKUP_FORMAT=tar.gz
BACKUP_RETENTION_DAYS=7
BACKUP_DISCORD_UPLOAD=false

Для копирования только сохранения используйте BACKUP_SCOPE=save, для обоих типов данных — BACKUP_SCOPE=both. Формат также можно сменить на zip.

Типовые неполадки

ПроблемаЧто проверить
Wine сообщает, что /home/steam не принадлежит пользователюПравильно задайте PUID и PGID в .env, затем перезапустите сервер.
Сообщение «Server is already active for display 99»Осталась блокировка Xvfb; точка входа удаляет её при перезапуске.
Настройки сбрасываются после перезапускаРедактируйте JSON-файлы только при остановленном сервере.
Игроки не видят серверПередайте им InviteCode из ServerDescription.json.
Сервер без сообщения не запускается в ProxmoxИзмените тип CPU виртуальной машины или контейнера на host.

Для дополнительной диагностики запустите ./windrose doctor и ./windrose diagnostics. В репозитории проекта также приведены таблица проблем и инструкции по сетевой настройке.

Чат в Telegram

Не с кем играть? Найдите компанию в нашем чате

Гайд был полезен?