Веб-панель управления сервером Project Zomboid
Менеджер запускает сервер PZ как дочерний процесс и держит его stdin/stdout: отсюда живая консоль без RCON, стриминг логов через SSE и корректная остановка по цепочке quit -> SIGTERM -> SIGKILL для всей группы процессов. Сам менеджер работает под systemd. Что входит: - управление жизненным циклом сервера, автозапуск и автоподъём после падения; - метрики процесса из /proc и состояние хоста, список игроков онлайн; - редакторы servertest.ini и SandboxVars.lua, сохраняющие исходное форматирование файлов; - моды: списки Workshop ID и Mod ID с порядком загрузки, названия из Steam; - бэкапы мира по расписанию и вручную, с ротацией и восстановлением; - установка и обновление сервера через SteamCMD; - вход по логину и паролю, первичная настройка по одноразовому коду. Веб-интерфейс без сборщика, вшит в бинарник через embed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,65 @@
|
||||
#!/usr/bin/env bash
|
||||
# Установка pzmanager на Ubuntu. Запускать от root:
|
||||
# sudo ./deploy/install.sh
|
||||
#
|
||||
# Скрипт: заводит системного пользователя, кладёт бинарник в /usr/local/bin,
|
||||
# ставит systemd-юнит и зависимости, нужные серверу Project Zomboid.
|
||||
set -euo pipefail
|
||||
|
||||
PZ_USER="${PZ_USER:-pzserver}"
|
||||
PZ_HOME="${PZ_HOME:-/home/${PZ_USER}}"
|
||||
BINARY="${BINARY:-./pzmanager}"
|
||||
UNIT_SRC="$(dirname "$0")/pzmanager.service"
|
||||
|
||||
if [[ $EUID -ne 0 ]]; then
|
||||
echo "Запустите скрипт от root: sudo $0" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [[ ! -f "$BINARY" ]]; then
|
||||
echo "Не найден бинарник $BINARY. Соберите его: make build-linux" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "==> Устанавливаю системные зависимости"
|
||||
apt-get update -qq
|
||||
# lib32gcc-s1 нужен SteamCMD, остальное — самому серверу PZ.
|
||||
apt-get install -y --no-install-recommends \
|
||||
ca-certificates curl lib32gcc-s1 libsdl2-2.0-0 openjdk-17-jre-headless
|
||||
|
||||
if ! id "$PZ_USER" &>/dev/null; then
|
||||
echo "==> Создаю пользователя $PZ_USER"
|
||||
adduser --system --group --home "$PZ_HOME" --shell /bin/bash "$PZ_USER"
|
||||
fi
|
||||
|
||||
echo "==> Копирую бинарник в /usr/local/bin/pzmanager"
|
||||
install -m 0755 "$BINARY" /usr/local/bin/pzmanager
|
||||
|
||||
echo "==> Готовлю директории"
|
||||
install -d -o "$PZ_USER" -g "$PZ_USER" -m 0755 \
|
||||
"$PZ_HOME/.config/pzmanager" \
|
||||
"$PZ_HOME/.local/share/pzmanager" \
|
||||
"$PZ_HOME/pzserver" \
|
||||
"$PZ_HOME/pzbackups"
|
||||
|
||||
echo "==> Ставлю systemd-юнит"
|
||||
sed -e "s|/home/pzserver|${PZ_HOME}|g" \
|
||||
-e "s|User=pzserver|User=${PZ_USER}|" \
|
||||
-e "s|Group=pzserver|Group=${PZ_USER}|" \
|
||||
"$UNIT_SRC" > /etc/systemd/system/pzmanager.service
|
||||
|
||||
systemctl daemon-reload
|
||||
systemctl enable --now pzmanager
|
||||
|
||||
echo
|
||||
echo "Готово. Панель запущена."
|
||||
echo "Код первичной настройки смотрите в журнале:"
|
||||
echo
|
||||
echo " journalctl -u pzmanager -n 30 --no-pager"
|
||||
echo
|
||||
echo "По умолчанию панель слушает 127.0.0.1:8080."
|
||||
echo "Откройте её через SSH-туннель:"
|
||||
echo
|
||||
echo " ssh -L 8080:127.0.0.1:8080 <пользователь>@<сервер>"
|
||||
echo
|
||||
echo "Не забудьте открыть игровые порты: udp/16261 и udp/16262."
|
||||
@@ -0,0 +1,32 @@
|
||||
[Unit]
|
||||
Description=PZ Manager — веб-панель сервера Project Zomboid
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=pzserver
|
||||
Group=pzserver
|
||||
WorkingDirectory=/home/pzserver
|
||||
ExecStart=/usr/local/bin/pzmanager serve --config /home/pzserver/.config/pzmanager/config.yaml
|
||||
Restart=on-failure
|
||||
RestartSec=5
|
||||
|
||||
# Менеджер сам останавливает игровой сервер по SIGTERM: сначала отправляет
|
||||
# команду quit (мир сохраняется), потом добивает процесс. Дадим ему время.
|
||||
KillSignal=SIGTERM
|
||||
KillMode=mixed
|
||||
TimeoutStopSec=300
|
||||
|
||||
# Панель пишет только в свои директории.
|
||||
NoNewPrivileges=true
|
||||
PrivateTmp=true
|
||||
ProtectSystem=full
|
||||
ProtectHome=read-only
|
||||
ReadWritePaths=/home/pzserver
|
||||
|
||||
StandardOutput=journal
|
||||
StandardError=journal
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
Reference in New Issue
Block a user