8 Commits
Author SHA1 Message Date
mrleo1nidandClaude Opus 5 4a346c4ed9 В обновлении видно изменения всех пропущенных версий
CI / test (push) Successful in 21s
Release / release (push) Successful in 29s
Панель показывала описание только последнего релиза. Пропустив пару
версий, человек не узнал бы, что менялось в промежутке, — теперь
запрашивается список релизов и показываются все, что новее установленной,
каждая со своим заголовком и датой. Черновики и предрелизы отбрасываются,
порядок восстанавливается по номерам версий, а не по тому, как их отдал
Gitea.

Заодно в карточке профиля появились подсказки: сколько на машине ОЗУ (не
выбирать же лимит JVM вслепую) и что означает пустое поле начальной
памяти.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:25:16 +03:00
mrleo1nidandClaude Opus 5 e78a72d516 Память JVM задаётся раздельно, автоперезапуск можно отменить
Панель принудительно ставила -Xms равным -Xmx: куча не растёт на ходу, но
JVM обязана занять весь объём при старте. На машине с 5 ГБ ОЗУ сервер с
4g так вообще не поднимался — «Failed to allocate initial Java heap».

Теперь -Xmx задаётся как раньше, а -Xms стал отдельным полем профиля и по
умолчанию пуст: JVM берёт память по мере надобности. Пара значений
проверяется при сохранении профиля, а не при запуске сервера, — про
опечатку лучше узнать из формы, чем из лога упавшего сервера.

Там же в супервизоре: ожидание автоподъёма стало отдельным состоянием.
Раньше упавший сервер уходил в цикл «падение — пауза 10 секунд — падение»,
причём во время паузы он считался остановленным, и прервать это было
нечем. Теперь паузу видно в статусе с обратным отсчётом и её можно
отменить, а после трёх падений сразу после запуска подряд панель
перестаёт поднимать сервер сама: так проявляется нехватка памяти или
битый конфиг, и перезапуск тут не помогает.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:25:16 +03:00
mrleo1nidandClaude Opus 5 f6eba8c75c Кнопка SteamCMD называет то, что произойдёт
Release / release (push) Successful in 26s
CI / test (push) Successful in 20s
«Установить / обновить через SteamCMD» одинаково выглядела и на чистой
машине, и на готовой. Теперь пока серверных файлов нет — это «Установить
сервер через SteamCMD», после установки — «Обновить сервер через
SteamCMD»; подсказка и вопрос перед запуском меняются вместе с ней.

На чистой машине подсказка вместо требования остановить сервер (его ещё
нет) говорит то, что важно знать заранее: сколько это займёт времени и
места на диске.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:02:08 +03:00
mrleo1nidandClaude Opus 5 27a2fd6386 Консоль не принимает команды у остановленного сервера
CI / test (push) Successful in 20s
Release / release (push) Successful in 25s
Поле ввода и кнопка «Отправить» были активны всегда, хотя команда уходит
в stdin процесса: у остановленного сервера его просто нет, и панель
отвечала ошибкой уже после отправки. Теперь консоль блокируется, а
подсказка объясняет, почему.

Заодно из вывода убираются управляющие последовательности терминала.
SteamCMD раскрашивает свои сообщения, и в браузере это выглядело как
«[0mWaiting for user info...[0mOK». Чистка стоит на общем пути записи в
буфер: через него идёт и вывод сервера, и SteamCMD, и сообщения панели.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 01:56:55 +03:00
mrleo1nidandClaude Opus 5 08908bede8 Кнопка обновления не работала из-за NoNewPrivileges в юните
CI / test (push) Successful in 20s
Release / release (push) Successful in 26s
Панель показывала команду для терминала вместо кнопок обновления и
перезапуска, потому что sudo из неё не запускался вовсе: NoNewPrivileges
запрещает процессу и его потомкам повышать привилегии. Механизм с
sudoers, ради которого всё и делалось, был при этом мёртв.

Убрал эту опцию из юнита, оставив комментарий, почему её здесь быть не
должно. Ограничение прав никуда не делось: в sudoers сервисному
пользователю разрешена ровно одна команда, pzmanager-admin.

Заодно описание релиза перестало показываться сырой разметкой. Раздел
про установку в работающей панели ни к чему, поэтому берётся только
список изменений; блок прокручивается сам, не утягивая страницу, а рядом
появилась ссылка на полное описание.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 01:49:02 +03:00
mrleo1nidandClaude Opus 5 3dc8fdae05 Кнопка «Сохранить» активна только при несохранённых изменениях
CI / test (push) Successful in 21s
Release / release (push) Successful in 26s
Раньше она предлагала сохранить даже пустую вкладку: на свежей установке
конфигов ещё нет, полей на странице ноль, а кнопка зовёт нажать себя.

Теперь на всех четырёх вкладках кнопка включается, только когда есть что
записывать, и показывает счётчик изменённых полей. Возврат значения к
исходному снова её гасит — правки считаются сравнением с состоянием на
момент загрузки, а не фактом ввода.

Для модов изменением считается и переключённая галочка, и переставленный
порядок загрузки, и правка списка карт: состояние сводится к строке и
сравнивается со снимком, снятым при открытии вкладки.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 20:36:33 +03:00
mrleo1nidandClaude Opus 5 1e0b0a8d2b Кнопка обновления обновляет всё, а не только бинарник
pzmanager-admin update больше не повторяет логику установки: он забирает
из релиза get.sh (сверив sha256) и отдаёт работу ему. Поэтому обновление
из панели теперь приводит в порядок и скрипты установки, и systemd-юнит —
раньше они застывали на версии первой установки, а вместе с ними
терялась, например, локальная копия установщика для удаления.

Работа уходит в разовый юнит через systemd-run. Иначе она не пережила бы
сама себя: панель вызывает скрипт через sudo, тот живёт в cgroup её юнита,
и остановка службы установщиком убила бы его на середине. Команда restart
по той же причине получила --no-block.

Установщик стал понятнее в двух местах, о которые легко споткнуться:
- повторная установка той же сборки больше не роняет игровой сервер —
  если sha256 бинарника совпал, служба не останавливается вовсе;
- после обновления он явно пишет, что запускает службу, и проверяет, что
  она поднялась. Раньше systemctl start отрабатывал молча, и по выводу
  нельзя было понять, работает панель или нет. Службу, остановленную не
  установщиком, он по-прежнему не поднимает самовольно.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 20:28:42 +03:00
mrleo1nidandClaude Opus 5 41c7cb9bb0 Справка установщика обрывается на конце комментариев
Release / release (push) Successful in 27s
CI / test (push) Successful in 20s
В вывод --help попадала первая строка кода: диапазон строк был задан
числом, а не концом шапки.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 20:04:15 +03:00
18 changed files with 954 additions and 126 deletions
+32 -6
View File
@@ -85,8 +85,9 @@ curl -fsSL https://gitea.hsrv.site/mrleo1nid/pzmanager/raw/branch/main/deploy/ge
``` ```
**Обновление** — та же команда или кнопка в панели (вкладка «Настройки» → **Обновление** — та же команда или кнопка в панели (вкладка «Настройки» →
«Версия панели»). Конфиг, миры и учётные записи не трогаются, меняется только «Версия панели»). Конфиг, миры и учётные записи не трогаются. Повторный запуск
бинарник. с той же версией службу не трогает вовсе: если бинарник не изменился,
установщик не станет ради него ронять игровой сервер.
Дальше: Дальше:
@@ -212,6 +213,20 @@ Mod ID, который нужен серверу, лежит внутри сам
При создании профиля можно скопировать `.ini` и настройки песочницы из При создании профиля можно скопировать `.ini` и настройки песочницы из
существующего: удобно, когда нужен тот же набор правил, но чистый мир. существующего: удобно, когда нужен тот же набор правил, но чистый мир.
### Память JVM
`java_memory` — это `-Xmx`, верхняя граница кучи. `java_memory_min` (`-Xms`)
по умолчанию пуст, и это осознанно: равные значения избавляют от роста кучи на
ходу, но заставляют JVM занять весь объём сразу при старте. На машине, где
столько свободной памяти не набирается, сервер тогда не поднимется вовсе —
`Failed to allocate initial Java heap`. Задавайте минимум, только если памяти
заведомо хватает.
Сервер, упавший сразу после запуска три раза подряд, панель перестаёт
поднимать автоматически: обычно так проявляется нехватка памяти или битый
конфиг, и перезапуск делу не помогает. Пока идёт отсчёт до автоподъёма, его
можно отменить кнопкой «Отменить перезапуск».
Удаление профиля убирает его только из панели — мир и конфиги остаются на Удаление профиля убирает его только из панели — мир и конфиги остаются на
диске. Чтобы вернуть профиль, создайте его с тем же идентификатором. диске. Чтобы вернуть профиль, создайте его с тем же идентификатором.
@@ -235,9 +250,19 @@ Mod ID, который нужен серверу, лежит внутри сам
pzserver ALL=(root) NOPASSWD: /usr/local/bin/pzmanager-admin pzserver ALL=(root) NOPASSWD: /usr/local/bin/pzmanager-admin
``` ```
Скрипт качает бинарник нужной архитектуры, сверяет sha256 с `checksums.txt` Скрипт не повторяет логику установки, а забирает из релиза `get.sh` (сверив
релиза, подменяет файл и перезапускает службу. Панель к этим файлам доступа не его sha256) и отдаёт работу ему — поэтому кнопка обновляет всё сразу: бинарник,
имеет — она может только попросить выполнить `update` или `restart`. скрипты установки и systemd-юнит. Панель к этим файлам доступа не имеет, она
может только попросить выполнить `update` или `restart`.
Работа уходит в отдельный разовый юнит (`systemd-run --unit=pzmanager-update`).
Иначе обновление не пережило бы само себя: панель вызывает скрипт через sudo,
тот живёт в cgroup её юнита, и остановка службы убила бы его на середине.
Побочный эффект — вывод идёт не в консоль панели, а в свой журнал:
```bash
journalctl -u pzmanager-update -f
```
Если правило sudo не установлено (панель поставлена вручную или в системе нет Если правило sudo не установлено (панель поставлена вручную или в системе нет
`sudo`), кнопка не появится, а рядом будет показана команда для терминала: `sudo`), кнопка не появится, а рядом будет показана команда для терминала:
@@ -316,7 +341,8 @@ profiles: # серверы: у каждого свой м
- id: vanilla # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla - id: vanilla # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla
title: Ванильный мир # как профиль подписан в панели title: Ванильный мир # как профиль подписан в панели
admin_password: "" # пароль админа игрового сервера admin_password: "" # пароль админа игрового сервера
java_memory: 4g # -Xmx для JVM этого профиля java_memory: 4g # -Xmx: верхняя граница кучи JVM
java_memory_min: "" # -Xms: пусто — JVM берёт память по мере надобности
extra_args: [] # доп. аргументы start-server.sh extra_args: [] # доп. аргументы start-server.sh
- id: modded - id: modded
title: Сборка с модами title: Сборка с модами
+54 -3
View File
@@ -39,7 +39,9 @@ for arg in "$@"; do
--purge) UNINSTALL=1; PURGE=1 ;; --purge) UNINSTALL=1; PURGE=1 ;;
--yes | -y) PZ_ASSUME_YES=1 ;; --yes | -y) PZ_ASSUME_YES=1 ;;
-h | --help) -h | --help)
sed -n '2,20p' "$0" | sed 's/^# \{0,1\}//' # Справка — это шапка файла: печатаем комментарии со второй строки и
# останавливаемся, как только они кончились.
awk 'NR > 1 && /^#/ { sub(/^# ?/, ""); print; next } NR > 1 { exit }' "$0"
exit 0 exit 0
;; ;;
*) *)
@@ -203,17 +205,29 @@ EOF
chmod 0640 "$CONFIG" chmod 0640 "$CONFIG"
fi fi
# Если ставим ровно то же самое, что уже лежит, службу трогать незачем: её
# остановка кладёт и игровой сервер, а повторный запуск установщика — обычное
# дело (например, чтобы обновить скрипты).
SAME_BINARY=0
if [[ "$MODE" == "update" ]] &&
[[ "$(sha256sum "$BINARY" | cut -d' ' -f1)" == "$(sha256sum "$TARGET_BINARY" | cut -d' ' -f1)" ]]; then
SAME_BINARY=1
echo "==> Бинарник не изменился — службу не останавливаю"
fi
# Останавливаем сервис перед заменой бинарника: менеджер должен корректно # Останавливаем сервис перед заменой бинарника: менеджер должен корректно
# завершить игровой сервер, а не быть подменённым на ходу. # завершить игровой сервер, а не быть подменённым на ходу.
RESTART_AFTER=0 RESTART_AFTER=0
if [[ "$MODE" == "update" ]] && systemctl is-active --quiet pzmanager; then if [[ "$MODE" == "update" && "$SAME_BINARY" == "0" ]] && systemctl is-active --quiet pzmanager; then
echo "==> Останавливаю pzmanager (игровой сервер завершится штатно)" echo "==> Останавливаю pzmanager (игровой сервер завершится штатно)"
systemctl stop pzmanager systemctl stop pzmanager
RESTART_AFTER=1 RESTART_AFTER=1
fi fi
if [[ "$SAME_BINARY" == "0" ]]; then
echo "==> Копирую бинарник в $TARGET_BINARY" echo "==> Копирую бинарник в $TARGET_BINARY"
install -m 0755 "$BINARY" "$TARGET_BINARY" install -m 0755 "$BINARY" "$TARGET_BINARY"
fi
# Панель работает от непривилегированного пользователя и не может ни заменить # Панель работает от непривилегированного пользователя и не может ни заменить
# бинарник, ни дёрнуть systemctl. Даём ей ровно одну команду через sudo. # бинарник, ни дёрнуть systemctl. Даём ей ровно одну команду через sudo.
@@ -221,6 +235,8 @@ if [[ -f "$ADMIN_SRC" ]] && command -v sudo >/dev/null 2>&1; then
echo "==> Ставлю $ADMIN_BINARY и правило sudo" echo "==> Ставлю $ADMIN_BINARY и правило sudo"
sed -e "s|@PZ_REPO@|${PZ_REPO}|" \ sed -e "s|@PZ_REPO@|${PZ_REPO}|" \
-e "s|@PZ_BINARY@|${TARGET_BINARY}|" \ -e "s|@PZ_BINARY@|${TARGET_BINARY}|" \
-e "s|@PZ_HOME@|${PZ_HOME}|" \
-e "s|@PZ_USER@|${PZ_USER}|" \
"$ADMIN_SRC" > "$ADMIN_BINARY" "$ADMIN_SRC" > "$ADMIN_BINARY"
chown root:root "$ADMIN_BINARY" chown root:root "$ADMIN_BINARY"
chmod 0755 "$ADMIN_BINARY" chmod 0755 "$ADMIN_BINARY"
@@ -254,10 +270,25 @@ sed -e "s|/opt/pzmanager|${PZ_HOME}|g" \
systemctl daemon-reload systemctl daemon-reload
systemctl enable --quiet pzmanager systemctl enable --quiet pzmanager
# wait_active ждёт, пока служба поднимется, и говорит, чем всё кончилось:
# молчаливый systemctl start оставлял пользователя гадать, работает ли панель.
wait_active() {
local i
for i in $(seq 1 15); do
if systemctl is-active --quiet pzmanager; then
return 0
fi
sleep 1
done
return 1
}
if [[ "$MODE" == "update" ]]; then if [[ "$MODE" == "update" ]]; then
if [[ "$RESTART_AFTER" == "1" ]]; then if [[ "$RESTART_AFTER" == "1" ]]; then
echo "==> Запускаю pzmanager"
systemctl start pzmanager systemctl start pzmanager
fi fi
echo echo
if [[ "$OLD_VERSION" == "$NEW_VERSION" ]]; then if [[ "$OLD_VERSION" == "$NEW_VERSION" ]]; then
echo "Переустановлена версия ${NEW_VERSION}." echo "Переустановлена версия ${NEW_VERSION}."
@@ -265,8 +296,22 @@ if [[ "$MODE" == "update" ]]; then
echo "Обновлено: ${OLD_VERSION} -> ${NEW_VERSION}." echo "Обновлено: ${OLD_VERSION} -> ${NEW_VERSION}."
fi fi
echo "Конфиг, миры и учётные записи не тронуты." echo "Конфиг, миры и учётные записи не тронуты."
LISTEN_NOW="$(grep -E '^listen:' "$CONFIG" | head -1 | awk '{print $2}')" LISTEN_NOW="$(grep -E '^listen:' "$CONFIG" | head -1 | awk '{print $2}')"
echo "Панель слушает ${LISTEN_NOW:-?}." if [[ "$RESTART_AFTER" == "1" ]]; then
if wait_active; then
echo "Панель работает и слушает ${LISTEN_NOW:-?}."
else
echo "!! Служба не поднялась. Посмотрите, что случилось:" >&2
echo " journalctl -u pzmanager -n 40 --no-pager" >&2
exit 1
fi
elif systemctl is-active --quiet pzmanager; then
echo "Панель работает и слушает ${LISTEN_NOW:-?}."
else
# Службу останавливали не мы — значит и поднимать её самовольно не стоит.
echo "Служба сейчас остановлена. Запустить: systemctl start pzmanager"
fi
exit 0 exit 0
fi fi
@@ -288,7 +333,13 @@ for _ in $(seq 1 20); do
done done
echo echo
if wait_active; then
echo "Готово. Панель запущена и слушает ${PZ_LISTEN}." echo "Готово. Панель запущена и слушает ${PZ_LISTEN}."
else
echo "!! Служба не поднялась. Посмотрите, что случилось:" >&2
echo " journalctl -u pzmanager -n 40 --no-pager" >&2
exit 1
fi
echo echo
if [[ "$PZ_LISTEN" == 127.0.0.1:* || "$PZ_LISTEN" == localhost:* ]]; then if [[ "$PZ_LISTEN" == 127.0.0.1:* || "$PZ_LISTEN" == localhost:* ]]; then
echo "Панель доступна только с самой машины. Пробросьте порт:" echo "Панель доступна только с самой машины. Пробросьте порт:"
+68 -34
View File
@@ -11,7 +11,11 @@ set -euo pipefail
PZ_REPO="@PZ_REPO@" PZ_REPO="@PZ_REPO@"
PZ_BINARY="@PZ_BINARY@" PZ_BINARY="@PZ_BINARY@"
PZ_HOME="@PZ_HOME@"
PZ_USER="@PZ_USER@"
PZ_SERVICE="pzmanager" PZ_SERVICE="pzmanager"
# Имя разового юнита, в котором идёт обновление.
UPDATE_UNIT="pzmanager-update"
die() { echo "Ошибка: $*" >&2; exit 1; } die() { echo "Ошибка: $*" >&2; exit 1; }
@@ -22,21 +26,57 @@ api_base() {
printf '%s/api/v1/repos/%s' "$host" "${url#"$host"/}" printf '%s/api/v1/repos/%s' "$host" "${url#"$host"/}"
} }
# asset_url ищет в описании релиза ссылку на файл с точным именем.
asset_url() {
local release="$1" name="$2"
printf '%s' "$release" \
| grep -o '"browser_download_url" *: *"[^"]*"' \
| cut -d'"' -f4 \
| while read -r url; do
if [[ "${url##*/}" == "$name" ]]; then
printf '%s' "$url"
return
fi
done
}
# cmd_update только запускает работу и сразу возвращает управление панели.
#
# Обновление обязано пережить перезапуск службы: установщик остановит
# pzmanager, а вместе с ним systemd убьёт и этот скрипт — панель вызывает его
# через sudo, так что он живёт в cgroup её юнита. Поэтому саму работу уносим
# в отдельный разовый юнит, который к pzmanager отношения не имеет.
cmd_update() { cmd_update() {
local version="${1:-latest}" local version="${1:-latest}"
local api release tag url name tmp arch # Версия приходит из панели: проверяем до запуска юнита, чтобы не плодить
# заведомо провальные.
[[ "$version" == "latest" || "$version" =~ ^[A-Za-z0-9._-]+$ ]] \
|| die "недопустимая версия: $version"
command -v systemd-run >/dev/null 2>&1 \
|| die "нет systemd-run — обновите панель командой из README"
case "$(uname -m)" in # --collect убирает юнит после завершения, в том числе неуспешного: иначе
x86_64 | amd64) arch=amd64 ;; # следующий запуск упрётся в оставшийся failed-юнит с тем же именем.
aarch64 | arm64) arch=arm64 ;; systemd-run --quiet --collect --unit="$UPDATE_UNIT" \
*) die "архитектура $(uname -m) не поддерживается" ;; --description="Обновление pzmanager" \
esac "$0" do-update "$version" \
|| die "не удалось запустить обновление разовым юнитом"
echo "Обновление запущено в фоне."
echo "Ход работы: journalctl -u ${UPDATE_UNIT} -f"
}
# cmd_do_update выполняется уже внутри разового юнита. Обновляет всё сразу:
# бинарник, скрипты установки и systemd-юнит, — поэтому просто отдаёт работу
# get.sh из релиза вместо того, чтобы повторять его логику.
cmd_do_update() {
local version="${1:-latest}" api release tag url tmp
api="$(api_base)" api="$(api_base)"
if [[ "$version" == "latest" ]]; then if [[ "$version" == "latest" ]]; then
release="$(curl -fsSL "${api}/releases/latest")" || die "не удалось запросить релиз" release="$(curl -fsSL "${api}/releases/latest")" || die "не удалось запросить релиз"
else else
# Тег приходит из панели; всё, кроме безопасных символов, отвергаем. # Версия приходит из панели; всё, кроме безопасных символов, отвергаем.
[[ "$version" =~ ^[A-Za-z0-9._-]+$ ]] || die "недопустимая версия: $version" [[ "$version" =~ ^[A-Za-z0-9._-]+$ ]] || die "недопустимая версия: $version"
release="$(curl -fsSL "${api}/releases/tags/${version}")" || die "релиз ${version} не найден" release="$(curl -fsSL "${api}/releases/tags/${version}")" || die "релиз ${version} не найден"
fi fi
@@ -44,52 +84,46 @@ cmd_update() {
tag="$(printf '%s' "$release" | grep -o '"tag_name" *: *"[^"]*"' | head -1 | cut -d'"' -f4)" tag="$(printf '%s' "$release" | grep -o '"tag_name" *: *"[^"]*"' | head -1 | cut -d'"' -f4)"
[[ -n "$tag" ]] || die "в ответе нет тега" [[ -n "$tag" ]] || die "в ответе нет тега"
name="pzmanager-linux-${arch}" url="$(asset_url "$release" get.sh)"
url="$(printf '%s' "$release" \ [[ -n "$url" ]] || die "в релизе ${tag} нет get.sh"
| grep -o '"browser_download_url" *: *"[^"]*"' | cut -d'"' -f4 \
| while read -r candidate; do
[[ "${candidate##*/}" == "$name" ]] && { printf '%s' "$candidate"; break; }
done)"
[[ -n "$url" ]] || die "в релизе ${tag} нет файла ${name}"
local sums_url local sums_url
sums_url="$(printf '%s' "$release" \ sums_url="$(asset_url "$release" checksums.txt)"
| grep -o '"browser_download_url" *: *"[^"]*"' | cut -d'"' -f4 \
| while read -r candidate; do
[[ "${candidate##*/}" == "checksums.txt" ]] && { printf '%s' "$candidate"; break; }
done)"
[[ -n "$sums_url" ]] || die "в релизе ${tag} нет checksums.txt" [[ -n "$sums_url" ]] || die "в релизе ${tag} нет checksums.txt"
tmp="$(mktemp -d)" tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' RETURN trap 'rm -rf "$tmp"' RETURN
echo "==> Скачиваю ${tag} (${arch})" echo "==> Беру установщик из ${tag}"
curl -fsSL -o "${tmp}/${name}" "$url" || die "не удалось скачать ${name}" curl -fsSL -o "${tmp}/get.sh" "$url" || die "не удалось скачать get.sh"
curl -fsSL -o "${tmp}/checksums.txt" "$sums_url" || die "не удалось скачать checksums.txt" curl -fsSL -o "${tmp}/checksums.txt" "$sums_url" || die "не удалось скачать checksums.txt"
echo "==> Проверяю контрольную сумму" echo "==> Проверяю контрольную сумму"
( cd "$tmp" && grep " ${name}\$" checksums.txt > expected.txt && sha256sum -c expected.txt ) \ ( cd "$tmp" && awk '$NF == "get.sh"' checksums.txt > expected.txt \
|| die "контрольная сумма не сошлась — файл повреждён или подменён" && [[ -s expected.txt ]] && sha256sum -c expected.txt ) \
|| die "контрольная сумма get.sh не сошлась"
echo "==> Заменяю ${PZ_BINARY}" echo "==> Обновляю до ${tag}"
chmod 0755 "${tmp}/${name}" # get.sh скачает бинарник нужной архитектуры и запустит install.sh, который
# Через временный файл рядом и rename: перезаписать работающий бинарник # сам остановит службу, заменит файлы и поднимет её обратно.
# нельзя, а переименовать поверх — можно. PZ_HOME="$PZ_HOME" PZ_USER="$PZ_USER" PZ_REPO="$PZ_REPO" PZ_VERSION="$tag" \
install -m 0755 "${tmp}/${name}" "${PZ_BINARY}.new" bash "${tmp}/get.sh" \
mv -f "${PZ_BINARY}.new" "${PZ_BINARY}" || die "обновление не удалось"
echo "==> Перезапускаю ${PZ_SERVICE}" echo "Обновление до ${tag} завершено"
systemctl restart "$PZ_SERVICE"
echo "Обновлено до ${tag}"
} }
case "${1:-}" in case "${1:-}" in
update) update)
cmd_update "${2:-latest}" cmd_update "${2:-latest}"
;; ;;
do-update)
cmd_do_update "${2:-latest}"
;;
restart) restart)
echo "==> Перезапускаю ${PZ_SERVICE}" echo "==> Перезапускаю ${PZ_SERVICE}"
systemctl restart "$PZ_SERVICE" # --no-block: команда ставит задание и выходит, не дожидаясь остановки.
# Иначе systemd убил бы нас вместе со службой на середине ожидания.
systemctl restart --no-block "$PZ_SERVICE"
;; ;;
version) version)
"$PZ_BINARY" version "$PZ_BINARY" version
+5 -1
View File
@@ -19,7 +19,11 @@ KillMode=mixed
TimeoutStopSec=300 TimeoutStopSec=300
# Всё своё панель держит в /opt/pzmanager, домашние каталоги ей не нужны. # Всё своё панель держит в /opt/pzmanager, домашние каталоги ей не нужны.
NoNewPrivileges=true #
# NoNewPrivileges здесь намеренно не выставлен: он запрещает процессу и его
# потомкам повышать привилегии, а значит ломает sudo — и вместе с ним кнопки
# обновления и перезапуска панели. Прикрытием служит sudoers: сервисному
# пользователю разрешена ровно одна команда, pzmanager-admin.
PrivateTmp=true PrivateTmp=true
ProtectSystem=full ProtectSystem=full
ProtectHome=true ProtectHome=true
+32
View File
@@ -7,15 +7,36 @@ import (
"os" "os"
"github.com/mrleo1nid/pzmanager/internal/config" "github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
"github.com/mrleo1nid/pzmanager/internal/pzserver" "github.com/mrleo1nid/pzmanager/internal/pzserver"
) )
// validateProfileMemory проверяет границы кучи JVM здесь, а не при запуске
// сервера: иначе про опечатку в профиле стало бы известно только из лога
// упавшего сервера.
func validateProfileMemory(dto profileDTO) error {
maxBytes, err := pzconfig.ParseMemory(dto.JavaMemory)
if err != nil {
return err
}
minBytes, err := pzconfig.ParseMemory(dto.JavaMemoryMin)
if err != nil {
return err
}
if maxBytes > 0 && minBytes > maxBytes {
return fmt.Errorf("начальный размер памяти (%s) больше максимального (%s)",
dto.JavaMemoryMin, dto.JavaMemory)
}
return nil
}
// profileDTO — профиль в том виде, в каком его показывает панель. Пароль // profileDTO — профиль в том виде, в каком его показывает панель. Пароль
// наружу не отдаётся, только признак того, что он задан. // наружу не отдаётся, только признак того, что он задан.
type profileDTO struct { type profileDTO struct {
ID string `json:"id"` ID string `json:"id"`
Title string `json:"title"` Title string `json:"title"`
JavaMemory string `json:"java_memory"` JavaMemory string `json:"java_memory"`
JavaMemoryMin string `json:"java_memory_min"`
ExtraArgs []string `json:"extra_args"` ExtraArgs []string `json:"extra_args"`
HasAdminPassword bool `json:"has_admin_password"` HasAdminPassword bool `json:"has_admin_password"`
AdminPassword string `json:"admin_password,omitempty"` AdminPassword string `json:"admin_password,omitempty"`
@@ -33,6 +54,7 @@ func (s *Server) profileToDTO(p config.Profile) profileDTO {
ID: p.ID, ID: p.ID,
Title: p.Title, Title: p.Title,
JavaMemory: p.JavaMemory, JavaMemory: p.JavaMemory,
JavaMemoryMin: p.JavaMemoryMin,
ExtraArgs: p.ExtraArgs, ExtraArgs: p.ExtraArgs,
HasAdminPassword: p.AdminPassword != "", HasAdminPassword: p.AdminPassword != "",
HasConfig: fileExists(s.cfg.ServerConfigPathFor(p.ID)), HasConfig: fileExists(s.cfg.ServerConfigPathFor(p.ID)),
@@ -61,11 +83,16 @@ func (s *Server) handleCreateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) { if !decodeJSON(w, r, &dto) {
return return
} }
if err := validateProfileMemory(dto); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
profile := config.Profile{ profile := config.Profile{
ID: dto.ID, ID: dto.ID,
Title: dto.Title, Title: dto.Title,
JavaMemory: dto.JavaMemory, JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs, ExtraArgs: dto.ExtraArgs,
AdminPassword: dto.AdminPassword, AdminPassword: dto.AdminPassword,
} }
@@ -133,11 +160,16 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) { if !decodeJSON(w, r, &dto) {
return return
} }
if err := validateProfileMemory(dto); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
updated := config.Profile{ updated := config.Profile{
ID: id, ID: id,
Title: dto.Title, Title: dto.Title,
JavaMemory: dto.JavaMemory, JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs, ExtraArgs: dto.ExtraArgs,
// Пустой пароль означает "оставить прежний": наружу мы его не отдаём, // Пустой пароль означает "оставить прежний": наружу мы его не отдаём,
// и форма присылает пустую строку, пока его не меняли. // и форма присылает пустую строку, пока его не меняли.
+6 -2
View File
@@ -236,12 +236,16 @@ func StartBackupScheduler(ctx context.Context, s *Server) {
// При обычном старте то же самое делает супервизор. // При обычном старте то же самое делает супервизор.
func (s *Server) applyJavaMemory(log func(string)) error { func (s *Server) applyJavaMemory(log func(string)) error {
profile := s.cfg.ActiveProfile() profile := s.cfg.ActiveProfile()
if profile.JavaMemory == "" { if profile.JavaMemory == "" && profile.JavaMemoryMin == "" {
return nil return nil
} }
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil { if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory, profile.JavaMemoryMin); err != nil {
return err return err
} }
if profile.JavaMemoryMin != "" {
log(fmt.Sprintf("Память JVM: от %s до %s", profile.JavaMemoryMin, profile.JavaMemory))
} else {
log("Лимит памяти JVM выставлен: " + profile.JavaMemory) log("Лимит памяти JVM выставлен: " + profile.JavaMemory)
}
return nil return nil
} }
+2 -1
View File
@@ -35,7 +35,8 @@ func (s *Server) handleApplyUpdate(w http.ResponseWriter, r *http.Request) {
// Игровой сервер останавливаем сами: иначе это сделает systemd уже в // Игровой сервер останавливаем сами: иначе это сделает systemd уже в
// момент перезапуска, и ожидание растянется на таймаут остановки. // момент перезапуска, и ожидание растянется на таймаут остановки.
s.stopServerBefore(log, "обновлением") s.stopServerBefore(log, "обновлением")
log("Запускаю обновление, панель перезапустится") log("Запускаю обновление — оно идёт отдельной службой и переживёт перезапуск панели")
log("Подробности: journalctl -u pzmanager-update -f")
return s.updater.Apply(ctx, log, body.Version) return s.updater.Apply(ctx, log, body.Version)
}) })
if err != nil { if err != nil {
+5
View File
@@ -34,6 +34,11 @@ type Profile struct {
// запуске: файл запуска сервера общий для всех профилей. // запуске: файл запуска сервера общий для всех профилей.
JavaMemory string `yaml:"java_memory"` JavaMemory string `yaml:"java_memory"`
// JavaMemoryMin — -Xms. Пусто (по умолчанию) означает, что JVM занимает
// память по мере надобности: равные -Xms и -Xmx заставляют её забрать всё
// сразу, и на машине с небольшой ОЗУ сервер не поднимется.
JavaMemoryMin string `yaml:"java_memory_min"`
// ExtraArgs — дополнительные аргументы start-server.sh. // ExtraArgs — дополнительные аргументы start-server.sh.
ExtraArgs []string `yaml:"extra_args"` ExtraArgs []string `yaml:"extra_args"`
} }
+63 -13
View File
@@ -6,24 +6,71 @@ import (
"os" "os"
"path/filepath" "path/filepath"
"regexp" "regexp"
"strconv"
"strings" "strings"
) )
// javaLauncherFile — файл, из которого сервер берёт аргументы JVM. // javaLauncherFile — файл, из которого сервер берёт аргументы JVM.
const javaLauncherFile = "ProjectZomboid64.json" const javaLauncherFile = "ProjectZomboid64.json"
var xmxRe = regexp.MustCompile(`^-Xm[sx]`) var (
heapArgRe = regexp.MustCompile(`^-Xm[sx]`)
memoryRe = regexp.MustCompile(`^([0-9]+)([kKmMgG])$`)
)
// SetJavaMemory прописывает лимит памяти JVM в ProjectZomboid64.json. Именно // ParseMemory переводит запись вида "4g" в байты. Возвращает 0, если строка
// оттуда start-server.sh берёт -Xmx, поэтому менять размер памяти в аргументах // пустая, и ошибку, если формат непонятен.
// запуска бесполезно. func ParseMemory(value string) (int64, error) {
func SetJavaMemory(serverDir, memory string) error { value = strings.TrimSpace(value)
memory = strings.TrimSpace(memory) if value == "" {
if memory == "" { return 0, nil
}
match := memoryRe.FindStringSubmatch(value)
if match == nil {
return 0, fmt.Errorf("объём памяти должен выглядеть как 4g или 8192m, получено %q", value)
}
amount, err := strconv.ParseInt(match[1], 10, 64)
if err != nil {
return 0, fmt.Errorf("не разобран объём памяти %q", value)
}
switch strings.ToLower(match[2]) {
case "k":
return amount * 1024, nil
case "m":
return amount * 1024 * 1024, nil
default:
return amount * 1024 * 1024 * 1024, nil
}
}
// SetJavaMemory прописывает границы кучи JVM в ProjectZomboid64.json. Именно
// оттуда start-server.sh берёт -Xmx и -Xms, поэтому менять размер памяти в
// аргументах запуска бесполезно.
//
// maxMemory задаёт -Xmx (верхнюю границу), minMemory — -Xms. Пустой minMemory
// означает, что -Xms не выставляется вовсе: JVM тогда занимает память по мере
// надобности. Равные значения удобны тем, что куча не растёт на ходу, но JVM
// обязана занять весь объём при старте — на машине с небольшой ОЗУ сервер
// просто не поднимется.
func SetJavaMemory(serverDir, maxMemory, minMemory string) error {
maxMemory = strings.TrimSpace(maxMemory)
minMemory = strings.TrimSpace(minMemory)
if maxMemory == "" && minMemory == "" {
return nil return nil
} }
if !regexp.MustCompile(`^[0-9]+[kKmMgG]$`).MatchString(memory) {
return fmt.Errorf("объём памяти должен выглядеть как 4g или 8192m, получено %q", memory) maxBytes, err := ParseMemory(maxMemory)
if err != nil {
return err
}
minBytes, err := ParseMemory(minMemory)
if err != nil {
return err
}
// JVM с -Xms больше -Xmx не стартует вообще, поэтому ловим это здесь, а не
// в логе упавшего сервера.
if maxBytes > 0 && minBytes > maxBytes {
return fmt.Errorf("начальный размер кучи (%s) больше максимального (%s)", minMemory, maxMemory)
} }
path := filepath.Join(serverDir, javaLauncherFile) path := filepath.Join(serverDir, javaLauncherFile)
@@ -41,14 +88,17 @@ func SetJavaMemory(serverDir, memory string) error {
args, _ := doc["vmArgs"].([]any) args, _ := doc["vmArgs"].([]any)
updated := make([]any, 0, len(args)+2) updated := make([]any, 0, len(args)+2)
for _, a := range args { for _, a := range args {
if str, ok := a.(string); ok && xmxRe.MatchString(str) { if str, ok := a.(string); ok && heapArgRe.MatchString(str) {
continue continue
} }
updated = append(updated, a) updated = append(updated, a)
} }
// -Xms равным -Xmx: JVM сразу забирает память и не тратит время на рост if minMemory != "" {
// кучи в момент, когда на сервере много игроков. updated = append(updated, "-Xms"+minMemory)
updated = append(updated, "-Xms"+memory, "-Xmx"+memory) }
if maxMemory != "" {
updated = append(updated, "-Xmx"+maxMemory)
}
doc["vmArgs"] = updated doc["vmArgs"] = updated
out, err := json.MarshalIndent(doc, "", " ") out, err := json.MarshalIndent(doc, "", " ")
+167
View File
@@ -0,0 +1,167 @@
package pzconfig
import (
"encoding/json"
"os"
"path/filepath"
"testing"
)
// TestSetJavaMemoryKeepsOnlyXmx: -Xms равным -Xmx заставляет JVM занять весь
// объём при старте, и на машине с небольшой ОЗУ сервер падает с «Failed to
// allocate initial Java heap». Ставим только верхнюю границу.
func TestSetJavaMemoryKeepsOnlyXmx(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{
"mainClass": "zombie/network/GameServer",
"vmArgs": []any{
"-Djava.awt.headless=true",
"-XX:+UseZGC",
// Значения от прошлой установки должны замениться.
"-Xms8g",
"-Xmx8g",
},
})
if err := SetJavaMemory(dir, "3g", ""); err != nil {
t.Fatal(err)
}
args := launcherArgs(t, dir)
var xms, xmx int
for _, a := range args {
switch {
case len(a) > 4 && a[:4] == "-Xms":
xms++
t.Errorf("в аргументах остался %s — JVM займёт всю память при старте", a)
case a == "-Xmx3g":
xmx++
}
}
if xms != 0 {
t.Errorf("-Xms не должен добавляться, найдено вхождений: %d", xms)
}
if xmx != 1 {
t.Errorf("-Xmx3g встречается %d раз, ожидалось 1: %v", xmx, args)
}
// Чужие аргументы должны остаться нетронутыми.
if !contains(args, "-XX:+UseZGC") || !contains(args, "-Djava.awt.headless=true") {
t.Errorf("потеряны исходные аргументы: %v", args)
}
}
func TestSetJavaMemoryValidates(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{"vmArgs": []any{}})
for _, bad := range []string{"4", "4gb", "много", "-4g", "4g; rm -rf /"} {
if err := SetJavaMemory(dir, bad, ""); err == nil {
t.Errorf("значение %q принято, ожидалась ошибка", bad)
}
}
// Пустые значения — «не трогать», это не ошибка.
if err := SetJavaMemory(dir, "", ""); err != nil {
t.Errorf("пустое значение вернуло ошибку: %v", err)
}
for _, good := range []string{"512m", "4g", "8G", "16384M"} {
if err := SetJavaMemory(dir, good, ""); err != nil {
t.Errorf("значение %q отклонено: %v", good, err)
}
}
// JVM с -Xms больше -Xmx не стартует, поэтому ловим это заранее.
if err := SetJavaMemory(dir, "2g", "4g"); err == nil {
t.Error("начальный размер больше максимального принят, ожидалась ошибка")
}
if err := SetJavaMemory(dir, "4g", "2g"); err != nil {
t.Errorf("корректная пара 2g/4g отклонена: %v", err)
}
}
func writeLauncher(t *testing.T, dir string, doc map[string]any) {
t.Helper()
raw, err := json.MarshalIndent(doc, "", " ")
if err != nil {
t.Fatal(err)
}
if err := os.WriteFile(filepath.Join(dir, javaLauncherFile), raw, 0o644); err != nil {
t.Fatal(err)
}
}
func launcherArgs(t *testing.T, dir string) []string {
t.Helper()
raw, err := os.ReadFile(filepath.Join(dir, javaLauncherFile))
if err != nil {
t.Fatal(err)
}
var doc struct {
VMArgs []string `json:"vmArgs"`
}
if err := json.Unmarshal(raw, &doc); err != nil {
t.Fatal(err)
}
return doc.VMArgs
}
func contains(list []string, want string) bool {
for _, item := range list {
if item == want {
return true
}
}
return false
}
// TestSetJavaMemoryWritesXmsWhenAsked: минимальный размер кучи задаётся
// отдельно и попадает в файл, только если его действительно указали.
func TestSetJavaMemoryWritesXmsWhenAsked(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{"vmArgs": []any{"-XX:+UseZGC"}})
if err := SetJavaMemory(dir, "6g", "2g"); err != nil {
t.Fatal(err)
}
args := launcherArgs(t, dir)
if !contains(args, "-Xms2g") || !contains(args, "-Xmx6g") {
t.Fatalf("границы кучи не выставлены: %v", args)
}
// Убрали минимум — из файла он тоже должен уйти.
if err := SetJavaMemory(dir, "6g", ""); err != nil {
t.Fatal(err)
}
args = launcherArgs(t, dir)
for _, a := range args {
if len(a) > 4 && a[:4] == "-Xms" {
t.Errorf("после очистки минимума остался %s: %v", a, args)
}
}
if !contains(args, "-Xmx6g") {
t.Errorf("максимум потерян: %v", args)
}
}
func TestParseMemory(t *testing.T) {
cases := map[string]int64{
"": 0,
"512m": 512 * 1024 * 1024,
"4g": 4 * 1024 * 1024 * 1024,
"8G": 8 * 1024 * 1024 * 1024,
"1024k": 1024 * 1024,
}
for input, want := range cases {
got, err := ParseMemory(input)
if err != nil {
t.Errorf("ParseMemory(%q): %v", input, err)
continue
}
if got != want {
t.Errorf("ParseMemory(%q) = %d, ожидалось %d", input, got, want)
}
}
if _, err := ParseMemory("4гб"); err == nil {
t.Error("значение с кириллицей принято")
}
}
+19 -1
View File
@@ -1,6 +1,20 @@
package pzserver package pzserver
import "sync" import (
"regexp"
"sync"
)
// ansiRe ловит управляющие последовательности терминала: SteamCMD и сам
// сервер раскрашивают вывод, а в браузере эти коды превращаются в мусор
// вида "[0mOK". Первый вариант — CSI (цвета, перемещение курсора), второй —
// всё остальное, что начинается с ESC.
var ansiRe = regexp.MustCompile("\x1b\\[[0-9;?]*[ -/]*[@-~]|\x1b.")
// stripANSI убирает управляющие последовательности из строки вывода.
func stripANSI(text string) string {
return ansiRe.ReplaceAllString(text, "")
}
// LogLine — одна строка консоли сервера с монотонным номером, по которому // LogLine — одна строка консоли сервера с монотонным номером, по которому
// веб-клиент понимает, что он пропустил, и откуда догружать. // веб-клиент понимает, что он пропустил, и откуда догружать.
@@ -33,6 +47,10 @@ func newLogBuffer(capacity int) *logBuffer {
// append кладёт строку в буфер и рассылает подписчикам. // append кладёт строку в буфер и рассылает подписчикам.
func (b *logBuffer) append(line LogLine) { func (b *logBuffer) append(line LogLine) {
// Чистим здесь, а не у каждого источника: через буфер проходят и вывод
// сервера, и SteamCMD, и сообщения самой панели.
line.Text = stripANSI(line.Text)
b.mu.Lock() b.mu.Lock()
line.Seq = b.nextSeq line.Seq = b.nextSeq
b.nextSeq++ b.nextSeq++
+41
View File
@@ -0,0 +1,41 @@
package pzserver
import "testing"
// TestStripANSI берёт строки ровно в том виде, в каком их печатает SteamCMD:
// в браузере коды раскраски превращались в мусор вроде "[0mOK".
func TestStripANSI(t *testing.T) {
cases := map[string]string{
"\x1b[0mConnecting anonymously to Steam Public...\x1b[0mOK": "Connecting anonymously to Steam Public...OK",
"\x1b[0m Update state (0x3) reconfiguring, progress: 0.00": " Update state (0x3) reconfiguring, progress: 0.00",
"\x1b[1;32mSuccess!\x1b[0m": "Success!",
// Перемещение курсора и очистка строки — тоже CSI.
"\x1b[2K\x1b[1GЗагрузка": "Загрузка",
// Обычные строки не должны меняться.
"[----] Installing update...": "[----] Installing update...",
"Steam Console Client (c) Valve": "Steam Console Client (c) Valve",
"Мир сохранён, игроков онлайн: 3": "Мир сохранён, игроков онлайн: 3",
"": "",
}
for input, want := range cases {
if got := stripANSI(input); got != want {
t.Errorf("stripANSI(%q) = %q, ожидалось %q", input, got, want)
}
}
}
// TestAppendStripsANSI проверяет, что чистка стоит на общем пути: через буфер
// идёт и вывод сервера, и SteamCMD, и сообщения самой панели.
func TestAppendStripsANSI(t *testing.T) {
buf := newLogBuffer(10)
buf.append(LogLine{Stream: "task", Text: "\x1b[0mWaiting for user info...\x1b[0mOK"})
lines := buf.since(0)
if len(lines) != 1 {
t.Fatalf("строк в буфере: %d", len(lines))
}
if lines[0].Text != "Waiting for user info...OK" {
t.Errorf("в буфер попала строка с кодами: %q", lines[0].Text)
}
}
+89 -4
View File
@@ -24,6 +24,9 @@ type State string
const ( const (
StateStopped State = "stopped" StateStopped State = "stopped"
// StateRestarting — сервер упал и ждёт автоподъёма. Отдельное состояние
// нужно, чтобы это ожидание можно было отменить кнопкой.
StateRestarting State = "restarting"
StateStarting State = "starting" StateStarting State = "starting"
StateRunning State = "running" StateRunning State = "running"
StateStopping State = "stopping" StateStopping State = "stopping"
@@ -42,6 +45,14 @@ const playersPollInterval = 30 * time.Second
// restartDelay — пауза перед автоподъёмом упавшего сервера. // restartDelay — пауза перед автоподъёмом упавшего сервера.
const restartDelay = 10 * time.Second const restartDelay = 10 * time.Second
// Сервер, падающий сразу после старта, автоперезапуском не лечится: обычно
// это нехватка памяти или испорченный конфиг. После нескольких таких падений
// подряд перестаём поднимать его сам, чтобы не крутить бесконечный цикл.
const (
quickCrashWindow = time.Minute
maxQuickCrashes = 3
)
// Status — снимок состояния для веб-панели. // Status — снимок состояния для веб-панели.
type Status struct { type Status struct {
State State `json:"state"` State State `json:"state"`
@@ -56,6 +67,8 @@ type Status struct {
PlayersAt int64 `json:"players_at"` PlayersAt int64 `json:"players_at"`
LastExit string `json:"last_exit"` LastExit string `json:"last_exit"`
AutoRestart bool `json:"auto_restart"` AutoRestart bool `json:"auto_restart"`
// RestartInSec — сколько секунд осталось до автоподъёма (0, если не ждём).
RestartInSec int64 `json:"restart_in_sec"`
Proc sysinfo.ProcStats `json:"proc"` Proc sysinfo.ProcStats `json:"proc"`
Host sysinfo.HostStats `json:"host"` Host sysinfo.HostStats `json:"host"`
} }
@@ -89,6 +102,13 @@ type Supervisor struct {
captured []string captured []string
autoQuery bool autoQuery bool
// restartCancel закрывается, чтобы отменить ожидание автоперезапуска;
// restartAt — когда оно закончится.
restartCancel chan struct{}
restartAt time.Time
// crashStreak — сколько раз подряд сервер упал сразу после запуска.
crashStreak int
sampler *sysinfo.Sampler sampler *sysinfo.Sampler
stopOnce sync.Once stopOnce sync.Once
quit chan struct{} quit chan struct{}
@@ -165,9 +185,14 @@ func (s *Supervisor) Status() Status {
if s.cmd != nil && s.cmd.Process != nil { if s.cmd != nil && s.cmd.Process != nil {
st.PID = s.cmd.Process.Pid st.PID = s.cmd.Process.Pid
} }
if !s.startedAt.IsZero() && s.state != StateStopped { if !s.startedAt.IsZero() && s.state != StateStopped && s.state != StateRestarting {
st.UptimeSec = int64(time.Since(s.startedAt).Seconds()) st.UptimeSec = int64(time.Since(s.startedAt).Seconds())
} }
if s.state == StateRestarting && !s.restartAt.IsZero() {
if left := time.Until(s.restartAt).Seconds(); left > 0 {
st.RestartInSec = int64(left + 0.5)
}
}
s.mu.Unlock() s.mu.Unlock()
st.Installed = s.Installed() st.Installed = s.Installed()
@@ -185,9 +210,28 @@ func (s *Supervisor) Status() Status {
func (s *Supervisor) Start() error { func (s *Supervisor) Start() error {
s.mu.Lock() s.mu.Lock()
defer s.mu.Unlock() defer s.mu.Unlock()
// Запуск руками — знак, что причину падений устранили.
s.crashStreak = 0
// Если ждали автоподъёма, поднимаем немедленно.
s.cancelRestartLocked()
return s.startLocked() return s.startLocked()
} }
// cancelRestartLocked снимает запланированный автоперезапуск. Вызывается под
// удержанным s.mu.
func (s *Supervisor) cancelRestartLocked() {
if s.restartCancel == nil {
return
}
close(s.restartCancel)
s.restartCancel = nil
s.restartAt = time.Time{}
if s.state == StateRestarting {
s.state = StateStopped
}
}
func (s *Supervisor) startLocked() error { func (s *Supervisor) startLocked() error {
if s.state != StateStopped { if s.state != StateStopped {
return ErrAlreadyRunning return ErrAlreadyRunning
@@ -204,8 +248,8 @@ func (s *Supervisor) startLocked() error {
profile := s.cfg.ActiveProfile() profile := s.cfg.ActiveProfile()
// Лимит памяти живёт в файле запуска, общем для всех профилей, поэтому // Лимит памяти живёт в файле запуска, общем для всех профилей, поэтому
// выставляем его на каждом старте — иначе профиль унаследует чужой -Xmx. // выставляем его на каждом старте — иначе профиль унаследует чужой -Xmx.
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil { if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory, profile.JavaMemoryMin); err != nil {
s.AppendLog("manager", "Не удалось выставить лимит памяти JVM: "+err.Error()) s.AppendLog("manager", "Не удалось выставить границы памяти JVM: "+err.Error())
} }
args := []string{"-servername", profile.ID} args := []string{"-servername", profile.ID}
@@ -322,6 +366,8 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
err := cmd.Wait() err := cmd.Wait()
close(exited) close(exited)
lifetime := time.Since(s.startedAt)
s.mu.Lock() s.mu.Lock()
wasIntentional := s.intentionalStop wasIntentional := s.intentionalStop
s.state = StateStopped s.state = StateStopped
@@ -336,6 +382,15 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
s.lastExit = "штатное завершение" s.lastExit = "штатное завершение"
} }
reason := s.lastExit reason := s.lastExit
// Падение сразу после запуска — признак того, что перезапуск не поможет:
// не хватило памяти, испорчен конфиг, нет файлов сервера.
if !wasIntentional && lifetime < quickCrashWindow {
s.crashStreak++
} else {
s.crashStreak = 0
}
streak := s.crashStreak
autoRestart := s.cfg.AutoRestart && !wasIntentional autoRestart := s.cfg.AutoRestart && !wasIntentional
s.mu.Unlock() s.mu.Unlock()
@@ -343,14 +398,38 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
if !autoRestart { if !autoRestart {
return return
} }
if streak >= maxQuickCrashes {
s.AppendLog("manager", fmt.Sprintf(
"Сервер падает сразу после запуска %d раза подряд — автоперезапуск остановлен. "+
"Посмотрите ошибку выше и запустите сервер вручную.", streak))
return
}
s.mu.Lock()
cancel := make(chan struct{})
s.restartCancel = cancel
s.restartAt = time.Now().Add(restartDelay)
s.state = StateRestarting
s.mu.Unlock()
s.AppendLog("manager", fmt.Sprintf("Автоперезапуск через %s (можно отменить кнопкой «Остановить»)", restartDelay))
s.AppendLog("manager", fmt.Sprintf("Автоперезапуск через %s", restartDelay))
select { select {
case <-time.After(restartDelay): case <-time.After(restartDelay):
case <-cancel:
// Состояние уже переставил тот, кто отменил ожидание.
s.AppendLog("manager", "Автоперезапуск отменён")
return
case <-s.quit: case <-s.quit:
return return
} }
s.mu.Lock() s.mu.Lock()
s.restartCancel = nil
s.restartAt = time.Time{}
if s.state == StateRestarting {
s.state = StateStopped
}
err = s.startLocked() err = s.startLocked()
s.mu.Unlock() s.mu.Unlock()
if err != nil && !errors.Is(err, ErrAlreadyRunning) { if err != nil && !errors.Is(err, ErrAlreadyRunning) {
@@ -394,6 +473,12 @@ func (s *Supervisor) sendQuiet(command string) error {
// мир), затем SIGTERM группе процессов и в крайнем случае SIGKILL. // мир), затем SIGTERM группе процессов и в крайнем случае SIGKILL.
func (s *Supervisor) Stop() error { func (s *Supervisor) Stop() error {
s.mu.Lock() s.mu.Lock()
// Ждём автоподъёма — «остановить» здесь значит «не поднимать».
if s.state == StateRestarting {
s.cancelRestartLocked()
s.mu.Unlock()
return nil
}
if s.state == StateStopped || s.cmd == nil { if s.state == StateStopped || s.cmd == nil {
s.mu.Unlock() s.mu.Unlock()
return ErrNotRunning return ErrNotRunning
+69 -14
View File
@@ -16,6 +16,7 @@ import (
"fmt" "fmt"
"net/http" "net/http"
"os/exec" "os/exec"
"sort"
"strconv" "strconv"
"strings" "strings"
"time" "time"
@@ -27,6 +28,14 @@ const adminCommand = "pzmanager-admin"
// ErrNoAdmin возвращается, когда обновление из панели недоступно. // ErrNoAdmin возвращается, когда обновление из панели недоступно.
var ErrNoAdmin = errors.New("обновление из панели недоступно: нет pzmanager-admin или правила sudo") var ErrNoAdmin = errors.New("обновление из панели недоступно: нет pzmanager-admin или правила sudo")
// ReleaseNote — одна версия в списке изменений.
type ReleaseNote struct {
Version string `json:"version"`
Notes string `json:"notes"`
Published int64 `json:"published"`
URL string `json:"url"`
}
// Info — то, что панель показывает в разделе обновления. // Info — то, что панель показывает в разделе обновления.
type Info struct { type Info struct {
Current string `json:"current"` Current string `json:"current"`
@@ -40,6 +49,10 @@ type Info struct {
CanApply bool `json:"can_apply"` CanApply bool `json:"can_apply"`
// ManualCommand — что выполнить в терминале, если сама не может. // ManualCommand — что выполнить в терминале, если сама не может.
ManualCommand string `json:"manual_command"` ManualCommand string `json:"manual_command"`
// Changelog — все версии между установленной и последней, свежие первыми.
// Одного описания последнего релиза мало: пропустив пару версий, человек
// не увидит, что менялось в промежутке.
Changelog []ReleaseNote `json:"changelog"`
// Error — почему не удалось узнать последнюю версию. // Error — почему не удалось узнать последнюю версию.
Error string `json:"error,omitempty"` Error string `json:"error,omitempty"`
} }
@@ -75,12 +88,14 @@ func (u *Updater) apiBase() (string, error) {
return fmt.Sprintf("%s://%s/api/v1/repos/%s", scheme, host, path), nil return fmt.Sprintf("%s://%s/api/v1/repos/%s", scheme, host, path), nil
} }
// Check спрашивает у Gitea последний релиз и сравнивает его с текущей версией. // Check спрашивает у Gitea список релизов и оставляет те, что новее
// установленной версии.
func (u *Updater) Check(ctx context.Context) Info { func (u *Updater) Check(ctx context.Context) Info {
info := Info{ info := Info{
Current: u.Version, Current: u.Version,
CanApply: u.CanApply(ctx), CanApply: u.CanApply(ctx),
ManualCommand: u.manualCommand(), ManualCommand: u.manualCommand(),
Changelog: []ReleaseNote{},
} }
api, err := u.apiBase() api, err := u.apiBase()
@@ -89,7 +104,10 @@ func (u *Updater) Check(ctx context.Context) Info {
return info return info
} }
req, err := http.NewRequestWithContext(ctx, http.MethodGet, api+"/releases/latest", nil) // limit с запасом: показываем изменения за все пропущенные версии, но не
// тянем историю репозитория целиком.
req, err := http.NewRequestWithContext(ctx, http.MethodGet,
api+"/releases?limit=30&draft=false", nil)
if err != nil { if err != nil {
info.Error = err.Error() info.Error = err.Error()
return info return info
@@ -101,36 +119,73 @@ func (u *Updater) Check(ctx context.Context) Info {
} }
defer resp.Body.Close() defer resp.Body.Close()
if resp.StatusCode == http.StatusNotFound {
info.Error = "в репозитории ещё нет релизов"
return info
}
if resp.StatusCode != http.StatusOK { if resp.StatusCode != http.StatusOK {
info.Error = "репозиторий ответил " + resp.Status info.Error = "репозиторий ответил " + resp.Status
return info return info
} }
var release struct { var releases []struct {
TagName string `json:"tag_name"` TagName string `json:"tag_name"`
Body string `json:"body"` Body string `json:"body"`
HTMLURL string `json:"html_url"` HTMLURL string `json:"html_url"`
PublishedAt time.Time `json:"published_at"` PublishedAt time.Time `json:"published_at"`
Draft bool `json:"draft"`
Prerelease bool `json:"prerelease"`
} }
if err := json.NewDecoder(resp.Body).Decode(&release); err != nil { if err := json.NewDecoder(resp.Body).Decode(&releases); err != nil {
info.Error = "ответ репозитория не разобран: " + err.Error() info.Error = "ответ репозитория не разобран: " + err.Error()
return info return info
} }
info.Latest = release.TagName notes := make([]ReleaseNote, 0, len(releases))
info.Notes = release.Body for _, r := range releases {
info.URL = release.HTMLURL if r.Draft || r.Prerelease || r.TagName == "" {
if !release.PublishedAt.IsZero() { continue
info.Published = release.PublishedAt.Unix()
} }
info.Available = IsNewer(u.Version, release.TagName) note := ReleaseNote{Version: r.TagName, Notes: r.Body, URL: r.HTMLURL}
if !r.PublishedAt.IsZero() {
note.Published = r.PublishedAt.Unix()
}
notes = append(notes, note)
}
if len(notes) == 0 {
info.Error = "в репозитории ещё нет релизов"
return info return info
} }
// Gitea отдаёт релизы свежими вперёд, но полагаться на это не станем.
sort.Slice(notes, func(i, j int) bool {
if IsNewer(notes[j].Version, notes[i].Version) {
return true
}
if IsNewer(notes[i].Version, notes[j].Version) {
return false
}
return notes[i].Published > notes[j].Published
})
latest := notes[0]
info.Latest = latest.Version
info.Notes = latest.Notes
info.URL = latest.URL
info.Published = latest.Published
info.Available = IsNewer(u.Version, latest.Version)
info.Changelog = NewerThan(notes, u.Version)
return info
}
// NewerThan оставляет из списка релизы новее указанной версии, сохраняя
// порядок «свежие первыми».
func NewerThan(notes []ReleaseNote, current string) []ReleaseNote {
out := make([]ReleaseNote, 0, len(notes))
for _, note := range notes {
if IsNewer(current, note.Version) {
out = append(out, note)
}
}
return out
}
// CanApply проверяет, что привилегированный скрипт на месте и sudo пускает к // CanApply проверяет, что привилегированный скрипт на месте и sudo пускает к
// нему без пароля. Проверяем вызовом: наличие файла ещё не значит, что // нему без пароля. Проверяем вызовом: наличие файла ещё не значит, что
// правило sudoers действует. // правило sudoers действует.
+30
View File
@@ -57,3 +57,33 @@ func TestAPIBase(t *testing.T) {
} }
} }
} }
func TestNewerThan(t *testing.T) {
notes := []ReleaseNote{
{Version: "v0.3.0"},
{Version: "v0.2.2"},
{Version: "v0.2.1"},
{Version: "v0.2.0"},
{Version: "v0.1.3"},
}
got := NewerThan(notes, "v0.2.0")
want := []string{"v0.3.0", "v0.2.2", "v0.2.1"}
if len(got) != len(want) {
t.Fatalf("отобрано %d версий, ожидалось %d: %v", len(got), len(want), got)
}
for i, version := range want {
if got[i].Version != version {
t.Errorf("changelog[%d] = %s, ожидалось %s", i, got[i].Version, version)
}
}
// На последней версии показывать нечего.
if got := NewerThan(notes, "v0.3.0"); len(got) != 0 {
t.Errorf("на последней версии отобрано %d записей: %v", len(got), got)
}
// Сборка из рабочей копии не знает своей версии — показываем всё.
if got := NewerThan(notes, "dev"); len(got) != len(notes) {
t.Errorf("для dev отобрано %d из %d записей", len(got), len(notes))
}
}
+210 -10
View File
@@ -94,6 +94,7 @@ function escapeHTML(value) {
const STATE_LABELS = { const STATE_LABELS = {
stopped: "Остановлен", stopped: "Остановлен",
restarting: "Ждёт перезапуска",
starting: "Запускается", starting: "Запускается",
running: "Работает", running: "Работает",
stopping: "Останавливается", stopping: "Останавливается",
@@ -230,8 +231,18 @@ async function refreshStatus() {
renderTask(data.task); renderTask(data.task);
} }
// hostStats нужен карточкам профилей: там подсказываем, сколько памяти можно
// отдать JVM, чтобы не выбирать объём вслепую.
let hostStats = {};
function renderStatus(status) { function renderStatus(status) {
const label = STATE_LABELS[status.state] || status.state; hostStats = status.host || {};
let label = STATE_LABELS[status.state] || status.state;
// Пока идёт обратный отсчёт, показываем, сколько осталось: иначе непонятно,
// происходит ли вообще что-нибудь.
if (status.state === "restarting" && status.restart_in_sec > 0) {
label = `Перезапуск через ${status.restart_in_sec} с`;
}
$("#status-text").textContent = label; $("#status-text").textContent = label;
$("#status-dot").className = `dot ${status.state}`; $("#status-dot").className = `dot ${status.state}`;
@@ -261,20 +272,46 @@ function renderStatus(status) {
? `${formatBytes(host.disk_free_bytes)} из ${formatBytes(host.disk_total_bytes)}` ? `${formatBytes(host.disk_free_bytes)} из ${formatBytes(host.disk_total_bytes)}`
: "—"; : "—";
// Кнопка называет то, что произойдёт: на чистой машине это установка, на
// готовой — обновление.
$("#install-state").textContent = status.installed $("#install-state").textContent = status.installed
? "Серверные файлы установлены." ? "Серверные файлы установлены."
: "Серверные файлы не найдены — установите их перед первым запуском."; : "Серверные файлы не найдены — сервер ещё не установлен.";
$("#btn-install").textContent = status.installed
? "Обновить сервер через SteamCMD"
: "Установить сервер через SteamCMD";
$("#install-hint").textContent = status.installed
? "Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль»."
: "Займёт несколько минут и около 3 ГБ на диске — прогресс виден во вкладке «Консоль».";
const running = status.state !== "stopped"; const running = status.state !== "stopped";
$("#btn-start").disabled = running || !status.installed; const waitingRestart = status.state === "restarting";
// В ожидании автоподъёма обе кнопки осмысленны: «Запустить» поднимает
// сервер сразу, «Остановить» отменяет перезапуск.
$("#btn-start").disabled = (running && !waitingRestart) || !status.installed;
$("#btn-stop").disabled = !running; $("#btn-stop").disabled = !running;
$("#btn-stop").textContent = waitingRestart ? "Отменить перезапуск" : "Остановить";
$("#btn-restart").disabled = !status.installed; $("#btn-restart").disabled = !status.installed;
$("#btn-install").disabled = running; $("#btn-install").disabled = running;
// Консоль есть только у живого процесса: у остановленного сервера нет stdin,
// и команда всё равно вернулась бы ошибкой.
const consoleInput = $("#console-command");
const consoleButton = $("#console-form").querySelector("button[type=submit]");
// Процесс есть только в этих двух состояниях; в ожидании перезапуска писать
// некуда, хотя формально сервер и не «остановлен».
const consoleReady = status.state === "running" || status.state === "starting";
consoleInput.disabled = !consoleReady;
consoleButton.disabled = !consoleReady;
consoleInput.placeholder = consoleReady
? "Команда сервера, например: players, save, quit"
: "Сервер остановлен — консоль принимает команды только на работающем";
// Профили делят игровые порты и файл запуска, поэтому переключать их можно // Профили делят игровые порты и файл запуска, поэтому переключать их можно
// только на остановленном сервере. // только на остановленном сервере.
const picker = $("#profile-select"); const picker = $("#profile-select");
picker.disabled = running; picker.disabled = running && !waitingRestart;
picker.title = running picker.title = running
? "Остановите сервер, чтобы переключить профиль" ? "Остановите сервер, чтобы переключить профиль"
: "Профиль сервера: свой мир, конфиг и моды"; : "Профиль сервера: свой мир, конфиг и моды";
@@ -313,13 +350,20 @@ async function serverAction(path, confirmText) {
} }
$("#btn-start").addEventListener("click", () => serverAction("/api/server/start")); $("#btn-start").addEventListener("click", () => serverAction("/api/server/start"));
$("#btn-stop").addEventListener("click", () => $("#btn-stop").addEventListener("click", () => {
serverAction("/api/server/stop", "Остановить игровой сервер? Игроки будут отключены.")); // Отмена перезапуска ничего не рушит, спрашивать незачем.
const waiting = $("#btn-stop").textContent === "Отменить перезапуск";
serverAction("/api/server/stop", waiting ? "" : "Остановить игровой сервер? Игроки будут отключены.");
});
$("#btn-restart").addEventListener("click", () => $("#btn-restart").addEventListener("click", () =>
serverAction("/api/server/restart", "Перезапустить сервер? Игроки будут отключены.")); serverAction("/api/server/restart", "Перезапустить сервер? Игроки будут отключены."));
$("#btn-install").addEventListener("click", async () => { $("#btn-install").addEventListener("click", async () => {
if (!confirm("Запустить установку/обновление серверных файлов через SteamCMD?")) return; // Тот же вопрос, что и на кнопке: «установить» и «обновить» — разные вещи
// по ощущениям, хотя команда SteamCMD одна.
const installed = $("#install-state").textContent.startsWith("Серверные файлы установлены");
const action = installed ? "Обновить серверные файлы" : "Установить сервер";
if (!confirm(`${action} через SteamCMD?`)) return;
try { try {
await post("/api/install"); await post("/api/install");
ok("Задача запущена — следите за вкладкой «Консоль»"); ok("Задача запущена — следите за вкладкой «Консоль»");
@@ -471,6 +515,7 @@ async function loadServerConfig() {
if (!data.exists) { if (!data.exists) {
$("#config-empty").textContent = data.hint; $("#config-empty").textContent = data.hint;
refreshFieldSaveState(SAVE_TARGETS[0]);
return; return;
} }
serverConfigValues = data.values; serverConfigValues = data.values;
@@ -479,6 +524,7 @@ async function loadServerConfig() {
container.appendChild(buildConfigField(key, data.values[key], CONFIG_HINTS[key])); container.appendChild(buildConfigField(key, data.values[key], CONFIG_HINTS[key]));
}); });
applyFieldFilter("#config-filter", "#config-fields"); applyFieldFilter("#config-filter", "#config-fields");
refreshFieldSaveState(SAVE_TARGETS[0]);
} }
// buildConfigField выбирает тип поля по текущему значению: булевы значения // buildConfigField выбирает тип поля по текущему значению: булевы значения
@@ -539,12 +585,35 @@ function collectChanged(containerSelector) {
return changed; return changed;
} }
// Кнопка «Сохранить» включается, только когда есть что сохранять: на пустой
// вкладке (файл ещё не создан игрой) или без правок нажимать её незачем.
const SAVE_TARGETS = [
{ fields: "#config-fields", button: "#btn-config-save" },
{ fields: "#sandbox-fields", button: "#btn-sandbox-save" },
];
function refreshFieldSaveState(target) {
const count = Object.keys(collectChanged(target.fields)).length;
const button = $(target.button);
button.disabled = count === 0;
button.textContent = count ? `Сохранить (${count})` : "Сохранить";
button.title = count ? `Изменено параметров: ${count}` : "Изменений нет";
}
SAVE_TARGETS.forEach((target) => {
// Слушаем на контейнере: поля пересоздаются при каждой загрузке вкладки.
["input", "change"].forEach((event) =>
$(target.fields).addEventListener(event, () => refreshFieldSaveState(target)));
});
function markSaved(containerSelector) { function markSaved(containerSelector) {
$$(`${containerSelector} .cfg-field`).forEach((field) => { $$(`${containerSelector} .cfg-field`).forEach((field) => {
const input = field.querySelector("input, select"); const input = field.querySelector("input, select");
if (input) input.dataset.original = input.value; if (input) input.dataset.original = input.value;
field.classList.remove("changed"); field.classList.remove("changed");
}); });
const target = SAVE_TARGETS.find((t) => t.fields === containerSelector);
if (target) refreshFieldSaveState(target);
} }
$("#btn-config-save").addEventListener("click", async () => { $("#btn-config-save").addEventListener("click", async () => {
@@ -584,6 +653,7 @@ async function loadSandbox() {
if (!data.exists) { if (!data.exists) {
$("#sandbox-empty").textContent = data.hint; $("#sandbox-empty").textContent = data.hint;
refreshFieldSaveState(SAVE_TARGETS[1]);
return; return;
} }
const container = $("#sandbox-fields"); const container = $("#sandbox-fields");
@@ -591,6 +661,7 @@ async function loadSandbox() {
container.appendChild(buildConfigField(entry.path, entry.value, null)); container.appendChild(buildConfigField(entry.path, entry.value, null));
}); });
applyFieldFilter("#sandbox-filter", "#sandbox-fields"); applyFieldFilter("#sandbox-filter", "#sandbox-fields");
refreshFieldSaveState(SAVE_TARGETS[1]);
} }
$("#btn-sandbox-save").addEventListener("click", async () => { $("#btn-sandbox-save").addEventListener("click", async () => {
@@ -616,6 +687,10 @@ $("#btn-sandbox-save").addEventListener("click", async () => {
// WorkshopItems — что скачать из мастерской, Mods — что включить и в каком // WorkshopItems — что скачать из мастерской, Mods — что включить и в каком
// порядке. Панель показывает их одним списком: строка на мод, галочка = // порядке. Панель показывает их одним списком: строка на мод, галочка =
// присутствие в Mods, порядок строк = порядок в Mods. // присутствие в Mods, порядок строк = порядок в Mods.
// Снимок списков на момент загрузки: по нему видно, есть ли несохранённые
// правки. Пустая строка означает, что конфига ещё нет и сохранять нечего.
let modsSnapshot = "";
let mods = { let mods = {
workshop: [], // WorkshopItems workshop: [], // WorkshopItems
enabled: [], // Mods, порядок важен enabled: [], // Mods, порядок важен
@@ -630,6 +705,8 @@ async function loadMods() {
$("#mods-body").hidden = !data.exists; $("#mods-body").hidden = !data.exists;
if (!data.exists) { if (!data.exists) {
$("#mods-empty").textContent = data.hint; $("#mods-empty").textContent = data.hint;
modsSnapshot = "";
refreshModsSaveState();
return; return;
} }
@@ -641,6 +718,7 @@ async function loadMods() {
details: mods.details, details: mods.details,
}; };
$("#map-list").value = mods.maps.join("\n"); $("#map-list").value = mods.maps.join("\n");
modsSnapshot = modsState();
renderMods(); renderMods();
lookupWorkshopTitles().catch(() => { lookupWorkshopTitles().catch(() => {
/* без интернета останутся идентификаторы — это не ошибка панели */ /* без интернета останутся идентификаторы — это не ошибка панели */
@@ -711,6 +789,23 @@ function buildModRows() {
return rows; return rows;
} }
// modsState сводит списки к строке — так проще всего заметить и переключённую
// галочку, и переставленный порядок загрузки.
function modsState() {
return JSON.stringify({
enabled: mods.enabled,
workshop: mods.workshop,
maps: $("#map-list").value.split("\n").map((line) => line.trim()).filter(Boolean),
});
}
function refreshModsSaveState() {
const button = $("#btn-mods-save");
const changed = modsSnapshot !== "" && modsState() !== modsSnapshot;
button.disabled = !changed;
button.title = changed ? "Есть несохранённые изменения" : "Изменений нет";
}
function renderMods() { function renderMods() {
const filter = $("#mod-filter").value.trim().toLowerCase(); const filter = $("#mod-filter").value.trim().toLowerCase();
const onlyEnabled = $("#mod-only-enabled").checked; const onlyEnabled = $("#mod-only-enabled").checked;
@@ -725,6 +820,8 @@ function renderMods() {
$("#mod-summary").textContent = $("#mod-summary").textContent =
`Модов: ${rows.length}, включено: ${mods.enabled.length}, пакетов мастерской: ${mods.workshop.length}`; `Модов: ${rows.length}, включено: ${mods.enabled.length}, пакетов мастерской: ${mods.workshop.length}`;
refreshModsSaveState();
$("#mod-list").innerHTML = visible $("#mod-list").innerHTML = visible
.map((row) => { .map((row) => {
const on = mods.enabled.includes(row.modID); const on = mods.enabled.includes(row.modID);
@@ -857,6 +954,7 @@ $("#mod-list").addEventListener("drop", (event) => {
renderMods(); renderMods();
}); });
$("#map-list").addEventListener("input", refreshModsSaveState);
$("#mod-filter").addEventListener("input", renderMods); $("#mod-filter").addEventListener("input", renderMods);
$("#mod-only-enabled").addEventListener("change", renderMods); $("#mod-only-enabled").addEventListener("change", renderMods);
@@ -921,6 +1019,8 @@ $("#btn-mods-save").addEventListener("click", async () => {
workshop_items: mods.workshop, workshop_items: mods.workshop,
map: maps, map: maps,
}); });
modsSnapshot = modsState();
refreshModsSaveState();
ok("Список модов сохранён. Перезапустите сервер, чтобы он их подтянул."); ok("Список модов сохранён. Перезапустите сервер, чтобы он их подтянул.");
} catch (error) { } catch (error) {
fail(error); fail(error);
@@ -970,8 +1070,16 @@ function renderProfileCards() {
<input type="text" data-field="title" value="${escapeHTML(p.title || "")}"> <input type="text" data-field="title" value="${escapeHTML(p.title || "")}">
</label> </label>
<label class="field"> <label class="field">
<span>Память JVM</span> <span>Память JVM, максимум</span>
<input type="text" data-field="java_memory" value="${escapeHTML(p.java_memory || "")}"> <input type="text" data-field="java_memory" value="${escapeHTML(p.java_memory || "")}">
<small>${escapeHTML(memoryHint())}</small>
</label>
<label class="field">
<span>Память JVM, начальная</span>
<input type="text" data-field="java_memory_min" value="${escapeHTML(p.java_memory_min || "")}"
placeholder="не задана">
<small>Пусто — JVM берёт память по мере надобности. Если задать, она
займёт этот объём сразу при старте и не сможет подняться, когда его нет.</small>
</label> </label>
<label class="field"> <label class="field">
<span>Пароль админа игры</span> <span>Пароль админа игры</span>
@@ -991,6 +1099,15 @@ function renderProfileCards() {
// renderCopySource предлагает копировать настройки только с тех профилей, у // renderCopySource предлагает копировать настройки только с тех профилей, у
// которых конфиг уже создан игрой. // которых конфиг уже создан игрой.
// memoryHint подсказывает разумный потолок: JVM должна поместиться в свободную
// память, иначе сервер не поднимется вовсе.
function memoryHint() {
if (!hostStats.mem_total_bytes) return "Например 4g";
const total = formatBytes(hostStats.mem_total_bytes);
const free = formatBytes(hostStats.mem_available_bytes);
return `На машине ${total} ОЗУ, свободно ${free}. Оставьте запас системе.`;
}
function renderCopySource() { function renderCopySource() {
$("#new-profile-copy").innerHTML = $("#new-profile-copy").innerHTML =
`<option value="">не копировать</option>` + `<option value="">не копировать</option>` +
@@ -1032,6 +1149,7 @@ $("#profile-cards").addEventListener("click", async (event) => {
await put(`/api/profiles/${encodeURIComponent(id)}`, { await put(`/api/profiles/${encodeURIComponent(id)}`, {
title: field("title"), title: field("title"),
java_memory: field("java_memory"), java_memory: field("java_memory"),
java_memory_min: field("java_memory_min"),
admin_password: field("admin_password"), admin_password: field("admin_password"),
}); });
ok("Профиль сохранён"); ok("Профиль сохранён");
@@ -1184,8 +1302,13 @@ async function loadUpdateInfo() {
} }
const notes = $("#update-notes"); const notes = $("#update-notes");
notes.hidden = !(info.available && info.notes); const changelog = info.changelog || [];
if (!notes.hidden) $("#update-notes-body").textContent = info.notes; notes.hidden = !(info.available && changelog.length);
if (!notes.hidden) {
notes.querySelector("summary").textContent =
changelog.length > 1 ? `Что нового (версий: ${changelog.length})` : "Что нового";
renderChangelog(changelog);
}
$("#btn-manager-restart").disabled = !info.can_apply; $("#btn-manager-restart").disabled = !info.can_apply;
$("#btn-manager-restart").title = info.can_apply $("#btn-manager-restart").title = info.can_apply
@@ -1193,6 +1316,63 @@ async function loadUpdateInfo() {
: "Недоступно: панель не может управлять своей службой"; : "Недоступно: панель не может управлять своей службой";
} }
// Описание релиза приходит из Gitea разметкой Markdown, и показывать её как
// есть неудобно: первым идёт раздел про установку, который в уже работающей
// панели ни к чему. Берём только список изменений.
function releaseItems(text) {
const changes = text.split(/^##\s+Изменения\s*$/m)[1];
return (changes ?? text)
.split("\n")
.map((line) => line.trim())
.filter((line) => line.startsWith("- "))
.map((line) => line.slice(2).trim())
.filter(Boolean);
}
// renderChangelog показывает изменения всех версий между установленной и
// последней: пропустив несколько релизов, иначе не узнать, что было в них.
function renderChangelog(releases) {
const body = $("#update-notes-body");
body.replaceChildren();
releases.forEach((release) => {
const heading = document.createElement("h4");
heading.className = "release-version";
heading.textContent = release.published
? `${release.version}${formatDate(release.published)}`
: release.version;
body.appendChild(heading);
const items = releaseItems(release.notes || "");
if (items.length) {
const list = document.createElement("ul");
items.forEach((item) => {
const li = document.createElement("li");
li.textContent = item;
list.appendChild(li);
});
body.appendChild(list);
return;
}
// Непривычный формат описания — показываем как есть, лишь бы не потерять.
const raw = document.createElement("pre");
raw.textContent = (release.notes || "").trim() || "Описание не заполнено";
body.appendChild(raw);
});
const newest = releases[0];
if (newest && newest.url) {
const link = document.createElement("a");
link.href = newest.url;
link.target = "_blank";
link.rel = "noopener noreferrer";
link.className = "release-link";
link.textContent = "Полное описание релизов";
body.appendChild(link);
}
}
$("#btn-update-check").addEventListener("click", async () => { $("#btn-update-check").addEventListener("click", async () => {
const button = $("#btn-update-check"); const button = $("#btn-update-check");
button.disabled = true; button.disabled = true;
@@ -1212,6 +1392,9 @@ $("#btn-update-apply").addEventListener("click", async () => {
try { try {
await post("/api/update", { version: updateInfo.latest }); await post("/api/update", { version: updateInfo.latest });
waitForRestart("Обновление запущено"); waitForRestart("Обновление запущено");
// Обновление выполняется отдельной службой, и её вывод в консоль панели
// не попадает — панель в это время перезапускается.
toast("Ход обновления: journalctl -u pzmanager-update -f");
} catch (error) { } catch (error) {
fail(error); fail(error);
} }
@@ -1299,6 +1482,7 @@ async function loadSettings() {
} else { } else {
input.value = config[key] ?? ""; input.value = config[key] ?? "";
} }
input.dataset.original = type === "checkbox" ? String(input.checked) : input.value;
wrapper.appendChild(input); wrapper.appendChild(input);
if (hint) { if (hint) {
@@ -1315,6 +1499,7 @@ async function loadSettings() {
pathNote.textContent = `Файл конфигурации: ${config.config_path}`; pathNote.textContent = `Файл конфигурации: ${config.config_path}`;
form.appendChild(pathNote); form.appendChild(pathNote);
refreshSettingsSaveState();
await loadUsers(); await loadUsers();
// Проверка обновления ходит в интернет и может не ответить — она не должна // Проверка обновления ходит в интернет и может не ответить — она не должна
// мешать показу остальных настроек. // мешать показу остальных настроек.
@@ -1323,6 +1508,21 @@ async function loadSettings() {
}); });
} }
function refreshSettingsSaveState() {
const changed = $$("#settings-form input").filter((input) => {
const current = input.type === "checkbox" ? String(input.checked) : input.value;
return current !== input.dataset.original;
}).length;
const button = $("#btn-settings-save");
button.disabled = changed === 0;
button.textContent = changed ? `Сохранить настройки (${changed})` : "Сохранить настройки";
button.title = changed ? `Изменено полей: ${changed}` : "Изменений нет";
}
["input", "change"].forEach((event) =>
$("#settings-form").addEventListener(event, refreshSettingsSaveState));
$("#btn-settings-save").addEventListener("click", async () => { $("#btn-settings-save").addEventListener("click", async () => {
const payload = {}; const payload = {};
SETTINGS_FIELDS.forEach(([key, , type]) => { SETTINGS_FIELDS.forEach(([key, , type]) => {
+9 -9
View File
@@ -114,8 +114,8 @@
<div class="card" id="install-card"> <div class="card" id="install-card">
<h3>Серверные файлы</h3> <h3>Серверные файлы</h3>
<p id="install-state" class="muted"></p> <p id="install-state" class="muted"></p>
<button class="btn btn-primary" id="btn-install">Установить / обновить через SteamCMD</button> <button class="btn btn-primary" id="btn-install">Установить сервер через SteamCMD</button>
<p class="muted small">Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль».</p> <p class="muted small" id="install-hint">Займёт несколько минут и около 3 ГБ на диске — прогресс виден во вкладке «Консоль».</p>
</div> </div>
</section> </section>
@@ -129,8 +129,8 @@
<pre id="console-output" class="console"></pre> <pre id="console-output" class="console"></pre>
<form class="console-input" id="console-form"> <form class="console-input" id="console-form">
<input type="text" id="console-command" placeholder="Команда сервера, например: players, save, quit" <input type="text" id="console-command" placeholder="Команда сервера, например: players, save, quit"
autocomplete="off" spellcheck="false"> autocomplete="off" spellcheck="false" disabled>
<button class="btn btn-primary" type="submit">Отправить</button> <button class="btn btn-primary" type="submit" disabled>Отправить</button>
</form> </form>
<p class="muted small">Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg "текст"</code>, <p class="muted small">Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg "текст"</code>,
<code>kickuser "ник"</code>, <code>banuser "ник"</code>, <code>checkModsNeedUpdate</code>.</p> <code>kickuser "ник"</code>, <code>banuser "ник"</code>, <code>checkModsNeedUpdate</code>.</p>
@@ -145,7 +145,7 @@
</div> </div>
<div> <div>
<input type="search" id="config-filter" placeholder="Поиск параметра…" class="input-sm"> <input type="search" id="config-filter" placeholder="Поиск параметра…" class="input-sm">
<button class="btn btn-primary" id="btn-config-save">Сохранить</button> <button class="btn btn-primary" id="btn-config-save" disabled>Сохранить</button>
</div> </div>
</div> </div>
<p class="muted" id="config-empty" hidden></p> <p class="muted" id="config-empty" hidden></p>
@@ -161,7 +161,7 @@
</div> </div>
<div> <div>
<input type="search" id="sandbox-filter" placeholder="Поиск параметра…" class="input-sm"> <input type="search" id="sandbox-filter" placeholder="Поиск параметра…" class="input-sm">
<button class="btn btn-primary" id="btn-sandbox-save">Сохранить</button> <button class="btn btn-primary" id="btn-sandbox-save" disabled>Сохранить</button>
</div> </div>
</div> </div>
<p class="muted" id="sandbox-empty" hidden></p> <p class="muted" id="sandbox-empty" hidden></p>
@@ -176,7 +176,7 @@
<p class="muted small">Галочка включает мод, перетаскивание задаёт порядок загрузки. <p class="muted small">Галочка включает мод, перетаскивание задаёт порядок загрузки.
Сервер сам скачивает моды из мастерской при запуске.</p> Сервер сам скачивает моды из мастерской при запуске.</p>
</div> </div>
<button class="btn btn-primary" id="btn-mods-save">Сохранить</button> <button class="btn btn-primary" id="btn-mods-save" disabled>Сохранить</button>
</div> </div>
<p class="muted" id="mods-empty" hidden></p> <p class="muted" id="mods-empty" hidden></p>
@@ -284,13 +284,13 @@
<p class="muted small" id="update-manual" hidden></p> <p class="muted small" id="update-manual" hidden></p>
<details id="update-notes" hidden> <details id="update-notes" hidden>
<summary>Что нового</summary> <summary>Что нового</summary>
<pre class="release-notes" id="update-notes-body"></pre> <div class="release-notes" id="update-notes-body"></div>
</details> </details>
</div> </div>
<h2>Настройки менеджера</h2> <h2>Настройки менеджера</h2>
<form id="settings-form" class="fields"></form> <form id="settings-form" class="fields"></form>
<button class="btn btn-primary" id="btn-settings-save">Сохранить настройки</button> <button class="btn btn-primary" id="btn-settings-save" disabled>Сохранить настройки</button>
<h2>Пользователи панели</h2> <h2>Пользователи панели</h2>
<ul class="user-list" id="user-list"></ul> <ul class="user-list" id="user-list"></ul>
+32 -7
View File
@@ -108,7 +108,7 @@ code {
background: var(--muted); background: var(--muted);
} }
.dot.running { background: var(--accent); box-shadow: 0 0 8px var(--accent); } .dot.running { background: var(--accent); box-shadow: 0 0 8px var(--accent); }
.dot.starting, .dot.stopping { background: var(--warn); animation: pulse 1.2s infinite; } .dot.starting, .dot.stopping, .dot.restarting { background: var(--warn); animation: pulse 1.2s infinite; }
.dot.stopped { background: #5b636f; } .dot.stopped { background: #5b636f; }
@keyframes pulse { 50% { opacity: .35; } } @keyframes pulse { 50% { opacity: .35; } }
@@ -465,16 +465,41 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
.release-notes { .release-notes {
margin: 10px 0 0; margin: 10px 0 0;
padding: 12px; padding: 12px 14px;
background: var(--bg); background: var(--bg);
border: 1px solid var(--border); border: 1px solid var(--border);
border-radius: 8px; border-radius: 8px;
max-height: 260px; max-height: 240px;
overflow: auto; /* Прокручивается сам блок, а не страница под ним. */
white-space: pre-wrap; overflow-y: auto;
word-break: break-word; overscroll-behavior: contain;
font-size: 12.5px; font-size: 13px;
line-height: 1.5; line-height: 1.5;
} }
.release-version {
margin: 14px 0 6px;
font-size: 13px;
color: var(--accent);
text-transform: none;
letter-spacing: 0;
}
.release-version:first-child { margin-top: 0; }
.release-notes ul { margin: 0; padding-left: 20px; }
.release-notes li { margin-bottom: 5px; }
.release-notes li:last-child { margin-bottom: 0; }
.release-notes pre {
margin: 0;
white-space: pre-wrap;
word-break: break-word;
font-size: 12.5px;
}
.release-link { display: inline-block; margin-top: 10px; color: var(--info); }
/* Команду для терминала удобнее читать моноширинным. */
#update-manual { font-family: var(--mono); word-break: break-all; }
.update-available { color: var(--accent); } .update-available { color: var(--accent); }