17 Commits
Author SHA1 Message Date
mrleo1nidandClaude Opus 5 aec932f68f Импорт пресетов сборок из ZIP-пакета
Release / release (push) Successful in 30s
CI / test (push) Successful in 23s
Крупные сборки раздают готовый комплект настроек архивом. Панель разбирает
его сама: находит серверный .ini, песочницу и точки появления, показывает,
что нашла (сколько модов, карт, параметров), и только по подтверждению
раскладывает файлы в новый или существующий профиль.

Порты, пароли и название сервера при этом можно оставить свои — они относятся
к машине, а не к сборке; у нового профиля они берутся из активного. Прежние
конфиги остаются рядом как .bak, мир не трогается, а импорт в работающий
профиль отклоняется: PZ перезаписал бы файлы своими при остановке.

Посторонние .ini из архива (настройки модов) за конфиг сервера не
принимаются: он опознаётся по знакомым параметрам.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 17:18:44 +03:00
mrleo1nidandClaude Opus 5 1e659678b9 «Работает» — только после строки о готовности сервера
CI / test (push) Successful in 23s
Release / release (push) Successful in 30s
Регистрацию в Steam сервер печатает задолго до того, как мир загружен, и по
ней панель показывала «Работает» на сервере, который ещё никого не пустит.
Теперь готовность распознаётся только по «*** SERVER STARTED ****», а пока
идёт загрузка, состояние остаётся «Запускается» с пояснением под ним и
счётчиком времени загрузки.

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 14:15:54 +03:00
mrleo1nidandClaude Opus 5 9a224bc070 Русский и английский языки интерфейса
CI / test (push) Successful in 22s
Release / release (push) Successful in 29s
Язык выбирается в шапке панели, а до первого выбора берётся из настроек
браузера. Переведены интерфейс, подписи и описания всех параметров конфигов,
ошибки API и служебные сообщения менеджера в консоли.

Подписи параметров вынесены из app.js в hints-<язык>.json: их больше четырёхсот
на язык, и грузить чужой язык незачем. Сообщения менеджера переводятся на
выходе из API по словарю, где ключом служит русская фраза из кода, — вывод
самого игрового сервера через него проходит без изменений.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 21:14:21 +03:00
mrleo1nidandClaude Opus 5 d5a308ac8d Описания параметров песочницы на русском
CI / test (push) Successful in 23s
Release / release (push) Successful in 28s
Подписи были переведены, а пояснения по-прежнему приходили из файла — то
есть на языке сервера, обычно английском. Теперь у всех 270 параметров
песочницы есть своё русское описание: что параметр делает и на что влияет.

Текст из конфига не выбрасывается, а дополняет своё: игра расписывает там,
что означает каждое значение («1 = Бегают, 2 = Ходят…»), и это видно во
всплывающей подсказке. Под полем остаётся короткое объяснение смысла.

Вместе с прошлым заходом по servertest.ini панель теперь описывает все 414
параметров обоих конфигов независимо от локали сервера.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 19:28:20 +03:00
mrleo1nidandClaude Opus 5 bb2facd4d1 Русские подписи для всех параметров песочницы
CI / test (push) Successful in 21s
Release / release (push) Successful in 28s
Прошлый заход покрыл ходовые настройки, а вложенные таблицы остались с
английскими именами ключей вместо подписей — «MultiplierConfig.Lightfoot»
мало кому что говорит.

Теперь подписаны все 270 параметров: характеристики и повадки зомби,
популяция и респавн, множители опыта каждого навыка, карта, подвалы и
новая система лута Build 42. Названия самих таблиц тоже переведены —
раздел называется «Множители опыта навыков», а не «MultiplierConfig».

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 16:58:49 +03:00
mrleo1nidandClaude Opus 5 c706665196 Описания параметров на русском независимо от локали сервера
CI / test (push) Failing after 7s
Release / release (push) Successful in 29s
Панель показывала комментарии из самого конфига, а игра пишет их на языке
сервера: на Windows-клиенте они русские, на Linux-сервере почти всегда
английские — и вся вкладка оказывалась на английском.

Теперь у панели свой словарь: подпись и описание для всех 153 параметров
servertest.ini, встречающихся в Build 41 и 42, плюс подписи для 182
параметров песочницы. Комментарий из файла остаётся запасным вариантом для
ключей, которых словарь не знает, — в новых версиях игры их добавляют.

Песочница заодно научилась отдавать свои комментарии: игра расписывает там
смысл каждого значения, и даже английский текст лучше пустоты.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 16:03:09 +03:00
mrleo1nidandClaude Opus 5 5d50b609f6 Настройки сервера и песочницы разложены по разделам
CI / test (push) Successful in 21s
Release / release (push) Successful in 26s
Полторы сотни параметров сплошным списком читать невозможно. Теперь они
разбиты на разделы — «Основное», «PVP и урон», «Убежища», «Античит» и так
далее, — свёрнутые по умолчанию, кроме первого. Поиск раскрывает разделы с
совпадениями и прячет остальные, а раскрытые разделы не схлопываются при
возврате на вкладку.

Категории составлены по настоящим конфигам Build 41 и 42: все 144 ключа
.ini и 270 параметров песочницы раскладываются без остатка. Нумерованные
и однотипные ключи (AntiCheatProtectionType1..24, *Loot, Animal*, Firearm*)
подхватываются по префиксу, а незнакомые попадают в «Прочее» — в новых
версиях игры ключи добавляют, и терять их со страницы нельзя.

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

Заодно исправлено сохранение файлов с виндовыми переводами строк: панель
переписывала их в LF, и правка одного параметра меняла каждую строку
файла. Проверено на реальном SandboxVars.lua: правка одного значения
меняет ровно одну строку, размер файла не меняется.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 03:07:59 +03:00
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
mrleo1nidandClaude Opus 5 e25294db16 Код настройки печатает установщик, появилось удаление панели
CI / test (push) Successful in 21s
Release / release (push) Successful in 29s
Менеджер кладёт код первичной настройки в data/setup-token, установщик
дожидается файла и печатает код последним сообщением — за ним больше не
нужно идти в journalctl. Файл удаляется, как только создан администратор,
и не появляется на уже настроенной панели.

Установщик научился снимать панель с машины: --uninstall убирает службу,
бинарники и правило sudo, --purge вдобавок сносит каталог с мирами,
бэкапами и учётками. Данные удаляются только по явному подтверждению, а
каталог сносится, лишь если похож на установку панели: опечатка в PZ_HOME
не должна стоить чужих файлов. Копия установщика теперь лежит в
/opt/pzmanager, так что удалять можно без похода в репозиторий.

get.sh пробрасывает аргументы установщику и в режиме удаления не качает
бинарник. Заодно исправлена подстановка пустого массива аргументов:
"${ARGS[@]:-}" разворачивается в один пустой аргумент, из-за чего обычная
установка спотыкалась бы о него.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 20:03:13 +03:00
mrleo1nidandClaude Opus 5 a8d86e0c48 Бейдж последнего релиза в README
CI / test (push) Successful in 20s
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 19:42:36 +03:00
39 changed files with 8186 additions and 528 deletions
+150 -18
View File
@@ -1,5 +1,6 @@
# PZ Manager
[![release](https://img.shields.io/gitea/v/release/mrleo1nid/pzmanager?gitea_url=https%3A%2F%2Fgitea.hsrv.site&logo=gitea&logoColor=white&label=релиз)](https://gitea.hsrv.site/mrleo1nid/pzmanager/releases/latest)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Go](https://img.shields.io/badge/Go-1.24%2B-00ADD8?logo=go&logoColor=white)](https://go.dev/)
[![Platform](https://img.shields.io/badge/platform-Linux%20%2F%20Ubuntu-EEEEEE?logo=ubuntu&logoColor=white&labelColor=555555)](https://ubuntu.com/)
@@ -15,18 +16,26 @@
песочница, моды и лимит памяти) с переключением одной кнопкой.
- **Управление сервером** — запуск, остановка (через команду `quit`, мир
сохраняется), перезапуск, автоподъём после падения, автозапуск вместе с
менеджером.
менеджером. «Работает» панель показывает не раньше, чем сервер напечатает
`*** SERVER STARTED ****`: пока идёт загрузка мира, состояние остаётся
«Запускается».
- **Живая консоль** — вывод сервера в реальном времени и отправка любых команд
(`players`, `save`, `servermsg`, `kickuser`, …).
- **Мониторинг** — состояние, аптайм, CPU и память процесса сервера, свободные
ОЗУ и диск на хосте, список игроков онлайн.
- **Редактор конфигов** — `servertest.ini` и `SandboxVars.lua` прямо в
браузере, с поиском по параметрам и сохранением комментариев в файле.
браузере: параметры разложены по разделам, у каждого видно описание из
самого конфига, поиск идёт и по названию, и по описанию.
- **Мод-менеджер** — моды списком с галочками и перетаскиванием порядка
загрузки, добавление по ссылке и разворачивание коллекций Steam целиком.
- **Импорт пресетов сборок** — ZIP-пакет сборки загружается прямо в панель:
конфиг, песочница и точки появления попадают в новый или существующий
профиль, свои порты и пароли при этом сохраняются.
- **Бэкапы** — ручные и по расписанию, отдельно по каждому профилю, с
ротацией, скачиванием и восстановлением (перед восстановлением
автоматически снимается страховочная копия).
- **Два языка** — русский и английский, с выбором в шапке и автоопределением
по языку браузера.
- **Установка и обновление** сервера через SteamCMD прямо из панели.
- **Обновление самой панели** — кнопкой из интерфейса или одной командой в
терминале.
@@ -84,28 +93,31 @@ curl -fsSL https://gitea.hsrv.site/mrleo1nid/pzmanager/raw/branch/main/deploy/ge
```
**Обновление** — та же команда или кнопка в панели (вкладка «Настройки» →
«Версия панели»). Конфиг, миры и учётные записи не трогаются, меняется только
бинарник.
«Версия панели»). Конфиг, миры и учётные записи не трогаются. Повторный запуск
с той же версией службу не трогает вовсе: если бинарник не изменился,
установщик не станет ради него ронять игровой сервер.
Дальше:
1. Посмотрите код первичной настройки:
```bash
journalctl -u pzmanager -n 30 --no-pager
```
2. Откройте панель в браузере и создайте администратора, введя этот код.
Если панель слушает localhost, пробросьте порт:
1. Откройте панель в браузере и создайте администратора, введя код первичной
настройки — установщик печатает его последним сообщением. Если панель
слушает localhost, пробросьте порт:
```bash
ssh -L 8080:127.0.0.1:8080 пользователь@сервер
```
3. Во вкладке «Обзор» нажмите **Установить / обновить через SteamCMD** и
Код одноразовый и перестаёт работать сразу после создания администратора.
Если вывод установщика потерялся, код есть в журнале:
```bash
journalctl -u pzmanager -n 30 --no-pager
```
2. Во вкладке «Обзор» нажмите **Установить / обновить через SteamCMD** и
дождитесь окончания — прогресс виден во вкладке «Консоль».
4. Запустите сервер. При первом запуске PZ создаст `Zomboid/Server/*.ini` —
3. Запустите сервер. При первом запуске PZ создаст `Zomboid/Server/*.ini` —
после этого станут доступны вкладки «Конфиг сервера», «Песочница» и «Моды».
Порты, которые нужно открыть:
@@ -131,6 +143,78 @@ make build-linux
sudo PZ_LISTEN=10.10.1.142:8080 ./deploy/install.sh
```
### Удаление
Убрать панель, оставив миры и настройки:
```bash
sudo /opt/pzmanager/install.sh --uninstall
```
Удалить всё вместе с мирами, бэкапами и учётными записями:
```bash
sudo /opt/pzmanager/install.sh --uninstall --purge
```
`--purge` спрашивает подтверждение; в неинтерактивном запуске нужен ещё и
`--yes`. Каталог сносится, только если похож на установку панели — иначе
опечатка в `PZ_HOME` стоила бы чужих файлов.
Установщик кладёт свою копию в `/opt/pzmanager/install.sh`, так что для
удаления ничего скачивать не нужно. Если копии нет, те же аргументы принимает
и установочная команда:
```bash
curl -fsSL https://gitea.hsrv.site/mrleo1nid/pzmanager/raw/branch/main/deploy/get.sh | sudo bash -s -- --uninstall --purge
```
## Язык интерфейса
Панель говорит по-русски и по-английски. Язык выбирается списком в шапке (и на
экране входа, до того как вошли), а до первого выбора берётся из настроек
браузера: русский — русским, всем остальным — английский. Выбор запоминается в
браузере, поэтому у каждого, кто заходит в панель, он свой.
Переводится всё, что показывает панель: интерфейс, подписи и описания всех
параметров `servertest.ini` и `SandboxVars.lua`, ошибки и служебные сообщения
менеджера в консоли. Вывод самого игрового сервера остаётся как есть — он
приходит от Project Zomboid.
## Импорт пресетов сборок
Крупные сборки модов раздают готовый комплект настроек архивом: внутри лежат
папка `Server` с `<имя>.ini`, `<имя>_SandboxVars.lua` и
`<имя>_spawnregions.lua`, а рядом — файлы для одиночной игры, которые серверу
не нужны.
На вкладке «Профили» есть «Импорт пресета сборки»: выберите ZIP, и панель
покажет, что в нём нашла — название сервера, сколько модов и пакетов
мастерской, какие карты, сколько параметров конфига и песочницы. Ничего не
записывается, пока вы не нажмёте «Импортировать».
Импортировать можно в новый профиль (идентификатор предлагается по имени
файлов из архива) или поверх существующего. Прежние конфиги остаются рядом с
расширением `.bak`, мир не трогается. Профиль, который сейчас работает,
импорт не принимает — сначала остановите сервер, иначе PZ перезапишет файлы
своими при выходе.
Галочки «Оставить свои значения» переносят в импортированный конфиг то, что
относится к вашей машине, а не к сборке:
| группа | параметры |
| --- | --- |
| Порты и RCON | `DefaultPort`, `UDPPort`, `RCONPort`, `RCONPassword` |
| Пароль сервера и объявляемый IP | `Password`, `server_browser_announced_ip` |
| Имя и описание сервера | `PublicName`, `PublicDescription` |
Для нового профиля эти значения берутся из активного: порты и пароли на
машине общие. Всё остальное — списки модов, карты, правила и песочница —
приходит из пресета.
Посторонние `.ini` из архива (настройки модов, например) не принимаются за
конфиг сервера: панель опознаёт его по знакомым параметрам.
## Моды
Project Zomboid хранит моды в двух строках конфига: `WorkshopItems` — что
@@ -162,6 +246,23 @@ Mod ID, который нужен серверу, лежит внутри сам
Один пакет мастерской может содержать несколько модов — в списке они идут
отдельными строками, и включать их можно по отдельности.
## Редактор конфигов
Вкладки «Конфиг сервера» и «Песочница» показывают параметры не сплошным
списком, а разделами: «Основное», «PVP и урон», «Убежища», «Античит» и так
далее. Разделы сворачиваются, а поиск сверху раскрывает те, где нашлось
совпадение. Ключи, которых панель не знает (в новой версии игры их всегда
добавляют), не теряются — они собираются в раздел «Прочее».
Подписи и описания у панели свои, на языке интерфейса: игра пишет свои
комментарии на языке сервера, а на Linux он почти всегда английский. Расшифровку
конкретных значений (что означает 1, 2, 3) панель добавляет из самого конфига.
Полный текст виден при наведении, начало — прямо под полем.
Правка меняет ровно ту строку, которую поправили: комментарии, порядок и
переводы строк файла сохраняются, а рядом остаётся копия прежней версии с
расширением `.bak`.
## Профили серверов
Профиль — это отдельный сервер: свой мир, свой `*.ini`, свои настройки
@@ -183,6 +284,20 @@ Mod ID, который нужен серверу, лежит внутри сам
При создании профиля можно скопировать `.ini` и настройки песочницы из
существующего: удобно, когда нужен тот же набор правил, но чистый мир.
### Память JVM
`java_memory` — это `-Xmx`, верхняя граница кучи. `java_memory_min` (`-Xms`)
по умолчанию пуст, и это осознанно: равные значения избавляют от роста кучи на
ходу, но заставляют JVM занять весь объём сразу при старте. На машине, где
столько свободной памяти не набирается, сервер тогда не поднимется вовсе —
`Failed to allocate initial Java heap`. Задавайте минимум, только если памяти
заведомо хватает.
Сервер, упавший сразу после запуска три раза подряд, панель перестаёт
поднимать автоматически: обычно так проявляется нехватка памяти или битый
конфиг, и перезапуск делу не помогает. Пока идёт отсчёт до автоподъёма, его
можно отменить кнопкой «Отменить перезапуск».
Удаление профиля убирает его только из панели — мир и конфиги остаются на
диске. Чтобы вернуть профиль, создайте его с тем же идентификатором.
@@ -206,9 +321,19 @@ Mod ID, который нужен серверу, лежит внутри сам
pzserver ALL=(root) NOPASSWD: /usr/local/bin/pzmanager-admin
```
Скрипт качает бинарник нужной архитектуры, сверяет sha256 с `checksums.txt`
релиза, подменяет файл и перезапускает службу. Панель к этим файлам доступа не
имеет — она может только попросить выполнить `update` или `restart`.
Скрипт не повторяет логику установки, а забирает из релиза `get.sh` (сверив
его sha256) и отдаёт работу ему — поэтому кнопка обновляет всё сразу: бинарник,
скрипты установки и systemd-юнит. Панель к этим файлам доступа не имеет, она
может только попросить выполнить `update` или `restart`.
Работа уходит в отдельный разовый юнит (`systemd-run --unit=pzmanager-update`).
Иначе обновление не пережило бы само себя: панель вызывает скрипт через sudo,
тот живёт в cgroup её юнита, и остановка службы убила бы его на середине.
Побочный эффект — вывод идёт не в консоль панели, а в свой журнал:
```bash
journalctl -u pzmanager-update -f
```
Если правило sudo не установлено (панель поставлена вручную или в системе нет
`sudo`), кнопка не появится, а рядом будет показана команда для терминала:
@@ -287,7 +412,8 @@ profiles: # серверы: у каждого свой м
- id: vanilla # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla
title: Ванильный мир # как профиль подписан в панели
admin_password: "" # пароль админа игрового сервера
java_memory: 4g # -Xmx для JVM этого профиля
java_memory: 4g # -Xmx: верхняя граница кучи JVM
java_memory_min: "" # -Xms: пусто — JVM берёт память по мере надобности
extra_args: [] # доп. аргументы start-server.sh
- id: modded
title: Сборка с модами
@@ -373,6 +499,12 @@ make run # локальный запуск с конфигом в ./dev
Веб-интерфейс — обычные HTML, CSS и JS в `web/static`, без сборщика; при
`go build` они вшиваются в бинарник через `embed`.
Переводы лежат рядом: строки интерфейса — в `web/static/i18n.js`, подписи
параметров конфигов — в `web/static/hints-ru.json` и `hints-en.json`
(загружается только нужный язык), сообщения самого менеджера — в
`internal/i18n/catalog.go`, где ключом служит русская фраза из кода. Тесты в
`web` и `internal/i18n` следят, чтобы словари не разъезжались.
## Лицензия
[MIT](LICENSE) — делайте с кодом что угодно, но без каких-либо гарантий.
+21 -11
View File
@@ -131,24 +131,34 @@ func serve(cfg *config.Config, users *auth.Store, secureCookies bool) error {
// Пока учёток нет, создать первого администратора можно только с этим
// кодом — иначе панель захватит любой, кто откроет её первым.
setupToken := ""
setupTokenFile := filepath.Join(cfg.DataDir, "setup-token")
if users.IsEmpty() {
setupToken = randomToken()
// Код кладём и в файл: установщик читает его оттуда и показывает сразу
// после установки, не заставляя идти в журнал.
if err := os.WriteFile(setupTokenFile, []byte(setupToken+"\n"), 0o600); err != nil {
fmt.Fprintf(os.Stderr, "не удалось записать %s: %v\n", setupTokenFile, err)
}
fmt.Printf("\n Панель ещё не настроена.\n"+
" Откройте её в браузере и введите код первичной настройки:\n\n %s\n\n", setupToken)
} else {
// Панель уже настроена: файл мог остаться от прошлой установки.
os.Remove(setupTokenFile)
}
apiServer := api.New(api.Options{
Version: version,
Config: cfg,
Users: users,
Supervisor: supervisor,
Jobs: jobs,
Backups: backups,
Steam: steam,
Static: static,
SecureCookies: secureCookies,
SetupToken: setupToken,
Repo: repoURL(),
Version: version,
Config: cfg,
Users: users,
Supervisor: supervisor,
Jobs: jobs,
Backups: backups,
Steam: steam,
Static: static,
SecureCookies: secureCookies,
SetupToken: setupToken,
SetupTokenFile: setupTokenFile,
Repo: repoURL(),
})
ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+41 -9
View File
@@ -7,6 +7,15 @@
#
# curl -fsSL .../get.sh | sudo PZ_LISTEN=10.10.1.142:8080 bash
#
# Удаление (аргументы уходят установщику как есть):
#
# curl -fsSL .../get.sh | sudo bash -s -- --uninstall
# curl -fsSL .../get.sh | sudo bash -s -- --uninstall --purge
#
# Если панель уже установлена, то же самое умеет её локальная копия:
#
# sudo /opt/pzmanager/install.sh --uninstall --purge
#
# Переменные окружения:
# PZ_VERSION какой тег ставить (по умолчанию последний релиз)
# PZ_HOME куда ставить (по умолчанию /opt/pzmanager)
@@ -29,6 +38,19 @@ die() { echo "Ошибка: $*" >&2; exit 1; }
[[ $EUID -eq 0 ]] || die "запустите с правами root (sudo)"
# Аргументы уходят установщику. Для удаления бинарник качать незачем — это
# лишние восемь мегабайт ради скрипта, который его же и сотрёт.
ARGS=("$@")
NEED_BINARY=1
# Идиома ${ARGS[@]+...} нужна из-за set -u: обычная "${ARGS[@]:-}" на пустом
# массиве разворачивается в один пустой аргумент, и установщик спотыкается о
# него при обычной установке.
for arg in ${ARGS[@]+"${ARGS[@]}"}; do
case "$arg" in
--uninstall | --remove | --purge) NEED_BINARY=0 ;;
esac
done
for tool in curl sha256sum; do
command -v "$tool" >/dev/null 2>&1 || die "не найдена утилита $tool"
done
@@ -68,10 +90,13 @@ asset_url() {
}
BIN_NAME="pzmanager-linux-${ARCH}"
BIN_URL="$(asset_url "$BIN_NAME")"
[[ -n "$BIN_URL" ]] || die "в релизе ${TAG} нет файла ${BIN_NAME}"
echo "==> Ставлю ${TAG} (${ARCH})"
if [[ "$NEED_BINARY" == "1" ]]; then
BIN_URL="$(asset_url "$BIN_NAME")"
[[ -n "$BIN_URL" ]] || die "в релизе ${TAG} нет файла ${BIN_NAME}"
echo "==> Ставлю ${TAG} (${ARCH})"
else
echo "==> Беру установщик из ${TAG} для удаления"
fi
TMP="$(mktemp -d)"
trap 'rm -rf "$TMP"' EXIT
@@ -91,13 +116,17 @@ download() {
curl -fsSL -o "$name" "$url" || die "не удалось скачать ${name}"
}
download "$BIN_NAME"
download install.sh
download pzmanager.service
FILES=(install.sh pzmanager.service)
if [[ "$NEED_BINARY" == "1" ]]; then
download "$BIN_NAME"
FILES+=("$BIN_NAME")
fi
# Скрипт привилегированных действий появился не сразу: со старым релизом
# ставим без него, панель просто не покажет кнопку обновления.
FILES=("$BIN_NAME" install.sh pzmanager.service)
if download pzmanager-admin.sh optional; then
FILES+=(pzmanager-admin.sh)
fi
@@ -120,8 +149,11 @@ mv install.sh pzmanager.service deploy/
if [[ -f pzmanager-admin.sh ]]; then
mv pzmanager-admin.sh deploy/
fi
mv "$BIN_NAME" pzmanager
chmod +x pzmanager deploy/install.sh
chmod +x deploy/install.sh
if [[ "$NEED_BINARY" == "1" ]]; then
mv "$BIN_NAME" pzmanager
chmod +x pzmanager
fi
echo "==> Запускаю установщик"
BINARY="$TMP/pzmanager" bash deploy/install.sh
BINARY="$TMP/pzmanager" bash deploy/install.sh ${ARGS[@]+"${ARGS[@]}"}
+181 -14
View File
@@ -1,10 +1,12 @@
#!/usr/bin/env bash
# Установка и обновление pzmanager на Ubuntu/Debian. Запускать от root:
# Установка, обновление и удаление pzmanager на Ubuntu/Debian. От root:
#
# sudo ./deploy/install.sh
# sudo ./deploy/install.sh установить или обновить
# sudo ./deploy/install.sh --uninstall убрать панель, данные оставить
# sudo ./deploy/install.sh --uninstall --purge убрать вместе с мирами
#
# Скрипт идемпотентен: на уже настроенной машине он обновляет бинарник и
# юнит, не трогая конфиг, миры и учётные записи панели.
# Установка идемпотентна: на уже настроенной машине обновляются бинарник и
# юнит, а конфиг, миры и учётные записи панели остаются нетронутыми.
#
# Переменные окружения:
# PZ_HOME куда ставить всё хозяйство (по умолчанию /opt/pzmanager)
@@ -29,11 +31,96 @@ ADMIN_SRC="${SCRIPT_DIR}/pzmanager-admin.sh"
TARGET_BINARY=/usr/local/bin/pzmanager
ADMIN_BINARY=/usr/local/bin/pzmanager-admin
UNINSTALL=0
PURGE=0
for arg in "$@"; do
case "$arg" in
--uninstall | --remove) UNINSTALL=1 ;;
--purge) UNINSTALL=1; PURGE=1 ;;
--yes | -y) PZ_ASSUME_YES=1 ;;
-h | --help)
# Справка — это шапка файла: печатаем комментарии со второй строки и
# останавливаемся, как только они кончились.
awk 'NR > 1 && /^#/ { sub(/^# ?/, ""); print; next } NR > 1 { exit }' "$0"
exit 0
;;
*)
echo "Неизвестный аргумент: $arg" >&2
exit 2
;;
esac
done
if [[ $EUID -ne 0 ]]; then
echo "Запустите скрипт от root: sudo $0" >&2
exit 1
fi
# uninstall снимает панель с машины. Данные (миры, бэкапы, учётки) удаляются
# только по --purge: потерять сохранения из-за неудачно набранной команды
# гораздо обиднее, чем лишний раз убрать каталог руками.
uninstall() {
echo "==> Удаляю pzmanager"
if systemctl list-unit-files pzmanager.service &>/dev/null &&
systemctl is-active --quiet pzmanager; then
echo "==> Останавливаю службу (игровой сервер завершится штатно, это небыстро)"
systemctl stop pzmanager || true
fi
systemctl disable --quiet pzmanager 2>/dev/null || true
rm -f /etc/systemd/system/pzmanager.service
systemctl daemon-reload
systemctl reset-failed pzmanager 2>/dev/null || true
rm -f /usr/local/bin/pzmanager /usr/local/bin/pzmanager-admin /etc/sudoers.d/pzmanager
echo "Служба, бинарники и правило sudo удалены."
if [[ "$PURGE" != "1" ]]; then
echo
echo "Данные остались в ${PZ_HOME} (миры, бэкапы, конфиг, учётные записи)."
echo "Удалить и их: sudo $0 --uninstall --purge"
return
fi
# Защита от опечатки в PZ_HOME: сносим только то, что похоже на нашу
# установку, и никогда — корень или домашние каталоги.
local home_clean="${PZ_HOME%/}"
if [[ -z "$home_clean" || "$home_clean" == "/" || "$home_clean" != /* ]]; then
echo "!! PZ_HOME=${PZ_HOME} не похож на каталог установки — не трогаю" >&2
return
fi
if [[ ! -e "$home_clean/config.yaml" && ! -d "$home_clean/data" ]]; then
echo "!! В ${home_clean} нет ни config.yaml, ни data/ — не похоже на установку pzmanager," >&2
echo " поэтому каталог оставлен нетронутым." >&2
return
fi
if [[ "${PZ_ASSUME_YES:-0}" != "1" ]]; then
echo
echo "Будет безвозвратно удалено: ${home_clean}"
echo "Это миры, бэкапы, конфиг и учётные записи панели."
if [[ -t 0 ]]; then
read -r -p "Введите YES для подтверждения: " answer
[[ "$answer" == "YES" ]] || { echo "Отменено."; return; }
else
echo "Запуск неинтерактивный — повторите с флагом --yes, если уверены." >&2
return
fi
fi
rm -rf "$home_clean"
if id "$PZ_USER" &>/dev/null; then
deluser --system "$PZ_USER" &>/dev/null || userdel "$PZ_USER" &>/dev/null || true
echo "Пользователь ${PZ_USER} удалён."
fi
echo "Удалено полностью: ${home_clean}"
}
if [[ "$UNINSTALL" == "1" ]]; then
uninstall
exit 0
fi
if [[ ! -f "$BINARY" ]]; then
echo "Не найден бинарник $BINARY. Соберите его: make build-linux" >&2
exit 1
@@ -118,17 +205,29 @@ EOF
chmod 0640 "$CONFIG"
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
if [[ "$MODE" == "update" ]] && systemctl is-active --quiet pzmanager; then
if [[ "$MODE" == "update" && "$SAME_BINARY" == "0" ]] && systemctl is-active --quiet pzmanager; then
echo "==> Останавливаю pzmanager (игровой сервер завершится штатно)"
systemctl stop pzmanager
RESTART_AFTER=1
fi
echo "==> Копирую бинарник в $TARGET_BINARY"
install -m 0755 "$BINARY" "$TARGET_BINARY"
if [[ "$SAME_BINARY" == "0" ]]; then
echo "==> Копирую бинарник в $TARGET_BINARY"
install -m 0755 "$BINARY" "$TARGET_BINARY"
fi
# Панель работает от непривилегированного пользователя и не может ни заменить
# бинарник, ни дёрнуть systemctl. Даём ей ровно одну команду через sudo.
@@ -136,6 +235,8 @@ if [[ -f "$ADMIN_SRC" ]] && command -v sudo >/dev/null 2>&1; then
echo "==> Ставлю $ADMIN_BINARY и правило sudo"
sed -e "s|@PZ_REPO@|${PZ_REPO}|" \
-e "s|@PZ_BINARY@|${TARGET_BINARY}|" \
-e "s|@PZ_HOME@|${PZ_HOME}|" \
-e "s|@PZ_USER@|${PZ_USER}|" \
"$ADMIN_SRC" > "$ADMIN_BINARY"
chown root:root "$ADMIN_BINARY"
chmod 0755 "$ADMIN_BINARY"
@@ -152,6 +253,14 @@ else
echo "!! $ADMIN_SRC не найден или нет sudo — обновление из панели будет недоступно" >&2
fi
# Кладём сам установщик рядом с данными: удалить или переустановить панель
# можно будет одной локальной командой, без похода в репозиторий.
install -m 0755 "$0" "$PZ_HOME/install.sh"
if [[ -f "$ADMIN_SRC" ]]; then
install -m 0755 "$ADMIN_SRC" "$PZ_HOME/pzmanager-admin.sh"
fi
install -m 0644 "$UNIT_SRC" "$PZ_HOME/pzmanager.service"
echo "==> Ставлю systemd-юнит"
sed -e "s|/opt/pzmanager|${PZ_HOME}|g" \
-e "s|User=pzserver|User=${PZ_USER}|" \
@@ -161,10 +270,25 @@ sed -e "s|/opt/pzmanager|${PZ_HOME}|g" \
systemctl daemon-reload
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 [[ "$RESTART_AFTER" == "1" ]]; then
echo "==> Запускаю pzmanager"
systemctl start pzmanager
fi
echo
if [[ "$OLD_VERSION" == "$NEW_VERSION" ]]; then
echo "Переустановлена версия ${NEW_VERSION}."
@@ -172,17 +296,50 @@ if [[ "$MODE" == "update" ]]; then
echo "Обновлено: ${OLD_VERSION} -> ${NEW_VERSION}."
fi
echo "Конфиг, миры и учётные записи не тронуты."
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
fi
systemctl start pzmanager
# Дадим сервису секунду подняться, чтобы код настройки успел попасть в журнал.
sleep 2
# Панель кладёт код первичной настройки в файл, как только поднимется. Ждём
# его, чтобы показать код прямо здесь: иначе за ним пришлось бы идти в журнал.
SETUP_TOKEN=""
TOKEN_FILE="$PZ_HOME/data/setup-token"
for _ in $(seq 1 20); do
if [[ -s "$TOKEN_FILE" ]]; then
SETUP_TOKEN="$(head -1 "$TOKEN_FILE")"
break
fi
if ! systemctl is-active --quiet pzmanager; then
break
fi
sleep 1
done
echo
echo "Готово. Панель запущена и слушает ${PZ_LISTEN}."
if wait_active; then
echo "Готово. Панель запущена и слушает ${PZ_LISTEN}."
else
echo "!! Служба не поднялась. Посмотрите, что случилось:" >&2
echo " journalctl -u pzmanager -n 40 --no-pager" >&2
exit 1
fi
echo
if [[ "$PZ_LISTEN" == 127.0.0.1:* || "$PZ_LISTEN" == localhost:* ]]; then
echo "Панель доступна только с самой машины. Пробросьте порт:"
@@ -198,8 +355,18 @@ else
echo " sudo ufw allow ${PORT}/tcp"
echo
fi
echo "Код первичной настройки — в журнале:"
echo
echo " journalctl -u pzmanager -n 30 --no-pager"
if [[ -n "$SETUP_TOKEN" ]]; then
echo "Код первичной настройки (введите его в браузере):"
echo
echo " ${SETUP_TOKEN}"
echo
echo "Код одноразовый: после создания администратора он перестаёт работать."
else
echo "Код первичной настройки не удалось прочитать. Посмотрите журнал:"
echo
echo " journalctl -u pzmanager -n 30 --no-pager"
fi
echo
echo "Игровые порты сервера: udp/16261 и udp/16262."
echo
echo "Удалить панель целиком: sudo ${PZ_HOME}/install.sh --uninstall --purge"
+68 -34
View File
@@ -11,7 +11,11 @@ set -euo pipefail
PZ_REPO="@PZ_REPO@"
PZ_BINARY="@PZ_BINARY@"
PZ_HOME="@PZ_HOME@"
PZ_USER="@PZ_USER@"
PZ_SERVICE="pzmanager"
# Имя разового юнита, в котором идёт обновление.
UPDATE_UNIT="pzmanager-update"
die() { echo "Ошибка: $*" >&2; exit 1; }
@@ -22,21 +26,57 @@ api_base() {
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() {
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
x86_64 | amd64) arch=amd64 ;;
aarch64 | arm64) arch=arm64 ;;
*) die "архитектура $(uname -m) не поддерживается" ;;
esac
# --collect убирает юнит после завершения, в том числе неуспешного: иначе
# следующий запуск упрётся в оставшийся failed-юнит с тем же именем.
systemd-run --quiet --collect --unit="$UPDATE_UNIT" \
--description="Обновление pzmanager" \
"$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)"
if [[ "$version" == "latest" ]]; then
release="$(curl -fsSL "${api}/releases/latest")" || die "не удалось запросить релиз"
else
# Тег приходит из панели; всё, кроме безопасных символов, отвергаем.
# Версия приходит из панели; всё, кроме безопасных символов, отвергаем.
[[ "$version" =~ ^[A-Za-z0-9._-]+$ ]] || die "недопустимая версия: $version"
release="$(curl -fsSL "${api}/releases/tags/${version}")" || die "релиз ${version} не найден"
fi
@@ -44,52 +84,46 @@ cmd_update() {
tag="$(printf '%s' "$release" | grep -o '"tag_name" *: *"[^"]*"' | head -1 | cut -d'"' -f4)"
[[ -n "$tag" ]] || die "в ответе нет тега"
name="pzmanager-linux-${arch}"
url="$(printf '%s' "$release" \
| 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}"
url="$(asset_url "$release" get.sh)"
[[ -n "$url" ]] || die "в релизе ${tag} нет get.sh"
local sums_url
sums_url="$(printf '%s' "$release" \
| grep -o '"browser_download_url" *: *"[^"]*"' | cut -d'"' -f4 \
| while read -r candidate; do
[[ "${candidate##*/}" == "checksums.txt" ]] && { printf '%s' "$candidate"; break; }
done)"
sums_url="$(asset_url "$release" checksums.txt)"
[[ -n "$sums_url" ]] || die "в релизе ${tag} нет checksums.txt"
tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' RETURN
echo "==> Скачиваю ${tag} (${arch})"
curl -fsSL -o "${tmp}/${name}" "$url" || die "не удалось скачать ${name}"
echo "==> Беру установщик из ${tag}"
curl -fsSL -o "${tmp}/get.sh" "$url" || die "не удалось скачать get.sh"
curl -fsSL -o "${tmp}/checksums.txt" "$sums_url" || die "не удалось скачать checksums.txt"
echo "==> Проверяю контрольную сумму"
( cd "$tmp" && grep " ${name}\$" checksums.txt > expected.txt && sha256sum -c expected.txt ) \
|| die "контрольная сумма не сошлась — файл повреждён или подменён"
( cd "$tmp" && awk '$NF == "get.sh"' checksums.txt > expected.txt \
&& [[ -s expected.txt ]] && sha256sum -c expected.txt ) \
|| die "контрольная сумма get.sh не сошлась"
echo "==> Заменяю ${PZ_BINARY}"
chmod 0755 "${tmp}/${name}"
# Через временный файл рядом и rename: перезаписать работающий бинарник
# нельзя, а переименовать поверх — можно.
install -m 0755 "${tmp}/${name}" "${PZ_BINARY}.new"
mv -f "${PZ_BINARY}.new" "${PZ_BINARY}"
echo "==> Обновляю до ${tag}"
# get.sh скачает бинарник нужной архитектуры и запустит install.sh, который
# сам остановит службу, заменит файлы и поднимет её обратно.
PZ_HOME="$PZ_HOME" PZ_USER="$PZ_USER" PZ_REPO="$PZ_REPO" PZ_VERSION="$tag" \
bash "${tmp}/get.sh" \
|| die "обновление не удалось"
echo "==> Перезапускаю ${PZ_SERVICE}"
systemctl restart "$PZ_SERVICE"
echo "Обновлено до ${tag}"
echo "Обновление до ${tag} завершено"
}
case "${1:-}" in
update)
cmd_update "${2:-latest}"
;;
do-update)
cmd_do_update "${2:-latest}"
;;
restart)
echo "==> Перезапускаю ${PZ_SERVICE}"
systemctl restart "$PZ_SERVICE"
# --no-block: команда ставит задание и выходит, не дожидаясь остановки.
# Иначе systemd убил бы нас вместе со службой на середине ожидания.
systemctl restart --no-block "$PZ_SERVICE"
;;
version)
"$PZ_BINARY" version
+5 -1
View File
@@ -19,7 +19,11 @@ KillMode=mixed
TimeoutStopSec=300
# Всё своё панель держит в /opt/pzmanager, домашние каталоги ей не нужны.
NoNewPrivileges=true
#
# NoNewPrivileges здесь намеренно не выставлен: он запрещает процессу и его
# потомкам повышать привилегии, а значит ломает sudo — и вместе с ним кнопки
# обновления и перезапуска панели. Прикрытием служит sudoers: сервисному
# пользователю разрешена ровно одна команда, pzmanager-admin.
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
+15 -10
View File
@@ -4,6 +4,7 @@ import (
"crypto/subtle"
"errors"
"net/http"
"os"
"time"
"github.com/mrleo1nid/pzmanager/internal/auth"
@@ -33,7 +34,7 @@ func (s *Server) handleSession(w http.ResponseWriter, r *http.Request) {
// handleSetup создаёт первого администратора. Доступен, только пока учёток нет.
func (s *Server) handleSetup(w http.ResponseWriter, r *http.Request) {
if !s.users.IsEmpty() {
writeError(w, http.StatusConflict, "панель уже настроена")
writeError(w, r, http.StatusConflict, "панель уже настроена")
return
}
var creds credentials
@@ -43,18 +44,22 @@ func (s *Server) handleSetup(w http.ResponseWriter, r *http.Request) {
// Токен печатается в журнал менеджера при старте: без него первым
// администратором стал бы любой, кто успел открыть страницу.
if s.setupToken == "" || subtle.ConstantTimeCompare([]byte(creds.Token), []byte(s.setupToken)) != 1 {
writeError(w, http.StatusForbidden, "неверный код первичной настройки")
writeError(w, r, http.StatusForbidden, "неверный код первичной настройки")
return
}
if err := s.users.AddUser(creds.Login, creds.Password); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
id, err := s.users.Login(creds.Login, creds.Password)
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
// Администратор создан — код больше не нужен и не должен лежать на диске.
if s.setupTokenFile != "" {
os.Remove(s.setupTokenFile)
}
s.setSessionCookie(w, id, sessionTTL)
writeJSON(w, http.StatusOK, map[string]any{"authenticated": true, "login": creds.Login})
}
@@ -67,10 +72,10 @@ func (s *Server) handleLogin(w http.ResponseWriter, r *http.Request) {
id, err := s.users.Login(creds.Login, creds.Password)
if err != nil {
if errors.Is(err, auth.ErrBadCredentials) {
writeError(w, http.StatusUnauthorized, err.Error())
writeError(w, r, http.StatusUnauthorized, err.Error())
return
}
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.setSessionCookie(w, id, sessionTTL)
@@ -95,7 +100,7 @@ func (s *Server) handleCreateUser(w http.ResponseWriter, r *http.Request) {
return
}
if err := s.users.AddUser(creds.Login, creds.Password); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
writeJSON(w, http.StatusCreated, map[string]any{"login": creds.Login})
@@ -105,11 +110,11 @@ func (s *Server) handleDeleteUser(w http.ResponseWriter, r *http.Request) {
login := r.PathValue("login")
current, _ := s.users.SessionFromRequest(r)
if login == current {
writeError(w, http.StatusBadRequest, "нельзя удалить учётную запись, под которой вы вошли")
writeError(w, r, http.StatusBadRequest, "нельзя удалить учётную запись, под которой вы вошли")
return
}
if err := s.users.DeleteUser(login); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
writeJSON(w, http.StatusOK, map[string]any{"deleted": login})
@@ -123,7 +128,7 @@ func (s *Server) handleChangePassword(w http.ResponseWriter, r *http.Request) {
return
}
if err := s.users.SetPassword(r.PathValue("login"), body.Password); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
writeJSON(w, http.StatusOK, map[string]any{"ok": true})
+16 -12
View File
@@ -7,6 +7,7 @@ import (
"time"
"github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/i18n"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
)
@@ -19,12 +20,12 @@ func (s *Server) handleGetServerConfig(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]any{
"exists": false,
"path": path,
"hint": "Файл создаётся при первом запуске сервера",
"hint": i18n.T(i18n.FromRequest(r), "Файл создаётся при первом запуске сервера"),
})
return
}
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
writeJSON(w, http.StatusOK, map[string]any{
@@ -32,6 +33,9 @@ func (s *Server) handleGetServerConfig(w http.ResponseWriter, r *http.Request) {
"path": path,
"keys": ini.Keys(),
"values": ini.Map(),
// Игра сама пишет в конфиг описания параметров на языке сервера —
// показываем их, вместо того чтобы придумывать свои.
"descriptions": ini.Comments(),
})
}
@@ -47,14 +51,14 @@ func (s *Server) handlePutServerConfig(w http.ResponseWriter, r *http.Request) {
path := s.cfg.ServerConfigPath()
ini, err := pzconfig.LoadINI(path)
if err != nil {
writeError(w, http.StatusBadRequest, "конфиг сервера недоступен: "+err.Error())
writeError(w, r, http.StatusBadRequest, "конфиг сервера недоступен: "+err.Error())
return
}
for key, value := range body.Values {
ini.Set(key, value)
}
if err := pzconfig.SaveINI(path, ini); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", "Конфиг сервера сохранён (изменений: "+strconv.Itoa(len(body.Values))+"). Изменения вступят в силу после перезапуска.")
@@ -68,12 +72,12 @@ func (s *Server) handleGetSandbox(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]any{
"exists": false,
"path": path,
"hint": "Файл создаётся при первом запуске сервера",
"hint": i18n.T(i18n.FromRequest(r), "Файл создаётся при первом запуске сервера"),
})
return
}
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
writeJSON(w, http.StatusOK, map[string]any{
@@ -93,17 +97,17 @@ func (s *Server) handlePutSandbox(w http.ResponseWriter, r *http.Request) {
path := s.cfg.SandboxConfigPath()
sb, err := pzconfig.LoadSandbox(path)
if err != nil {
writeError(w, http.StatusBadRequest, "настройки песочницы недоступны: "+err.Error())
writeError(w, r, http.StatusBadRequest, "настройки песочницы недоступны: "+err.Error())
return
}
for key, value := range body.Values {
if err := sb.Set(key, value); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
}
if err := pzconfig.SaveSandbox(path, sb); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", "Настройки песочницы сохранены. Часть параметров применяется только к новому миру.")
@@ -174,16 +178,16 @@ func (s *Server) handlePutManagerConfig(w http.ResponseWriter, r *http.Request)
c.Backup.Schedule = config.Duration(time.Duration(dto.BackupScheduleMin) * time.Minute)
if err := c.Save(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
if err := c.EnsureDirs(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", "Настройки менеджера сохранены")
writeJSON(w, http.StatusOK, map[string]any{
"saved": true,
"note": "Адрес прослушивания применится после перезапуска pzmanager",
"note": i18n.T(i18n.FromRequest(r), "Адрес прослушивания применится после перезапуска pzmanager"),
})
}
+8 -7
View File
@@ -6,6 +6,7 @@ import (
"path/filepath"
"regexp"
"github.com/mrleo1nid/pzmanager/internal/i18n"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
)
@@ -24,12 +25,12 @@ func (s *Server) handleGetMods(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]any{
"exists": false,
"path": path,
"hint": "Файл конфигурации появится после первого запуска сервера",
"hint": i18n.T(i18n.FromRequest(r), "Файл конфигурации появится после первого запуска сервера"),
})
return
}
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
@@ -67,7 +68,7 @@ func (s *Server) handlePutMods(w http.ResponseWriter, r *http.Request) {
path := s.cfg.ServerConfigPath()
ini, err := pzconfig.LoadINI(path)
if err != nil {
writeError(w, http.StatusBadRequest, "конфиг сервера недоступен: "+err.Error())
writeError(w, r, http.StatusBadRequest, "конфиг сервера недоступен: "+err.Error())
return
}
ini.SetMods(body.Mods, body.WorkshopItems)
@@ -75,7 +76,7 @@ func (s *Server) handlePutMods(w http.ResponseWriter, r *http.Request) {
ini.Set(pzconfig.KeyMap, pzconfig.JoinList(body.Map))
}
if err := pzconfig.SaveINI(path, ini); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", "Список модов обновлён. Сервер докачает моды из мастерской при следующем запуске.")
@@ -95,7 +96,7 @@ func (s *Server) handleLookupMods(w http.ResponseWriter, r *http.Request) {
return
}
if len(body.IDs) > 200 {
writeError(w, http.StatusBadRequest, "слишком много идентификаторов за один запрос")
writeError(w, r, http.StatusBadRequest, "слишком много идентификаторов за один запрос")
return
}
items := s.workshop.Details(r.Context(), body.IDs)
@@ -114,13 +115,13 @@ func (s *Server) handleExpandCollection(w http.ResponseWriter, r *http.Request)
match := idFromInput.FindString(body.ID)
if match == "" {
writeError(w, http.StatusBadRequest, "не похоже на идентификатор или ссылку на коллекцию")
writeError(w, r, http.StatusBadRequest, "не похоже на идентификатор или ссылку на коллекцию")
return
}
items, err := s.workshop.Collection(r.Context(), match)
if err != nil {
writeError(w, http.StatusBadGateway, err.Error())
writeError(w, r, http.StatusBadGateway, err.Error())
return
}
// Названия подтягиваем сразу: иначе панель показала бы десяток голых
+237
View File
@@ -0,0 +1,237 @@
package api
import (
"errors"
"fmt"
"io"
"net/http"
"path/filepath"
"strings"
"github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/preset"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
"github.com/mrleo1nid/pzmanager/internal/pzserver"
)
// keepGroups — то, что при импорте разумно оставить своим. Пресет собирали не
// под эту машину: его порты, пароли и название сервера к ней отношения не
// имеют, и молча их подменять — верный способ потерять доступ к серверу.
var keepGroups = map[string][]string{
"ports": {"DefaultPort", "UDPPort", "RCONPort", "RCONPassword"},
"access": {"Password", "server_browser_announced_ip", "PublicServerIP", "ServerBrowserAnnouncedIP"},
"identity": {"PublicName", "PublicDescription"},
}
// handlePreviewPreset разбирает загруженный архив и рассказывает, что в нём
// нашлось. Ничего не пишет: решение принимает человек.
func (s *Server) handlePreviewPreset(w http.ResponseWriter, r *http.Request) {
sets, ok := s.readPresetUpload(w, r)
if !ok {
return
}
summaries := make([]preset.Summary, 0, len(sets))
for _, set := range sets {
summaries = append(summaries, set.Describe())
}
writeJSON(w, http.StatusOK, map[string]any{"presets": summaries})
}
// handleImportPreset записывает выбранный набор в профиль — новый или уже
// существующий.
func (s *Server) handleImportPreset(w http.ResponseWriter, r *http.Request) {
sets, ok := s.readPresetUpload(w, r)
if !ok {
return
}
files, err := pickPreset(sets, r.FormValue("preset"))
if err != nil {
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
createNew := r.FormValue("target") != "existing"
id := strings.TrimSpace(r.FormValue("profile"))
if id == "" && createNew {
id = config.SanitizeProfileID(files.Name)
}
_, exists := s.cfg.Profile(id)
switch {
case createNew && exists:
writeError(w, r, http.StatusConflict, fmt.Sprintf("профиль %q уже существует", id))
return
case !createNew && !exists:
writeError(w, r, http.StatusNotFound, "профиль не найден")
return
}
// Живой сервер держит мир и конфиг в памяти и переписывает файлы при
// остановке — импорт под ним просто пропал бы.
if id == s.cfg.Active && s.sup.State() != pzserver.StateStopped {
writeError(w, r, http.StatusConflict, "сначала остановите игровой сервер")
return
}
if createNew {
profile := config.Profile{ID: id, Title: strings.TrimSpace(r.FormValue("title"))}
if profile.Title == "" {
profile.Title = files.Name
}
if err := s.cfg.AddProfile(profile); err != nil {
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
}
result, err := s.applyPreset(files, id, parseKeep(r.FormValue("keep")))
if err != nil {
if createNew {
// Профиль без файлов настроек только мешал бы: откатываем.
_ = s.cfg.DeleteProfile(id)
}
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
if createNew {
if err := s.cfg.Save(); err != nil {
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
}
summary := files.Describe()
s.sup.AppendLog("manager", fmt.Sprintf("Импортирован пресет %q в профиль %q (модов: %d)",
files.Name, id, summary.Mods))
result["profile"] = id
result["created"] = createNew
result["summary"] = summary
writeJSON(w, http.StatusOK, result)
}
// applyPreset раскладывает файлы набора под именем профиля. Прежние версии
// сохраняются рядом с расширением .bak — так же, как при правке в редакторе.
func (s *Server) applyPreset(files preset.Files, id string, keep []string) (map[string]any, error) {
written := []string{}
kept := []string{}
keptFrom := ""
if files.INI != nil {
ini := pzconfig.ParseINI(files.INI)
// Свои значения берём из конфига самого профиля, а у нового профиля
// их ещё нет — тогда из активного: порты и пароли на машине общие.
source, from := s.keepSource(id)
if source != nil {
for _, key := range keep {
if source.Has(key) {
ini.Set(key, source.Get(key))
kept = append(kept, key)
}
}
if len(kept) > 0 {
keptFrom = from
}
}
path := s.cfg.ServerConfigPathFor(id)
if err := pzconfig.SaveINI(path, ini); err != nil {
return nil, err
}
written = append(written, filepath.Base(path))
}
raw := [][2]any{
{s.cfg.SandboxConfigPathFor(id), files.Sandbox},
{spawnRegionsPath(s.cfg, id), files.SpawnRegions},
}
for _, pair := range raw {
data, _ := pair[1].([]byte)
if data == nil {
continue
}
path := pair[0].(string)
if err := pzconfig.SaveRaw(path, data); err != nil {
return nil, err
}
written = append(written, filepath.Base(path))
}
return map[string]any{"files": written, "kept": kept, "kept_from": keptFrom}, nil
}
// keepSource выбирает конфиг, из которого берутся сохраняемые значения.
func (s *Server) keepSource(id string) (*pzconfig.INI, string) {
candidates := []string{id}
if id != s.cfg.Active {
candidates = append(candidates, s.cfg.Active)
}
for _, candidate := range candidates {
ini, err := pzconfig.LoadINI(s.cfg.ServerConfigPathFor(candidate))
if err == nil {
return ini, candidate
}
}
return nil, ""
}
// spawnRegionsPath — <профиль>_spawnregions.lua рядом с остальными конфигами.
func spawnRegionsPath(cfg *config.Config, id string) string {
return filepath.Join(filepath.Dir(cfg.ServerConfigPathFor(id)), id+"_spawnregions.lua")
}
// parseKeep разбирает список групп, которые человек отметил в панели.
func parseKeep(value string) []string {
keys := []string{}
for _, group := range strings.Split(value, ",") {
keys = append(keys, keepGroups[strings.TrimSpace(group)]...)
}
return keys
}
// pickPreset выбирает набор по имени; когда набор один, имя необязательно.
func pickPreset(sets []preset.Files, name string) (preset.Files, error) {
if name == "" {
if len(sets) == 1 {
return sets[0], nil
}
return preset.Files{}, errors.New("в архиве несколько наборов настроек — выберите один")
}
for _, set := range sets {
if set.Name == name {
return set, nil
}
}
return preset.Files{}, fmt.Errorf("набор %q не найден в архиве", name)
}
// readPresetUpload принимает архив из формы и разбирает его.
func (s *Server) readPresetUpload(w http.ResponseWriter, r *http.Request) ([]preset.Files, bool) {
r.Body = http.MaxBytesReader(w, r.Body, preset.MaxArchiveSize)
if err := r.ParseMultipartForm(8 << 20); err != nil {
writeError(w, r, http.StatusBadRequest, "файл не принят: "+err.Error())
return nil, false
}
file, header, err := r.FormFile("file")
if err != nil {
writeError(w, r, http.StatusBadRequest, "файл не выбран")
return nil, false
}
defer file.Close()
if !strings.HasSuffix(strings.ToLower(header.Filename), ".zip") {
writeError(w, r, http.StatusBadRequest, "ожидается ZIP-архив пакета настроек")
return nil, false
}
data, err := io.ReadAll(io.LimitReader(file, preset.MaxArchiveSize))
if err != nil {
writeError(w, r, http.StatusBadRequest, "файл не прочитан: "+err.Error())
return nil, false
}
sets, err := preset.FromZip(data)
if err != nil {
writeError(w, r, http.StatusBadRequest, err.Error())
return nil, false
}
return sets, true
}
+47 -15
View File
@@ -7,15 +7,36 @@ import (
"os"
"github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
"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 — профиль в том виде, в каком его показывает панель. Пароль
// наружу не отдаётся, только признак того, что он задан.
type profileDTO struct {
ID string `json:"id"`
Title string `json:"title"`
JavaMemory string `json:"java_memory"`
JavaMemoryMin string `json:"java_memory_min"`
ExtraArgs []string `json:"extra_args"`
HasAdminPassword bool `json:"has_admin_password"`
AdminPassword string `json:"admin_password,omitempty"`
@@ -33,6 +54,7 @@ func (s *Server) profileToDTO(p config.Profile) profileDTO {
ID: p.ID,
Title: p.Title,
JavaMemory: p.JavaMemory,
JavaMemoryMin: p.JavaMemoryMin,
ExtraArgs: p.ExtraArgs,
HasAdminPassword: p.AdminPassword != "",
HasConfig: fileExists(s.cfg.ServerConfigPathFor(p.ID)),
@@ -61,16 +83,21 @@ func (s *Server) handleCreateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) {
return
}
if err := validateProfileMemory(dto); err != nil {
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
profile := config.Profile{
ID: dto.ID,
Title: dto.Title,
JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs,
AdminPassword: dto.AdminPassword,
}
if err := s.cfg.AddProfile(profile); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
@@ -79,13 +106,13 @@ func (s *Server) handleCreateProfile(w http.ResponseWriter, r *http.Request) {
// Профиль уже добавлен в память — откатываем, чтобы не остался
// наполовину настроенный.
_ = s.cfg.DeleteProfile(profile.ID)
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
}
if err := s.cfg.Save(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", fmt.Sprintf("Создан профиль %q", profile.Name()))
@@ -125,7 +152,7 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
current, ok := s.cfg.Profile(id)
if !ok {
writeError(w, http.StatusNotFound, "профиль не найден")
writeError(w, r, http.StatusNotFound, "профиль не найден")
return
}
@@ -133,12 +160,17 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) {
return
}
if err := validateProfileMemory(dto); err != nil {
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
updated := config.Profile{
ID: id,
Title: dto.Title,
JavaMemory: dto.JavaMemory,
ExtraArgs: dto.ExtraArgs,
ID: id,
Title: dto.Title,
JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs,
// Пустой пароль означает "оставить прежний": наружу мы его не отдаём,
// и форма присылает пустую строку, пока его не меняли.
AdminPassword: current.AdminPassword,
@@ -148,11 +180,11 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
}
if err := s.cfg.UpdateProfile(id, updated); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
if err := s.cfg.Save(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
@@ -166,11 +198,11 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleDeleteProfile(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
if err := s.cfg.DeleteProfile(id); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
if err := s.cfg.Save(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", fmt.Sprintf(
@@ -183,16 +215,16 @@ func (s *Server) handleDeleteProfile(w http.ResponseWriter, r *http.Request) {
// сервере нельзя: профили делят игровые порты и файлы запуска.
func (s *Server) handleActivateProfile(w http.ResponseWriter, r *http.Request) {
if s.sup.State() != pzserver.StateStopped {
writeError(w, http.StatusConflict, "сначала остановите игровой сервер")
writeError(w, r, http.StatusConflict, "сначала остановите игровой сервер")
return
}
id := r.PathValue("id")
if err := s.cfg.SetActive(id); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
if err := s.cfg.Save(); err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
s.sup.AppendLog("manager", fmt.Sprintf("Активный профиль: %s", s.cfg.ActiveProfile().Name()))
+37 -11
View File
@@ -8,19 +8,26 @@ import (
"strconv"
"time"
"github.com/mrleo1nid/pzmanager/internal/i18n"
"github.com/mrleo1nid/pzmanager/internal/pzserver"
)
func (s *Server) handleStatus(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]any{
"server": s.sup.Status(),
"task": s.jobs.Status(),
})
lang := i18n.FromRequest(r)
status := s.sup.Status()
status.LastExit = i18n.T(lang, status.LastExit)
// Имя задачи придумано менеджером и висит в панели, пока задача идёт.
task := s.jobs.Status()
task.Name = i18n.T(lang, task.Name)
task.Error = i18n.T(lang, task.Error)
writeJSON(w, http.StatusOK, map[string]any{"server": status, "task": task})
}
func (s *Server) handleStart(w http.ResponseWriter, r *http.Request) {
if err := s.sup.Start(); err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusOK, map[string]any{"state": s.sup.State()})
@@ -31,7 +38,7 @@ func (s *Server) handleStart(w http.ResponseWriter, r *http.Request) {
// видит прогресс по состоянию и логам.
func (s *Server) handleStop(w http.ResponseWriter, r *http.Request) {
if s.sup.State() == pzserver.StateStopped {
writeOpError(w, pzserver.ErrNotRunning)
writeOpError(w, r, pzserver.ErrNotRunning)
return
}
go func() {
@@ -44,7 +51,7 @@ func (s *Server) handleStop(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleRestart(w http.ResponseWriter, r *http.Request) {
if !s.sup.Installed() {
writeOpError(w, pzserver.ErrNotInstalled)
writeOpError(w, r, pzserver.ErrNotInstalled)
return
}
go func() {
@@ -63,7 +70,7 @@ func (s *Server) handleConsole(w http.ResponseWriter, r *http.Request) {
return
}
if err := s.sup.Send(body.Command); err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusOK, map[string]any{"sent": body.Command})
@@ -72,7 +79,23 @@ func (s *Server) handleConsole(w http.ResponseWriter, r *http.Request) {
// handleLogs отдаёт историю консоли начиная с указанного номера строки.
func (s *Server) handleLogs(w http.ResponseWriter, r *http.Request) {
since, _ := strconv.ParseInt(r.URL.Query().Get("since"), 10, 64)
writeJSON(w, http.StatusOK, map[string]any{"lines": s.sup.Lines(since)})
writeJSON(w, http.StatusOK, map[string]any{"lines": translateLines(r, s.sup.Lines(since))})
}
// translateLines переводит строки консоли на язык читающего. Буфер один на
// всех, поэтому перевод делается на выходе, у каждого подключения свой. Вывод
// самого игрового сервера через словарь проходит без изменений: он английский.
func translateLines(r *http.Request, lines []pzserver.LogLine) []pzserver.LogLine {
lang := i18n.FromRequest(r)
if lang == i18n.Default {
return lines
}
out := make([]pzserver.LogLine, len(lines))
for i, line := range lines {
line.Text = i18n.T(lang, line.Text)
out[i] = line
}
return out
}
// handleLogStream — живая консоль через Server-Sent Events. SSE выбран вместо
@@ -80,7 +103,7 @@ func (s *Server) handleLogs(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleLogStream(w http.ResponseWriter, r *http.Request) {
flusher, ok := w.(http.Flusher)
if !ok {
writeError(w, http.StatusInternalServerError, "потоковая отдача не поддерживается")
writeError(w, r, http.StatusInternalServerError, "потоковая отдача не поддерживается")
return
}
@@ -94,9 +117,11 @@ func (s *Server) handleLogStream(w http.ResponseWriter, r *http.Request) {
lines, unsubscribe := s.sup.Subscribe()
defer unsubscribe()
lang := i18n.FromRequest(r)
// Сначала отдаём хвост истории, чтобы вкладка не открывалась пустой.
since, _ := strconv.ParseInt(r.URL.Query().Get("since"), 10, 64)
for _, line := range s.sup.Lines(since) {
for _, line := range translateLines(r, s.sup.Lines(since)) {
if !writeSSE(w, line) {
return
}
@@ -115,6 +140,7 @@ func (s *Server) handleLogStream(w http.ResponseWriter, r *http.Request) {
if !ok {
return
}
line.Text = i18n.T(lang, line.Text)
if !writeSSE(w, line) {
return
}
+20 -16
View File
@@ -19,7 +19,7 @@ func (s *Server) handleTaskStatus(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleTaskCancel(w http.ResponseWriter, r *http.Request) {
if !s.jobs.Busy() {
writeError(w, http.StatusConflict, "нет активной задачи")
writeError(w, r, http.StatusConflict, "нет активной задачи")
return
}
s.jobs.Cancel()
@@ -31,7 +31,7 @@ func (s *Server) handleTaskCancel(w http.ResponseWriter, r *http.Request) {
// JVM, и сервер упадёт непредсказуемо.
func (s *Server) handleInstall(w http.ResponseWriter, r *http.Request) {
if s.sup.State() != pzserver.StateStopped {
writeError(w, http.StatusConflict, "сначала остановите игровой сервер")
writeError(w, r, http.StatusConflict, "сначала остановите игровой сервер")
return
}
@@ -46,7 +46,7 @@ func (s *Server) handleInstall(w http.ResponseWriter, r *http.Request) {
return nil
})
if err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusAccepted, map[string]any{"task": name})
@@ -55,7 +55,7 @@ func (s *Server) handleInstall(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleListBackups(w http.ResponseWriter, r *http.Request) {
archives, err := s.backups.List()
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
// Фильтр по профилю необязателен: панель показывает архивы всех профилей,
@@ -88,7 +88,7 @@ func (s *Server) handleCreateBackup(w http.ResponseWriter, r *http.Request) {
body.Profile = s.cfg.Active
}
if _, ok := s.cfg.Profile(body.Profile); !ok {
writeError(w, http.StatusBadRequest, "профиль не найден")
writeError(w, r, http.StatusBadRequest, "профиль не найден")
return
}
// Живой сервер держит мир в памяти, и снимок чужого профиля тут ни при
@@ -119,7 +119,7 @@ func (s *Server) handleCreateBackup(w http.ResponseWriter, r *http.Request) {
return err
})
if err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusAccepted, map[string]any{"task": name})
@@ -127,7 +127,7 @@ func (s *Server) handleCreateBackup(w http.ResponseWriter, r *http.Request) {
func (s *Server) handleDeleteBackup(w http.ResponseWriter, r *http.Request) {
if err := s.backups.Delete(r.PathValue("name")); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
writeJSON(w, http.StatusOK, map[string]any{"deleted": r.PathValue("name")})
@@ -137,18 +137,18 @@ func (s *Server) handleDownloadBackup(w http.ResponseWriter, r *http.Request) {
name := r.PathValue("name")
path, err := s.backups.Path(name)
if err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
f, err := os.Open(path)
if err != nil {
writeError(w, http.StatusNotFound, "архив не найден")
writeError(w, r, http.StatusNotFound, "архив не найден")
return
}
defer f.Close()
info, err := f.Stat()
if err != nil {
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
return
}
@@ -162,12 +162,12 @@ func (s *Server) handleDownloadBackup(w http.ResponseWriter, r *http.Request) {
// своим состоянием при следующем сохранении.
func (s *Server) handleRestoreBackup(w http.ResponseWriter, r *http.Request) {
if s.sup.State() != pzserver.StateStopped {
writeError(w, http.StatusConflict, "сначала остановите игровой сервер")
writeError(w, r, http.StatusConflict, "сначала остановите игровой сервер")
return
}
name := r.PathValue("name")
if _, err := s.backups.Path(name); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
writeError(w, r, http.StatusBadRequest, err.Error())
return
}
// Страховочную копию снимаем с того профиля, поверх которого ляжет архив;
@@ -188,7 +188,7 @@ func (s *Server) handleRestoreBackup(w http.ResponseWriter, r *http.Request) {
return s.backups.Restore(ctx, log, name)
})
if err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusAccepted, map[string]any{"task": taskName})
@@ -236,12 +236,16 @@ func StartBackupScheduler(ctx context.Context, s *Server) {
// При обычном старте то же самое делает супервизор.
func (s *Server) applyJavaMemory(log func(string)) error {
profile := s.cfg.ActiveProfile()
if profile.JavaMemory == "" {
if profile.JavaMemory == "" && profile.JavaMemoryMin == "" {
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
}
log("Лимит памяти JVM выставлен: " + profile.JavaMemory)
if profile.JavaMemoryMin != "" {
log(fmt.Sprintf("Память JVM: от %s до %s", profile.JavaMemoryMin, profile.JavaMemory))
} else {
log("Лимит памяти JVM выставлен: " + profile.JavaMemory)
}
return nil
}
+6 -5
View File
@@ -26,7 +26,7 @@ func (s *Server) handleApplyUpdate(w http.ResponseWriter, r *http.Request) {
}
if !s.updater.CanApply(r.Context()) {
writeError(w, http.StatusPreconditionFailed, updater.ErrNoAdmin.Error())
writeError(w, r, http.StatusPreconditionFailed, updater.ErrNoAdmin.Error())
return
}
@@ -35,11 +35,12 @@ func (s *Server) handleApplyUpdate(w http.ResponseWriter, r *http.Request) {
// Игровой сервер останавливаем сами: иначе это сделает systemd уже в
// момент перезапуска, и ожидание растянется на таймаут остановки.
s.stopServerBefore(log, "обновлением")
log("Запускаю обновление, панель перезапустится")
log("Запускаю обновление — оно идёт отдельной службой и переживёт перезапуск панели")
log("Подробности: journalctl -u pzmanager-update -f")
return s.updater.Apply(ctx, log, body.Version)
})
if err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusAccepted, map[string]any{"task": name})
@@ -48,7 +49,7 @@ func (s *Server) handleApplyUpdate(w http.ResponseWriter, r *http.Request) {
// handleRestartManager перезапускает саму панель.
func (s *Server) handleRestartManager(w http.ResponseWriter, r *http.Request) {
if !s.updater.CanApply(r.Context()) {
writeError(w, http.StatusPreconditionFailed, updater.ErrNoAdmin.Error())
writeError(w, r, http.StatusPreconditionFailed, updater.ErrNoAdmin.Error())
return
}
@@ -59,7 +60,7 @@ func (s *Server) handleRestartManager(w http.ResponseWriter, r *http.Request) {
return s.updater.Restart(ctx, log)
})
if err != nil {
writeOpError(w, err)
writeOpError(w, r, err)
return
}
writeJSON(w, http.StatusAccepted, map[string]any{"task": name})
+33 -22
View File
@@ -13,6 +13,7 @@ import (
"github.com/mrleo1nid/pzmanager/internal/auth"
"github.com/mrleo1nid/pzmanager/internal/backup"
"github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/i18n"
"github.com/mrleo1nid/pzmanager/internal/job"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
"github.com/mrleo1nid/pzmanager/internal/pzserver"
@@ -40,8 +41,11 @@ type Server struct {
// secureCookies включает флаг Secure у cookie сессии (панель за HTTPS).
secureCookies bool
// setupToken защищает первичное создание администратора: менеджер печатает
// его в журнал при старте, когда учёток ещё нет.
// его при старте, когда учёток ещё нет.
setupToken string
// setupTokenFile — копия кода на диске, которую показывает установщик.
// После создания администратора файл больше не нужен.
setupTokenFile string
}
// Options — то, что нужно собрать серверу API.
@@ -57,6 +61,9 @@ type Options struct {
Static fs.FS
SecureCookies bool
SetupToken string
// SetupTokenFile — файл с кодом первичной настройки, удаляется после
// создания администратора.
SetupTokenFile string
// Repo — репозиторий, из которого панель берёт обновления.
Repo string
}
@@ -64,18 +71,19 @@ type Options struct {
// New собирает HTTP-обработчик панели.
func New(o Options) *Server {
return &Server{
version: o.Version,
cfg: o.Config,
users: o.Users,
sup: o.Supervisor,
jobs: o.Jobs,
backups: o.Backups,
steam: o.Steam,
workshop: pzconfig.NewWorkshopClient(),
updater: updater.New(o.Repo, o.Version),
static: o.Static,
secureCookies: o.SecureCookies,
setupToken: o.SetupToken,
version: o.Version,
cfg: o.Config,
users: o.Users,
sup: o.Supervisor,
jobs: o.Jobs,
backups: o.Backups,
steam: o.Steam,
workshop: pzconfig.NewWorkshopClient(),
updater: updater.New(o.Repo, o.Version),
static: o.Static,
secureCookies: o.SecureCookies,
setupToken: o.SetupToken,
setupTokenFile: o.SetupTokenFile,
}
}
@@ -109,6 +117,8 @@ func (s *Server) Handler() http.Handler {
"PUT /api/profiles/{id}": s.handleUpdateProfile,
"DELETE /api/profiles/{id}": s.handleDeleteProfile,
"POST /api/profiles/{id}/activate": s.handleActivateProfile,
"POST /api/presets/preview": s.handlePreviewPreset,
"POST /api/presets/import": s.handleImportPreset,
"GET /api/mods": s.handleGetMods,
"PUT /api/mods": s.handlePutMods,
"POST /api/mods/lookup": s.handleLookupMods,
@@ -168,7 +178,7 @@ func (s *Server) withCommonHeaders(next http.Handler) http.Handler {
if r.Method != http.MethodGet && r.Method != http.MethodHead &&
strings.HasPrefix(r.URL.Path, "/api/") && r.Header.Get(csrfHeader) == "" {
writeError(w, http.StatusForbidden, "запрос без заголовка "+csrfHeader)
writeError(w, r, http.StatusForbidden, "запрос без заголовка "+csrfHeader)
return
}
next.ServeHTTP(w, r)
@@ -179,7 +189,7 @@ func (s *Server) withCommonHeaders(next http.Handler) http.Handler {
func (s *Server) requireAuth(next http.HandlerFunc) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if _, ok := s.users.SessionFromRequest(r); !ok {
writeError(w, http.StatusUnauthorized, "требуется вход")
writeError(w, r, http.StatusUnauthorized, "требуется вход")
return
}
next(w, r)
@@ -221,20 +231,21 @@ func writeJSON(w http.ResponseWriter, status int, v any) {
}
// writeError отправляет ошибку в том же формате, что и остальные ответы.
func writeError(w http.ResponseWriter, status int, message string) {
writeJSON(w, status, map[string]string{"error": message})
// Текст переводится на язык панели: в коде сообщения написаны по-русски.
func writeError(w http.ResponseWriter, r *http.Request, status int, message string) {
writeJSON(w, status, map[string]string{"error": i18n.T(i18n.FromRequest(r), message)})
}
// writeOpError переводит ошибку операции в подходящий HTTP-код.
func writeOpError(w http.ResponseWriter, err error) {
func writeOpError(w http.ResponseWriter, r *http.Request, err error) {
switch {
case errors.Is(err, pzserver.ErrAlreadyRunning), errors.Is(err, pzserver.ErrNotRunning),
errors.Is(err, job.ErrBusy):
writeError(w, http.StatusConflict, err.Error())
writeError(w, r, http.StatusConflict, err.Error())
case errors.Is(err, pzserver.ErrNotInstalled):
writeError(w, http.StatusPreconditionFailed, err.Error())
writeError(w, r, http.StatusPreconditionFailed, err.Error())
default:
writeError(w, http.StatusInternalServerError, err.Error())
writeError(w, r, http.StatusInternalServerError, err.Error())
}
}
@@ -244,7 +255,7 @@ func decodeJSON(w http.ResponseWriter, r *http.Request, dst any) bool {
dec := json.NewDecoder(r.Body)
dec.DisallowUnknownFields()
if err := dec.Decode(dst); err != nil {
writeError(w, http.StatusBadRequest, "некорректный JSON: "+err.Error())
writeError(w, r, http.StatusBadRequest, "некорректный JSON: "+err.Error())
return false
}
return true
+24
View File
@@ -34,6 +34,11 @@ type Profile struct {
// запуске: файл запуска сервера общий для всех профилей.
JavaMemory string `yaml:"java_memory"`
// JavaMemoryMin — -Xms. Пусто (по умолчанию) означает, что JVM занимает
// память по мере надобности: равные -Xms и -Xmx заставляют её забрать всё
// сразу, и на машине с небольшой ОЗУ сервер не поднимется.
JavaMemoryMin string `yaml:"java_memory_min"`
// ExtraArgs — дополнительные аргументы start-server.sh.
ExtraArgs []string `yaml:"extra_args"`
}
@@ -54,6 +59,25 @@ func ValidateProfileID(id string) error {
return nil
}
// SanitizeProfileID превращает имя файла из чужого пакета настроек в годный
// идентификатор профиля: пробелы и точки в именах пресетов не редкость, а
// идентификатор становится именем конфига и папки мира.
func SanitizeProfileID(name string) string {
var b strings.Builder
for _, r := range name {
switch {
case r >= 'a' && r <= 'z', r >= 'A' && r <= 'Z', r >= '0' && r <= '9', r == '-', r == '_':
b.WriteRune(r)
default:
b.WriteRune('-')
}
if b.Len() >= 32 {
break
}
}
return strings.Trim(b.String(), "-")
}
// Config — всё, что менеджеру нужно знать о хосте и о серверах PZ.
type Config struct {
// Listen — адрес веб-панели. Для доступа только через SSH-туннель
+206
View File
@@ -0,0 +1,206 @@
package i18n
// Словарь сообщений менеджера. Ключ — русская фраза ровно в том виде, в каком
// она собирается в коде; значение — английский перевод.
//
// В formats оба текста записаны как форматные строки: %s отмечает место, куда
// при сборке сообщения подставилось значение. Порядок значений в переводе
// должен совпадать с оригиналом.
var messages = map[string]string{
// --- Вход и учётные записи ---
"панель уже настроена": "the panel is already set up",
"неверный код первичной настройки": "wrong setup code",
"неверный логин или пароль": "wrong login or password",
"требуется вход": "sign-in required",
"логин не может быть пустым": "the login cannot be empty",
"пароль короче 8 символов": "the password is shorter than 8 characters",
"пароли не совпадают": "the passwords do not match",
"пользователь не найден": "user not found",
"пользователь уже существует": "the user already exists",
"нельзя удалить учётную запись, под которой вы вошли": "you cannot delete the account you are signed in with",
// --- Сервер и задачи ---
"сервер не запущен": "the server is not running",
"сервер уже запущен": "the server is already running",
"сначала остановите игровой сервер": "stop the game server first",
"серверные файлы не найдены — сначала выполните установку": "server files not found — install the server first",
"нет активной задачи": "no active task",
"уже выполняется другая задача": "another task is already running",
"пустая команда": "empty command",
"потоковая отдача не поддерживается": "streaming is not supported",
"штатное завершение": "clean shutdown",
// --- Профили ---
"профиль не найден": "profile not found",
"нельзя удалить активный профиль — сначала переключитесь на другой": "the active profile cannot be deleted — switch to another one first",
"нельзя удалить единственный профиль": "the only profile cannot be deleted",
"путь к конфигу неизвестен": "the config path is unknown",
// --- Бэкапы и обновление ---
"архив не найден": "archive not found",
"обновление из панели недоступно: нет pzmanager-admin или правила sudo": "updating from the panel is unavailable: pzmanager-admin or the sudo rule is missing",
"длительность должна быть строкой вида 90s или числом секунд": "the duration must be a string like 90s or a number of seconds",
// --- Моды ---
"слишком много идентификаторов за один запрос": "too many identifiers in one request",
"не похоже на идентификатор или ссылку на коллекцию": "that does not look like a collection ID or link",
// --- Подсказки и пометки в ответах API ---
"Файл создаётся при первом запуске сервера": "The file is created on the first server start",
"Файл конфигурации появится после первого запуска сервера": "The configuration file appears after the first server start",
"Адрес прослушивания применится после перезапуска pzmanager": "The listen address applies after a pzmanager restart",
// --- Имена задач ---
"Установка/обновление сервера через SteamCMD": "Installing or updating the server via SteamCMD",
"Обновление панели": "Panel update",
"Перезапуск панели": "Panel restart",
// --- Сообщения в консоли панели ---
"Настройки менеджера сохранены": "Manager settings saved",
"Настройки песочницы сохранены. Часть параметров применяется только к новому миру.": "Sandbox settings saved. Some of them only affect a freshly created world.",
"Список модов обновлён. Сервер докачает моды из мастерской при следующем запуске.": "Mod list updated. The server will download the missing mods on its next start.",
"Профиль сохранён": "Profile saved",
"Профиль сохранён. Память и аргументы запуска применятся после перезапуска сервера.": "Profile saved. Memory and launch arguments apply after a server restart.",
"Останавливаю сервер перед бэкапом": "Stopping the server before the backup",
"Делаю страховочный бэкап текущего мира": "Taking a safety backup of the current world",
"Поднимаю сервер обратно": "Bringing the server back up",
"Плановый бэкап пропущен: выполняется другая задача": "Scheduled backup skipped: another task is running",
"Мир ещё не создан — архивирую только конфиги": "The world does not exist yet — archiving the configs only",
"Останавливаю сервер командой quit...": "Stopping the server with the quit command...",
"Сервер не ответил на quit — отправляю SIGTERM": "The server did not answer quit — sending SIGTERM",
"Сервер завис — отправляю SIGKILL": "The server hung — sending SIGKILL",
"Сервер не сообщил о готовности — считаю его запущенным": "The server did not report that it is ready — treating it as running",
"в архиве нет серверных файлов Project Zomboid": "the archive has no Project Zomboid server files",
"распакованный архив слишком велик": "the unpacked archive is too large",
"файл не выбран": "no file selected",
"ожидается ZIP-архив пакета настроек": "a ZIP package of settings is expected",
"в архиве несколько наборов настроек — выберите один": "the archive holds several sets of settings — pick one",
"Автоперезапуск отменён": "Automatic restart cancelled",
"Посмотрите ошибку выше и запустите сервер вручную.": "Check the error above and start the server manually.",
"Запускаю обновление — оно идёт отдельной службой и переживёт перезапуск панели": "Starting the update — it runs as a separate service and survives the panel restart",
"Подробности: journalctl -u pzmanager-update -f": "Details: journalctl -u pzmanager-update -f",
"Перезапускаю панель": "Restarting the panel",
"обновлением": "the update",
"перезапуском": "the restart",
}
var formats = [][2]string{
// --- Ошибки API ---
{"запрос без заголовка %s", "request without the %s header"},
{"некорректный JSON: %s", "malformed JSON: %s"},
{"конфиг сервера недоступен: %s", "the server config is unavailable: %s"},
{"настройки песочницы недоступны: %s", "the sandbox settings are unavailable: %s"},
// --- Профили ---
{"профиль %s не найден", "profile %s not found"},
{"профиль %s уже существует", "profile %s already exists"},
{"профиль-источник %s не найден", "source profile %s not found"},
{"идентификатор %s недопустим: разрешены латинские буквы, цифры, дефис и подчёркивание (до 32 символов)",
"identifier %s is not allowed: use Latin letters, digits, hyphen and underscore (up to 32 characters)"},
{"у профиля %s ещё нет файлов настроек — сначала запустите его хотя бы раз",
"profile %s has no config files yet — start it at least once first"},
{"скопировать настройки: %s", "copy the settings: %s"},
// --- Память JVM ---
{"объём памяти должен выглядеть как 4g или 8192m, получено %s",
"the memory size must look like 4g or 8192m, got %s"},
{"не разобран объём памяти %s", "could not parse the memory size %s"},
{"начальный размер памяти (%s) больше максимального (%s)",
"the initial memory size (%s) is larger than the maximum (%s)"},
{"начальный размер кучи (%s) больше максимального (%s)",
"the initial heap size (%s) is larger than the maximum (%s)"},
// --- Бэкапы ---
{"недопустимое имя архива: %s", "invalid archive name: %s"},
{"небезопасный путь в архиве: %s", "unsafe path inside the archive: %s"},
{"абсолютный путь в архиве: %s", "absolute path inside the archive: %s"},
{"архив повреждён: %s", "the archive is damaged: %s"},
{"страховочный бэкап не создан, восстановление отменено: %s",
"the safety backup failed, the restore was cancelled: %s"},
// --- Steam и моды ---
{"Steam недоступен: %s", "Steam is unavailable: %s"},
{"Steam ответил %s", "Steam answered %s"},
{"ответ Steam не разобран: %s", "the Steam answer could not be parsed: %s"},
{"коллекция %s не найдена", "collection %s not found"},
{"коллекция %s недоступна — проверьте ссылку и что она открыта всем",
"collection %s is unavailable — check the link and that it is public"},
{"в коллекции %s нет модов", "collection %s has no mods"},
// --- Конфиги ---
{"параметр %s не найден в SandboxVars", "setting %s not found in SandboxVars"},
{"недопустимое значение для %s", "invalid value for %s"},
{"не удалось разобрать строку параметра %s", "could not parse the line of setting %s"},
{"прочитать конфиг %s: %s", "read the config %s: %s"},
{"создать конфиг %s: %s", "create the config %s: %s"},
{"обновить конфиг %s: %s", "update the config %s: %s"},
{"разобрать конфиг %s: %s", "parse the config %s: %s"},
{"прочитать %s: %s", "read %s: %s"},
{"записать %s: %s", "write %s: %s"},
{"создать %s: %s", "create %s: %s"},
{"разобрать %s: %s", "parse %s: %s"},
{"запустить %s: %s", "start %s: %s"},
{"запись в консоль: %s", "write to the console: %s"},
{"не разобрана длительность %s: %s", "could not parse the duration %s: %s"},
{"скачать SteamCMD: %s", "download SteamCMD: %s"},
// --- Имена задач ---
{"Резервное копирование мира: %s", "World backup: %s"},
{"Плановое резервное копирование: %s", "Scheduled world backup: %s"},
{"Восстановление из архива %s", "Restore from the archive %s"},
// --- Сообщения в консоли панели ---
{"Конфиг сервера сохранён (изменений: %s). Изменения вступят в силу после перезапуска.",
"Server config saved (changes: %s). They take effect after a restart."},
{"Создан профиль %s", "Profile %s created"},
{"Настройки профиля %s скопированы в %s", "The settings of profile %s were copied to %s"},
{"Активный профиль: %s", "Active profile: %s"},
{"Профиль %s удалён из панели. Мир и конфиги остались на диске: %s",
"Profile %s removed from the panel. Its world and configs stayed on disk: %s"},
{"Запуск профиля %s: %s %s (pid %s)", "Starting profile %s: %s %s (pid %s)"},
{"Запускаю: %s", "Running: %s"},
{"Сервер остановлен: %s", "Server stopped: %s"},
{"Автоперезапуск через %s (можно отменить кнопкой «Остановить»)",
"Automatic restart in %s (the Stop button cancels it)"},
{"Автоперезапуск не удался: %s", "Automatic restart failed: %s"},
{"Сервер падает сразу после запуска %s раза подряд — автоперезапуск остановлен. ",
"The server has crashed right after start %s times in a row — automatic restart is off. "},
{"Не удалось выставить границы памяти JVM: %s", "Could not set the JVM memory limits: %s"},
{"Не удалось выставить объём памяти JVM: %s", "Could not set the JVM memory size: %s"},
{"Память JVM: от %s до %s", "JVM memory: from %s to %s"},
{"Лимит памяти JVM выставлен: %s", "JVM memory limit set: %s"},
{"Не удалось отправить quit: %s", "Could not send quit: %s"},
{"SIGTERM не доставлен: %s", "SIGTERM was not delivered: %s"},
{"Остановка не удалась: %s", "Stopping failed: %s"},
{"Остановить сервер не удалось: %s", "The server could not be stopped: %s"},
{"Перезапуск не удался: %s", "Restart failed: %s"},
{"Не удалось запустить сервер: %s", "Could not start the server: %s"},
{"Останавливаю игровой сервер перед %s", "Stopping the game server before %s"},
{"Плановый бэкап не запущен: %s", "The scheduled backup did not start: %s"},
// --- Импорт пресетов ---
{"архив не читается: %s", "the archive cannot be read: %s"},
{"в архиве слишком много файлов: %s", "the archive has too many files: %s"},
{"файл %s слишком велик", "the file %s is too large"},
{"файл не принят: %s", "the file was not accepted: %s"},
{"файл не прочитан: %s", "the file was not read: %s"},
{"набор %s не найден в архиве", "the set %s was not found in the archive"},
{"Импортирован пресет %s в профиль %s (модов: %s)",
"Preset %s imported into the profile %s (mods: %s)"},
// --- Бэкапы: ход работы ---
{"Создаю архив %s (профиль %s)", "Creating the archive %s (profile %s)"},
{"Архив готов: %s (%s, файлов: %s)", "Archive ready: %s (%s, files: %s)"},
{"Восстанавливаю %s в %s", "Restoring %s into %s"},
{"Восстановлено файлов: %s", "Files restored: %s"},
{"Удалён старый архив %s", "Old archive %s deleted"},
{"Ротация не удалась: %s", "Rotation failed: %s"},
{"Пропускаю %s: %s", "Skipping %s: %s"},
{"Не прочитан %s: %s", "Not read %s: %s"},
// --- SteamCMD ---
{"SteamCMD найден: %s", "SteamCMD found: %s"},
{"SteamCMD не найден, скачиваю в %s", "SteamCMD not found, downloading into %s"},
{"SteamCMD установлен: %s", "SteamCMD installed: %s"},
}
+152
View File
@@ -0,0 +1,152 @@
// Package i18n переводит сообщения менеджера на язык веб-панели.
//
// Исходный язык кода — русский, он же служит ключом перевода: словарь связывает
// русскую фразу с английской, а незнакомая фраза остаётся как есть. Благодаря
// этому через перевод можно безопасно пропускать и вывод игрового сервера — он
// английский и в словаре не встретится.
package i18n
import (
"fmt"
"net/http"
"regexp"
"sort"
"strings"
)
// Lang — язык сообщений панели.
type Lang string
const (
RU Lang = "ru"
EN Lang = "en"
// Default — язык, на котором сообщения написаны в коде.
Default = RU
)
// CookieName — кука, которой панель сообщает выбранный человеком язык.
const CookieName = "pzm_lang"
// Parse разбирает код языка; для незнакомого возвращает язык по умолчанию.
func Parse(value string) (Lang, bool) {
switch strings.ToLower(strings.TrimSpace(value)) {
case "ru":
return RU, true
case "en":
return EN, true
}
return Default, false
}
// FromRequest определяет язык ответа. Выбор человека (кука, которую ставит
// панель) важнее списка языков браузера: на сервер могут заходить с чужой
// машины, а язык панели человек выбирает сам.
func FromRequest(r *http.Request) Lang {
if r == nil {
return Default
}
if cookie, err := r.Cookie(CookieName); err == nil {
if lang, ok := Parse(cookie.Value); ok {
return lang
}
}
return fromAcceptLanguage(r.Header.Get("Accept-Language"))
}
// fromAcceptLanguage берёт первый понятный язык из заголовка. Веса (q=) не
// разбираем: браузеры и так перечисляют языки по убыванию предпочтения.
func fromAcceptLanguage(header string) Lang {
for _, part := range strings.Split(header, ",") {
tag := strings.TrimSpace(part)
if i := strings.IndexByte(tag, ';'); i >= 0 {
tag = tag[:i]
}
if i := strings.IndexByte(tag, '-'); i >= 0 {
tag = tag[:i]
}
if lang, ok := Parse(tag); ok {
return lang
}
}
return Default
}
// T переводит сообщение на указанный язык. Неизвестное сообщение возвращается
// без изменений: потерять текст хуже, чем показать его на чужом языке.
func T(lang Lang, message string) string {
if lang == Default || lang == "" || message == "" {
return message
}
return translate(message, 0)
}
// maxDepth ограничивает разбор вложенных ошибок: «прочитать X: создать Y: ...».
const maxDepth = 4
func translate(message string, depth int) string {
if text, ok := messages[message]; ok {
return text
}
if depth >= maxDepth {
return message
}
for _, p := range patterns {
match := p.re.FindStringSubmatch(message)
if match == nil {
continue
}
// Подставленные значения переводим тоже: в них попадает вложенная
// ошибка целиком, и она может быть знакома словарю.
args := make([]any, 0, len(match)-1)
for _, group := range match[1:] {
args = append(args, translate(group, depth+1))
}
return fmt.Sprintf(p.en, args...)
}
return message
}
// pattern — пара форматов «русский → английский». Значения, подставленные в
// сообщение при его сборке, вылавливаются группами регулярного выражения.
type pattern struct {
re *regexp.Regexp
en string
// weight — длина неизменяемой части. Чем она больше, тем конкретнее
// шаблон, и тем раньше его стоит примерить.
weight int
}
var patterns []pattern
func init() {
patterns = make([]pattern, 0, len(formats))
for _, f := range formats {
patterns = append(patterns, compile(f[0], f[1]))
}
sort.SliceStable(patterns, func(i, j int) bool {
return patterns[i].weight > patterns[j].weight
})
}
func compile(ru, en string) pattern {
parts := strings.Split(ru, "%s")
weight := 0
for _, part := range parts {
weight += len(part)
}
var body strings.Builder
body.WriteString(regexp.QuoteMeta(parts[0]))
for i := 1; i < len(parts); i++ {
// Последняя группа жадная: в неё попадает вложенная ошибка целиком,
// вместе со своими двоеточиями.
group := "(.+?)"
if i == len(parts)-1 && parts[i] == "" {
group = "(.+)"
}
body.WriteString(group)
body.WriteString(regexp.QuoteMeta(parts[i]))
}
// (?s) — сообщения бывают многострочными.
return pattern{re: regexp.MustCompile("(?s)^" + body.String() + "$"), en: en, weight: weight}
}
+104
View File
@@ -0,0 +1,104 @@
package i18n
import (
"net/http"
"strings"
"testing"
)
func TestTKnownMessage(t *testing.T) {
got := T(EN, "сервер не запущен")
if got != "the server is not running" {
t.Fatalf("T(EN, ...) = %q", got)
}
if got := T(RU, "сервер не запущен"); got != "сервер не запущен" {
t.Fatalf("русский язык не должен трогать сообщение: %q", got)
}
}
// Вывод игрового сервера проходит через перевод как есть: словарь его не знает.
func TestTKeepsUnknown(t *testing.T) {
line := "LOG : General f:1 Zombies spawned: 1000"
if got := T(EN, line); got != line {
t.Fatalf("незнакомая строка изменена: %q", got)
}
}
func TestTFormat(t *testing.T) {
got := T(EN, `профиль "modded" не найден`)
if got != `profile "modded" not found` {
t.Fatalf("T = %q", got)
}
}
// Вложенная ошибка переводится вместе с обёрткой, а более конкретный шаблон
// («прочитать конфиг») должен выиграть у общего («прочитать»).
func TestTNestedError(t *testing.T) {
msg := "конфиг сервера недоступен: прочитать конфиг /srv/servertest.ini: open: no such file"
want := "the server config is unavailable: read the config /srv/servertest.ini: open: no such file"
if got := T(EN, msg); got != want {
t.Fatalf("T = %q, ожидалось %q", got, want)
}
}
func TestTTaskName(t *testing.T) {
if got := T(EN, "Резервное копирование мира: modded"); got != "World backup: modded" {
t.Fatalf("T = %q", got)
}
}
// В переводе должно быть столько же подстановок, сколько в оригинале, иначе
// Sprintf выведет %!s(MISSING) прямо в панель.
func TestCatalogPlaceholders(t *testing.T) {
for _, f := range formats {
ru := strings.Count(f[0], "%s")
en := strings.Count(f[1], "%s")
if ru == 0 {
t.Errorf("шаблон без подстановки: %q", f[0])
}
if ru != en {
t.Errorf("%q: подстановок %d, в переводе %d", f[0], ru, en)
}
if strings.ContainsAny(strings.ReplaceAll(f[0], "%s", ""), "%") {
t.Errorf("в шаблоне остался другой глагол форматирования: %q", f[0])
}
}
for ru, en := range messages {
if strings.Contains(ru, "%") || strings.Contains(en, "%") {
t.Errorf("сообщение с подстановкой должно лежать в formats: %q", ru)
}
}
}
func TestFromRequest(t *testing.T) {
cases := []struct {
name string
cookie string
header string
want Lang
}{
{"по умолчанию", "", "", Default},
{"выбор человека", "en", "ru-RU,ru;q=0.9", EN},
{"мусор в куке", "klingon", "en-US,en;q=0.9", EN},
{"язык браузера", "", "en-GB,en;q=0.9", EN},
{"неизвестный язык браузера", "", "de-DE,de;q=0.9", Default},
{"первый понятный из списка", "", "de-DE;q=0.9,en;q=0.8", EN},
}
for _, c := range cases {
t.Run(c.name, func(t *testing.T) {
r, err := http.NewRequest(http.MethodGet, "/api/status", nil)
if err != nil {
t.Fatal(err)
}
if c.cookie != "" {
r.AddCookie(&http.Cookie{Name: CookieName, Value: c.cookie})
}
if c.header != "" {
r.Header.Set("Accept-Language", c.header)
}
if got := FromRequest(r); got != c.want {
t.Fatalf("FromRequest = %q, ожидалось %q", got, c.want)
}
})
}
}
+225
View File
@@ -0,0 +1,225 @@
// Package preset разбирает пакеты настроек, которые раздают сборки модов.
//
// Сборка обычно приходит одним архивом с папкой Server внутри: там лежат
// готовый .ini со списком модов, настройки песочницы и точки появления. Всё
// остальное в архиве (файлы одиночной игры, картинки, changelog) менеджеру
// не нужно и молча пропускается.
package preset
import (
"archive/zip"
"bytes"
"errors"
"fmt"
"io"
"path"
"sort"
"strings"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
)
// Пределы разбора. Архив приходит от человека, но верить ему нельзя: без
// ограничений маленький файл разворачивается в гигабайты.
const (
// MaxArchiveSize — предел на сам загружаемый файл.
MaxArchiveSize = 32 << 20
maxFileSize = 16 << 20
maxTotalSize = 64 << 20
maxEntries = 10000
)
// ErrNoServerFiles возвращается, когда в архиве нет ни одного серверного файла.
var ErrNoServerFiles = errors.New("в архиве нет серверных файлов Project Zomboid")
// Files — серверная часть пакета: то, что PZ читает при запуске.
type Files struct {
// Name — имя, под которым файлы лежали в архиве (sophie-server-42-2).
Name string
INI []byte
Sandbox []byte
SpawnRegions []byte
}
// Summary — то, что панель показывает до импорта, чтобы человек понимал, что
// именно он собирается записать поверх своих настроек.
type Summary struct {
Name string `json:"name"`
ServerName string `json:"server_name"`
Maps []string `json:"maps"`
Mods int `json:"mods"`
WorkshopItems int `json:"workshop_items"`
Settings int `json:"settings"`
SandboxSettings int `json:"sandbox_settings"`
HasINI bool `json:"has_ini"`
HasSandbox bool `json:"has_sandbox"`
HasSpawnRegions bool `json:"has_spawn_regions"`
}
// markers — параметры, по которым .ini опознаётся как конфиг сервера. В
// архивах сборок хватает и других .ini (настройки модов, например), и брать
// их за конфиг нельзя.
var markers = []string{
"PublicName", "PublicDescription", "DefaultPort", "UDPPort", "MaxPlayers",
"Mods", "WorkshopItems", "Map", "PVP", "Open", "RCONPort", "ServerWelcomeMessage",
"SaveWorldEveryMinutes", "SpawnPoint",
}
const markersRequired = 3
// FromZip достаёт из архива все наборы серверных файлов. Наборов может быть
// несколько: сборки иногда кладут рядом варианты конфигов.
func FromZip(data []byte) ([]Files, error) {
reader, err := zip.NewReader(bytes.NewReader(data), int64(len(data)))
if err != nil {
return nil, fmt.Errorf("архив не читается: %w", err)
}
if len(reader.File) > maxEntries {
return nil, fmt.Errorf("в архиве слишком много файлов: %d", len(reader.File))
}
sets := map[string]*Files{}
total := 0
for _, entry := range reader.File {
if entry.FileInfo().IsDir() {
continue
}
name := path.Base(strings.ReplaceAll(entry.Name, "\\", "/"))
base, kind := classify(name)
if kind == kindOther {
continue
}
if entry.UncompressedSize64 > maxFileSize {
continue
}
if total+int(entry.UncompressedSize64) > maxTotalSize {
return nil, errors.New("распакованный архив слишком велик")
}
content, err := readEntry(entry)
if err != nil {
return nil, err
}
total += len(content)
if kind == kindINI && !looksLikeServerConfig(content) {
continue
}
set := sets[base]
if set == nil {
set = &Files{Name: base}
sets[base] = set
}
switch kind {
case kindINI:
set.INI = content
case kindSandbox:
set.Sandbox = content
case kindSpawnRegions:
set.SpawnRegions = content
}
}
out := make([]Files, 0, len(sets))
for _, set := range sets {
// Одни точки появления без конфига и песочницы импортировать некуда.
if set.INI == nil && set.Sandbox == nil {
continue
}
out = append(out, *set)
}
if len(out) == 0 {
return nil, ErrNoServerFiles
}
sort.Slice(out, func(i, j int) bool { return out[i].Name < out[j].Name })
return out, nil
}
type kind int
const (
kindOther kind = iota
kindINI
kindSandbox
kindSpawnRegions
)
// classify определяет по имени файла, часть какого набора перед нами.
func classify(name string) (string, kind) {
lower := strings.ToLower(name)
switch {
case strings.HasSuffix(lower, "_sandboxvars.lua"):
return name[:len(name)-len("_SandboxVars.lua")], kindSandbox
case strings.HasSuffix(lower, "_spawnregions.lua"):
return name[:len(name)-len("_spawnregions.lua")], kindSpawnRegions
case strings.HasSuffix(lower, ".ini"):
return name[:len(name)-len(".ini")], kindINI
}
return "", kindOther
}
// looksLikeServerConfig отличает конфиг сервера от постороннего .ini.
func looksLikeServerConfig(data []byte) bool {
ini := pzconfig.ParseINI(data)
found := 0
for _, key := range markers {
if ini.Has(key) {
found++
}
}
return found >= markersRequired
}
func readEntry(entry *zip.File) ([]byte, error) {
rc, err := entry.Open()
if err != nil {
return nil, fmt.Errorf("прочитать %s: %w", entry.Name, err)
}
defer rc.Close()
// Заявленный размер может врать, поэтому читаем с запасом в один байт и
// проверяем, что файл на нём кончился.
content, err := io.ReadAll(io.LimitReader(rc, maxFileSize+1))
if err != nil {
return nil, fmt.Errorf("прочитать %s: %w", entry.Name, err)
}
if len(content) > maxFileSize {
return nil, fmt.Errorf("файл %s слишком велик", entry.Name)
}
return content, nil
}
// Describe собирает сводку по набору: сколько модов, карт и параметров.
func (f Files) Describe() Summary {
s := Summary{
Name: f.Name,
HasINI: f.INI != nil,
HasSandbox: f.Sandbox != nil,
HasSpawnRegions: f.SpawnRegions != nil,
Maps: []string{},
}
if f.INI != nil {
ini := pzconfig.ParseINI(f.INI)
s.ServerName = ini.Get("PublicName")
s.Mods = len(splitList(ini.Get("Mods")))
s.WorkshopItems = len(splitList(ini.Get("WorkshopItems")))
s.Maps = splitList(ini.Get("Map"))
s.Settings = len(ini.Keys())
}
if f.Sandbox != nil {
s.SandboxSettings = len(pzconfig.ParseSandbox(f.Sandbox).Entries())
}
return s
}
// splitList разбирает перечисления PZ: значения через точку с запятой.
func splitList(value string) []string {
out := []string{}
for _, part := range strings.Split(value, ";") {
if part = strings.TrimSpace(part); part != "" {
out = append(out, part)
}
}
return out
}
+194
View File
@@ -0,0 +1,194 @@
package preset
import (
"archive/zip"
"bytes"
"errors"
"strings"
"testing"
)
// serverINI — сокращённый конфиг сервера: маркеров хватает, чтобы отличить его
// от постороннего .ini.
const serverINI = `PublicName=Sophie Server
PublicDescription=Vanilla++
DefaultPort=16261
MaxPlayers=32
PVP=true
Map=Brandenburg, KY;Muldraugh, KY
Mods=SophieCore;SophieExtras
WorkshopItems=3773856464;2392709985
`
const sandboxLua = `SandboxVars = {
VERSION = 5,
Zombies = 3,
ZombieLore = {
Speed = 2,
},
}
`
const spawnRegions = `function SpawnRegions()
return { { name = "Muldraugh,KY", file = "media/maps/Muldraugh, KY/spawnpoints.lua" } }
end
`
func buildZip(t *testing.T, files map[string]string) []byte {
t.Helper()
var buf bytes.Buffer
w := zip.NewWriter(&buf)
for name, content := range files {
f, err := w.Create(name)
if err != nil {
t.Fatal(err)
}
if _, err := f.Write([]byte(content)); err != nil {
t.Fatal(err)
}
}
if err := w.Close(); err != nil {
t.Fatal(err)
}
return buf.Bytes()
}
// Пакет сборки — это архив пользовательской папки Zomboid: серверные файлы в
// нём лежат вперемешку с тем, что нужно только одиночной игре.
func TestFromZipPack(t *testing.T) {
data := buildZip(t, map[string]string{
"readme.txt": "put these folders...",
"changelog.txt": "v2",
"THIS IS WHERE TO PUT THESE FOLDERS.png": "\x89PNG fake",
"Lua/ModOptions.ini": "[SomeMod]\nenabled=true\n",
"Lua/ModFolders.cfg": "folders",
"Sandbox Presets/Sophie-42.cfg": "Version=6\nZombies=4\n",
"Server/sophie-42.ini": serverINI,
"Server/sophie-42_SandboxVars.lua": sandboxLua,
"Server/sophie-42_spawnregions.lua": spawnRegions,
})
sets, err := FromZip(data)
if err != nil {
t.Fatal(err)
}
if len(sets) != 1 {
names := []string{}
for _, s := range sets {
names = append(names, s.Name)
}
t.Fatalf("наборов: %d (%s), ожидался один", len(sets), strings.Join(names, ", "))
}
set := sets[0]
if set.Name != "sophie-42" {
t.Errorf("имя набора = %q", set.Name)
}
if set.INI == nil || set.Sandbox == nil || set.SpawnRegions == nil {
t.Fatalf("не все файлы найдены: ini=%v sandbox=%v spawn=%v",
set.INI != nil, set.Sandbox != nil, set.SpawnRegions != nil)
}
got := set.Describe()
if got.ServerName != "Sophie Server" {
t.Errorf("имя сервера = %q", got.ServerName)
}
if got.Mods != 2 || got.WorkshopItems != 2 {
t.Errorf("модов %d, пакетов мастерской %d", got.Mods, got.WorkshopItems)
}
if len(got.Maps) != 2 || got.Maps[0] != "Brandenburg, KY" {
t.Errorf("карты = %v", got.Maps)
}
if got.SandboxSettings == 0 {
t.Error("параметры песочницы не посчитаны")
}
if !got.HasSpawnRegions {
t.Error("точки появления не найдены")
}
}
// Настройки мода лежат в таком же .ini, и принимать их за конфиг сервера
// нельзя: импорт затёр бы настоящий конфиг мусором.
func TestFromZipIgnoresForeignINI(t *testing.T) {
data := buildZip(t, map[string]string{
"Lua/ModOptions.ini": "[SomeMod]\nenabled=true\nPVP=true\n",
"notes.txt": "hi",
})
if _, err := FromZip(data); !errors.Is(err, ErrNoServerFiles) {
t.Fatalf("ожидалась ErrNoServerFiles, получено %v", err)
}
}
// Файлы могут лежать в корне архива или в папке с другим именем — важен
// только их суффикс.
func TestFromZipFlatLayout(t *testing.T) {
data := buildZip(t, map[string]string{
"my-server.ini": serverINI,
"configs/my-server_SandboxVars.lua": sandboxLua,
})
sets, err := FromZip(data)
if err != nil {
t.Fatal(err)
}
if len(sets) != 1 || sets[0].Name != "my-server" {
t.Fatalf("наборы = %+v", sets)
}
if sets[0].Sandbox == nil {
t.Error("песочница из другой папки не подхвачена")
}
}
// Несколько вариантов конфигов в одном архиве — человек выбирает сам, поэтому
// набора должно быть два, а не один слипшийся.
func TestFromZipSeveralSets(t *testing.T) {
data := buildZip(t, map[string]string{
"Server/pvp.ini": serverINI,
"Server/pvp_SandboxVars.lua": sandboxLua,
"Server/pve.ini": serverINI,
"Server/pve_SandboxVars.lua": sandboxLua,
"Server/pve_spawnregions.lua": spawnRegions,
})
sets, err := FromZip(data)
if err != nil {
t.Fatal(err)
}
if len(sets) != 2 {
t.Fatalf("наборов: %d", len(sets))
}
// Порядок задан именами: панель показывает их списком.
if sets[0].Name != "pve" || sets[1].Name != "pvp" {
t.Fatalf("порядок наборов: %q, %q", sets[0].Name, sets[1].Name)
}
}
// Одни точки появления импортировать некуда.
func TestFromZipSpawnRegionsAlone(t *testing.T) {
data := buildZip(t, map[string]string{"Server/x_spawnregions.lua": spawnRegions})
if _, err := FromZip(data); !errors.Is(err, ErrNoServerFiles) {
t.Fatalf("ожидалась ErrNoServerFiles, получено %v", err)
}
}
// Имя файла из архива в путь не превращается: берём только последний сегмент,
// поэтому «../» из имени записи никуда не ведёт.
func TestFromZipIgnoresPaths(t *testing.T) {
data := buildZip(t, map[string]string{
"../../../etc/evil.ini": serverINI,
"..\\..\\windows\\evil_SandboxVars.lua": sandboxLua,
})
sets, err := FromZip(data)
if err != nil {
t.Fatal(err)
}
for _, set := range sets {
if strings.ContainsAny(set.Name, `/\.`) {
t.Errorf("в имени набора остался путь: %q", set.Name)
}
}
}
func TestFromZipRejectsGarbage(t *testing.T) {
if _, err := FromZip([]byte("это не архив")); err == nil {
t.Fatal("мусор принят за архив")
}
}
+58 -4
View File
@@ -16,6 +16,10 @@ type iniLine struct {
Key string
Value string
Raw string
// Comment — описание параметра: строки комментария прямо перед ним.
// Project Zomboid пишет их на языке сервера, так что панели есть что
// показать человеку, не выдумывая своих формулировок.
Comment string
}
// INI — конфиг PZ в виде плоских key=value. Разбор сохраняет исходный порядок
@@ -23,22 +27,46 @@ type iniLine struct {
type INI struct {
lines []iniLine
index map[string]int
// crlf — файл был с виндовыми переводами строк. Сохраняем как было: иначе
// правка одного параметра переписывает весь файл целиком.
crlf bool
}
// ParseINI разбирает содержимое конфига.
func ParseINI(data []byte) *INI {
ini := &INI{index: make(map[string]int)}
text := strings.ReplaceAll(string(data), "\r\n", "\n")
raw := string(data)
ini.crlf = strings.Contains(raw, "\r\n")
text := strings.ReplaceAll(raw, "\r\n", "\n")
// Комментарии копим до ближайшего параметра: в конфигах PZ описание стоит
// строкой выше. Пустая строка обрывает связь — иначе описание прилипло бы
// к следующему блоку.
var comment []string
for _, raw := range strings.Split(text, "\n") {
trimmed := strings.TrimSpace(raw)
key, value, found := strings.Cut(raw, "=")
if !found || trimmed == "" || strings.HasPrefix(trimmed, "#") {
if strings.HasPrefix(trimmed, "#") {
comment = append(comment, strings.TrimSpace(strings.TrimPrefix(trimmed, "#")))
ini.lines = append(ini.lines, iniLine{Raw: raw})
continue
}
if !found || trimmed == "" {
comment = nil
ini.lines = append(ini.lines, iniLine{Raw: raw})
continue
}
key = strings.TrimSpace(key)
ini.index[key] = len(ini.lines)
ini.lines = append(ini.lines, iniLine{Key: key, Value: strings.TrimSpace(value)})
ini.lines = append(ini.lines, iniLine{
Key: key,
Value: strings.TrimSpace(value),
Comment: strings.Join(comment, " "),
})
comment = nil
}
return ini
}
@@ -90,6 +118,17 @@ func (i *INI) Keys() []string {
return out
}
// Comments возвращает описания параметров: ключ -> текст комментария.
func (i *INI) Comments() map[string]string {
out := make(map[string]string, len(i.index))
for _, l := range i.lines {
if l.Key != "" && l.Comment != "" {
out[l.Key] = l.Comment
}
}
return out
}
// Map отдаёт все параметры в виде словаря.
func (i *INI) Map() map[string]string {
out := make(map[string]string, len(i.index))
@@ -103,6 +142,11 @@ func (i *INI) Map() map[string]string {
// Render собирает файл обратно в текст.
func (i *INI) Render() []byte {
newline := "\n"
if i.crlf {
newline = "\r\n"
}
var buf bytes.Buffer
for n, l := range i.lines {
if l.Key == "" {
@@ -113,7 +157,7 @@ func (i *INI) Render() []byte {
buf.WriteString(l.Value)
}
if n < len(i.lines)-1 {
buf.WriteByte('\n')
buf.WriteString(newline)
}
}
return buf.Bytes()
@@ -128,6 +172,16 @@ func SaveINI(path string, ini *INI) error {
return writeAtomic(path, ini.Render(), 0o644)
}
// SaveRaw кладёт на место файл, который менеджер не разбирает (настройки
// песочницы и точки появления из пакета сборки), с той же страховкой: копия
// прежней версии рядом и атомарная замена.
func SaveRaw(path string, data []byte) error {
if err := backupFile(path); err != nil {
return err
}
return writeAtomic(path, data, 0o644)
}
func backupFile(path string) error {
data, err := os.ReadFile(path)
if os.IsNotExist(err) {
+63 -13
View File
@@ -6,24 +6,71 @@ import (
"os"
"path/filepath"
"regexp"
"strconv"
"strings"
)
// javaLauncherFile — файл, из которого сервер берёт аргументы JVM.
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. Именно
// оттуда start-server.sh берёт -Xmx, поэтому менять размер памяти в аргументах
// запуска бесполезно.
func SetJavaMemory(serverDir, memory string) error {
memory = strings.TrimSpace(memory)
if memory == "" {
// ParseMemory переводит запись вида "4g" в байты. Возвращает 0, если строка
// пустая, и ошибку, если формат непонятен.
func ParseMemory(value string) (int64, error) {
value = strings.TrimSpace(value)
if value == "" {
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
}
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)
@@ -41,14 +88,17 @@ func SetJavaMemory(serverDir, memory string) error {
args, _ := doc["vmArgs"].([]any)
updated := make([]any, 0, len(args)+2)
for _, a := range args {
if str, ok := a.(string); ok && xmxRe.MatchString(str) {
if str, ok := a.(string); ok && heapArgRe.MatchString(str) {
continue
}
updated = append(updated, a)
}
// -Xms равным -Xmx: JVM сразу забирает память и не тратит время на рост
// кучи в момент, когда на сервере много игроков.
updated = append(updated, "-Xms"+memory, "-Xmx"+memory)
if minMemory != "" {
updated = append(updated, "-Xms"+minMemory)
}
if maxMemory != "" {
updated = append(updated, "-Xmx"+maxMemory)
}
doc["vmArgs"] = updated
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("значение с кириллицей принято")
}
}
+31
View File
@@ -154,3 +154,34 @@ func TestSandboxEntriesFollowFileOrder(t *testing.T) {
}
}
}
// TestKeepsWindowsLineEndings: конфиги, созданные игрой на Windows, приходят с
// CRLF. Если при сохранении переписать их в LF, изменится каждая строка файла —
// правка одного параметра превратится в полную перезапись.
func TestKeepsWindowsLineEndings(t *testing.T) {
ini := ParseINI([]byte("# Комментарий\r\nMaxPlayers=32\r\nPVP=true\r\n"))
ini.Set("MaxPlayers", "64")
got := string(ini.Render())
if strings.Count(got, "\r\n") != 3 {
t.Errorf("переводы строк не сохранены:\n%q", got)
}
if strings.Contains(strings.ReplaceAll(got, "\r\n", ""), "\n") {
t.Errorf("в файле появились одиночные LF:\n%q", got)
}
// Файл с LF таким и остаётся.
unix := ParseINI([]byte("MaxPlayers=32\nPVP=true"))
unix.Set("PVP", "false")
if strings.Contains(string(unix.Render()), "\r") {
t.Error("в файл с LF добавились CR")
}
sandbox := ParseSandbox([]byte("SandboxVars = {\r\n Zombies = 3,\r\n}\r\n"))
if err := sandbox.Set("Zombies", "1"); err != nil {
t.Fatal(err)
}
if strings.Count(string(sandbox.Render()), "\r\n") != 3 {
t.Errorf("песочница потеряла CRLF:\n%q", string(sandbox.Render()))
}
}
+36 -5
View File
@@ -13,6 +13,9 @@ import (
type SandboxEntry struct {
Path string `json:"path"`
Value string `json:"value"`
// Comment — строки "--" перед параметром: игра расписывает там смысл
// значения и расшифровку вариантов.
Comment string `json:"comment,omitempty"`
}
// Sandbox — разбор <server>_SandboxVars.lua. Файл генерируется игрой и имеет
@@ -24,6 +27,10 @@ type Sandbox struct {
lines []string
// index сопоставляет путь параметра с номером строки.
index map[string]int
// comments хранит описание параметра по его пути.
comments map[string]string
// crlf — файл был с виндовыми переводами строк; сохраняем как было.
crlf bool
}
var (
@@ -33,14 +40,24 @@ var (
// ParseSandbox разбирает содержимое SandboxVars.lua.
func ParseSandbox(data []byte) *Sandbox {
s := &Sandbox{index: make(map[string]int)}
text := strings.ReplaceAll(string(data), "\r\n", "\n")
s := &Sandbox{index: make(map[string]int), comments: make(map[string]string)}
raw := string(data)
s.crlf = strings.Contains(raw, "\r\n")
text := strings.ReplaceAll(raw, "\r\n", "\n")
s.lines = strings.Split(text, "\n")
var stack []string
// Комментарии копим до ближайшего параметра, как и в .ini.
var comment []string
for n, line := range s.lines {
trimmed := strings.TrimSpace(line)
if trimmed == "" || strings.HasPrefix(trimmed, "--") {
if strings.HasPrefix(trimmed, "--") {
comment = append(comment, strings.TrimSpace(strings.TrimPrefix(trimmed, "--")))
continue
}
if trimmed == "" {
comment = nil
continue
}
if sandboxCloseRe.MatchString(line) {
@@ -62,6 +79,7 @@ func ParseSandbox(data []byte) *Sandbox {
} else {
stack = stack[:0]
}
comment = nil
continue
}
path := name
@@ -69,6 +87,10 @@ func ParseSandbox(data []byte) *Sandbox {
path = strings.Join(stack, ".") + "." + name
}
s.index[path] = n
if len(comment) > 0 {
s.comments[path] = strings.Join(comment, " ")
}
comment = nil
}
return s
}
@@ -95,7 +117,11 @@ func (s *Sandbox) Entries() []SandboxEntry {
if !ok {
continue
}
out = append(out, SandboxEntry{Path: path, Value: s.valueAt(n)})
out = append(out, SandboxEntry{
Path: path,
Value: s.valueAt(n),
Comment: s.comments[path],
})
}
return out
}
@@ -139,11 +165,16 @@ func (s *Sandbox) Set(path, value string) error {
// Render собирает файл обратно.
func (s *Sandbox) Render() []byte {
newline := "\n"
if s.crlf {
newline = "\r\n"
}
var buf bytes.Buffer
for n, line := range s.lines {
buf.WriteString(line)
if n < len(s.lines)-1 {
buf.WriteByte('\n')
buf.WriteString(newline)
}
}
return buf.Bytes()
+19 -1
View File
@@ -1,6 +1,20 @@
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 — одна строка консоли сервера с монотонным номером, по которому
// веб-клиент понимает, что он пропустил, и откуда догружать.
@@ -33,6 +47,10 @@ func newLogBuffer(capacity int) *logBuffer {
// append кладёт строку в буфер и рассылает подписчикам.
func (b *logBuffer) append(line LogLine) {
// Чистим здесь, а не у каждого источника: через буфер проходят и вывод
// сервера, и SteamCMD, и сообщения самой панели.
line.Text = stripANSI(line.Text)
b.mu.Lock()
line.Seq = 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)
}
}
+131 -20
View File
@@ -23,10 +23,13 @@ import (
type State string
const (
StateStopped State = "stopped"
StateStarting State = "starting"
StateRunning State = "running"
StateStopping State = "stopping"
StateStopped State = "stopped"
// StateRestarting — сервер упал и ждёт автоподъёма. Отдельное состояние
// нужно, чтобы это ожидание можно было отменить кнопкой.
StateRestarting State = "restarting"
StateStarting State = "starting"
StateRunning State = "running"
StateStopping State = "stopping"
)
// Ошибки, на которые HTTP-слой отвечает осмысленным кодом.
@@ -39,23 +42,38 @@ var (
// playersPollInterval — как часто менеджер спрашивает у сервера список игроков.
const playersPollInterval = 30 * time.Second
// startupGrace — сколько ждём строку о готовности. Загрузка мира с модами
// занимает минуты, поэтому запас большой: раньше времени объявлять сервер
// работающим хуже, чем подождать.
const startupGrace = 15 * time.Minute
// restartDelay — пауза перед автоподъёмом упавшего сервера.
const restartDelay = 10 * time.Second
// Сервер, падающий сразу после старта, автоперезапуском не лечится: обычно
// это нехватка памяти или испорченный конфиг. После нескольких таких падений
// подряд перестаём поднимать его сам, чтобы не крутить бесконечный цикл.
const (
quickCrashWindow = time.Minute
maxQuickCrashes = 3
)
// Status — снимок состояния для веб-панели.
type Status struct {
State State `json:"state"`
// Profile и ProfileTitle описывают профиль, который сейчас работает
// (а если сервер остановлен — который будет запущен).
Profile string `json:"profile"`
ProfileTitle string `json:"profile_title"`
Installed bool `json:"installed"`
PID int `json:"pid"`
UptimeSec int64 `json:"uptime_sec"`
Players []string `json:"players"`
PlayersAt int64 `json:"players_at"`
LastExit string `json:"last_exit"`
AutoRestart bool `json:"auto_restart"`
Profile string `json:"profile"`
ProfileTitle string `json:"profile_title"`
Installed bool `json:"installed"`
PID int `json:"pid"`
UptimeSec int64 `json:"uptime_sec"`
Players []string `json:"players"`
PlayersAt int64 `json:"players_at"`
LastExit string `json:"last_exit"`
AutoRestart bool `json:"auto_restart"`
// RestartInSec — сколько секунд осталось до автоподъёма (0, если не ждём).
RestartInSec int64 `json:"restart_in_sec"`
Proc sysinfo.ProcStats `json:"proc"`
Host sysinfo.HostStats `json:"host"`
}
@@ -89,6 +107,13 @@ type Supervisor struct {
captured []string
autoQuery bool
// restartCancel закрывается, чтобы отменить ожидание автоперезапуска;
// restartAt — когда оно закончится.
restartCancel chan struct{}
restartAt time.Time
// crashStreak — сколько раз подряд сервер упал сразу после запуска.
crashStreak int
sampler *sysinfo.Sampler
stopOnce sync.Once
quit chan struct{}
@@ -165,9 +190,14 @@ func (s *Supervisor) Status() Status {
if s.cmd != nil && s.cmd.Process != nil {
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())
}
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()
st.Installed = s.Installed()
@@ -185,9 +215,28 @@ func (s *Supervisor) Status() Status {
func (s *Supervisor) Start() error {
s.mu.Lock()
defer s.mu.Unlock()
// Запуск руками — знак, что причину падений устранили.
s.crashStreak = 0
// Если ждали автоподъёма, поднимаем немедленно.
s.cancelRestartLocked()
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 {
if s.state != StateStopped {
return ErrAlreadyRunning
@@ -204,8 +253,8 @@ func (s *Supervisor) startLocked() error {
profile := s.cfg.ActiveProfile()
// Лимит памяти живёт в файле запуска, общем для всех профилей, поэтому
// выставляем его на каждом старте — иначе профиль унаследует чужой -Xmx.
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil {
s.AppendLog("manager", "Не удалось выставить лимит памяти JVM: "+err.Error())
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory, profile.JavaMemoryMin); err != nil {
s.AppendLog("manager", "Не удалось выставить границы памяти JVM: "+err.Error())
}
args := []string{"-servername", profile.ID}
@@ -311,10 +360,13 @@ func (s *Supervisor) handleLine(stream, text string) {
}
// isServerReady распознаёт строку, которой PZ сообщает о готовности принимать
// игроков.
// игроков: «LOG : Network f:0 st:81,093,763> *** SERVER STARTED ****».
//
// Других маркеров тут нет намеренно. Регистрацию в Steam сервер печатает
// задолго до того, как мир загружен, и по ней панель показывала «Работает» на
// сервере, который ещё никого не пустит.
func isServerReady(line string) bool {
return strings.Contains(line, "SERVER STARTED") ||
strings.Contains(line, "Server Steam ID")
return strings.Contains(strings.ToUpper(line), "SERVER STARTED")
}
// wait дожидается завершения процесса и решает, поднимать ли его заново.
@@ -322,6 +374,8 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
err := cmd.Wait()
close(exited)
lifetime := time.Since(s.startedAt)
s.mu.Lock()
wasIntentional := s.intentionalStop
s.state = StateStopped
@@ -336,6 +390,15 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
s.lastExit = "штатное завершение"
}
reason := s.lastExit
// Падение сразу после запуска — признак того, что перезапуск не поможет:
// не хватило памяти, испорчен конфиг, нет файлов сервера.
if !wasIntentional && lifetime < quickCrashWindow {
s.crashStreak++
} else {
s.crashStreak = 0
}
streak := s.crashStreak
autoRestart := s.cfg.AutoRestart && !wasIntentional
s.mu.Unlock()
@@ -343,14 +406,38 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
if !autoRestart {
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 {
case <-time.After(restartDelay):
case <-cancel:
// Состояние уже переставил тот, кто отменил ожидание.
s.AppendLog("manager", "Автоперезапуск отменён")
return
case <-s.quit:
return
}
s.mu.Lock()
s.restartCancel = nil
s.restartAt = time.Time{}
if s.state == StateRestarting {
s.state = StateStopped
}
err = s.startLocked()
s.mu.Unlock()
if err != nil && !errors.Is(err, ErrAlreadyRunning) {
@@ -394,6 +481,12 @@ func (s *Supervisor) sendQuiet(command string) error {
// мир), затем SIGTERM группе процессов и в крайнем случае SIGKILL.
func (s *Supervisor) Stop() error {
s.mu.Lock()
// Ждём автоподъёма — «остановить» здесь значит «не поднимать».
if s.state == StateRestarting {
s.cancelRestartLocked()
s.mu.Unlock()
return nil
}
if s.state == StateStopped || s.cmd == nil {
s.mu.Unlock()
return ErrNotRunning
@@ -457,6 +550,23 @@ func (s *Supervisor) WaitStopped(timeout time.Duration) bool {
return s.State() == StateStopped
}
// checkStartupGrace страхует от сервера, который так и не напечатал строку о
// готовности: со своими модами и своей версией он может назвать её иначе, а
// вечное «Запускается» лишило бы панель опроса игроков.
func (s *Supervisor) checkStartupGrace() {
s.mu.Lock()
overdue := s.state == StateStarting && !s.startedAt.IsZero() &&
time.Since(s.startedAt) > startupGrace
if overdue {
s.state = StateRunning
}
s.mu.Unlock()
if overdue {
s.AppendLog("manager", "Сервер не сообщил о готовности — считаю его запущенным")
}
}
// pollPlayers периодически спрашивает у работающего сервера, кто онлайн.
func (s *Supervisor) pollPlayers() {
ticker := time.NewTicker(playersPollInterval)
@@ -466,6 +576,7 @@ func (s *Supervisor) pollPlayers() {
case <-s.quit:
return
case <-ticker.C:
s.checkStartupGrace()
if s.State() != StateRunning {
continue
}
+33
View File
@@ -0,0 +1,33 @@
package pzserver
import "testing"
// Строка о готовности решает, когда панель перестанет писать «Запускается».
// Ошибиться в обе стороны одинаково неприятно: рано — покажем работающим
// сервер, который никого не пустит; поздно — сервер работает, а панель молчит.
func TestIsServerReady(t *testing.T) {
ready := []string{
"LOG : Network f:0 st:81,093,763> *** SERVER STARTED ****",
"*** SERVER STARTED ****",
"Server started",
}
for _, line := range ready {
if !isServerReady(line) {
t.Errorf("строка о готовности не распознана: %q", line)
}
}
// Регистрацию в Steam и загрузку мира сервер печатает задолго до того,
// как начнёт принимать подключения.
notReady := []string{
"Server Steam ID 90271993034366481",
"znet: Java_zombie_core_znet_SteamGameServer_Init",
"LOG : General f:0 st:1,234> loading world",
"Loading: SERVER settings",
}
for _, line := range notReady {
if isServerReady(line) {
t.Errorf("строка принята за готовность: %q", line)
}
}
}
+69 -14
View File
@@ -16,6 +16,7 @@ import (
"fmt"
"net/http"
"os/exec"
"sort"
"strconv"
"strings"
"time"
@@ -27,6 +28,14 @@ const adminCommand = "pzmanager-admin"
// ErrNoAdmin возвращается, когда обновление из панели недоступно.
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 — то, что панель показывает в разделе обновления.
type Info struct {
Current string `json:"current"`
@@ -40,6 +49,10 @@ type Info struct {
CanApply bool `json:"can_apply"`
// ManualCommand — что выполнить в терминале, если сама не может.
ManualCommand string `json:"manual_command"`
// Changelog — все версии между установленной и последней, свежие первыми.
// Одного описания последнего релиза мало: пропустив пару версий, человек
// не увидит, что менялось в промежутке.
Changelog []ReleaseNote `json:"changelog"`
// Error — почему не удалось узнать последнюю версию.
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
}
// Check спрашивает у Gitea последний релиз и сравнивает его с текущей версией.
// Check спрашивает у Gitea список релизов и оставляет те, что новее
// установленной версии.
func (u *Updater) Check(ctx context.Context) Info {
info := Info{
Current: u.Version,
CanApply: u.CanApply(ctx),
ManualCommand: u.manualCommand(),
Changelog: []ReleaseNote{},
}
api, err := u.apiBase()
@@ -89,7 +104,10 @@ func (u *Updater) Check(ctx context.Context) 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 {
info.Error = err.Error()
return info
@@ -101,36 +119,73 @@ func (u *Updater) Check(ctx context.Context) Info {
}
defer resp.Body.Close()
if resp.StatusCode == http.StatusNotFound {
info.Error = "в репозитории ещё нет релизов"
return info
}
if resp.StatusCode != http.StatusOK {
info.Error = "репозиторий ответил " + resp.Status
return info
}
var release struct {
var releases []struct {
TagName string `json:"tag_name"`
Body string `json:"body"`
HTMLURL string `json:"html_url"`
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()
return info
}
info.Latest = release.TagName
info.Notes = release.Body
info.URL = release.HTMLURL
if !release.PublishedAt.IsZero() {
info.Published = release.PublishedAt.Unix()
notes := make([]ReleaseNote, 0, len(releases))
for _, r := range releases {
if r.Draft || r.Prerelease || r.TagName == "" {
continue
}
note := ReleaseNote{Version: r.TagName, Notes: r.Body, URL: r.HTMLURL}
if !r.PublishedAt.IsZero() {
note.Published = r.PublishedAt.Unix()
}
notes = append(notes, note)
}
info.Available = IsNewer(u.Version, release.TagName)
if len(notes) == 0 {
info.Error = "в репозитории ещё нет релизов"
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 пускает к
// нему без пароля. Проверяем вызовом: наличие файла ещё не значит, что
// правило 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))
}
}
+178
View File
@@ -0,0 +1,178 @@
package web
import (
"encoding/json"
"os"
"regexp"
"sort"
"strings"
"testing"
)
// Переводы легко разъезжаются: строку добавили в один язык и забыли про другой.
// Тесты ниже сверяют словари между собой и с разметкой.
func TestUIStringsCoverBothLanguages(t *testing.T) {
tables := parseStrings(t)
ru, en := tables["ru"], tables["en"]
if len(ru) == 0 || len(en) == 0 {
t.Fatalf("словари не разобраны: ru=%d en=%d", len(ru), len(en))
}
for key := range ru {
if _, ok := en[key]; !ok {
t.Errorf("нет английского перевода: %s", key)
}
}
for key := range en {
if _, ok := ru[key]; !ok {
t.Errorf("нет русского перевода: %s", key)
}
}
}
// Подстановки вида {count} должны совпадать: иначе в одном языке значение
// просто не появится.
func TestUIStringsPlaceholders(t *testing.T) {
tables := parseStrings(t)
placeholder := regexp.MustCompile(`\{(\w+)\}`)
for key, ruText := range tables["ru"] {
enText, ok := tables["en"][key]
if !ok {
continue
}
if got, want := names(placeholder, enText), names(placeholder, ruText); !equal(got, want) {
t.Errorf("%s: подстановки ru=%v, en=%v", key, want, got)
}
}
}
// Каждый ключ из разметки должен существовать в словаре, иначе на странице
// вместо подписи окажется сам ключ.
func TestMarkupKeysExist(t *testing.T) {
markup, err := os.ReadFile("static/index.html")
if err != nil {
t.Fatal(err)
}
tables := parseStrings(t)
attr := regexp.MustCompile(`data-i18n(?:-html|-placeholder|-title)?="([^"]+)"`)
for _, match := range attr.FindAllStringSubmatch(string(markup), -1) {
if _, ok := tables["ru"][match[1]]; !ok {
t.Errorf("ключ из index.html отсутствует в словаре: %s", match[1])
}
}
script, err := os.ReadFile("static/app.js")
if err != nil {
t.Fatal(err)
}
// Ключи, собранные из кусков (`state.${state}`), сюда не попадают — у них
// в коде есть запасной вариант на случай отсутствия перевода.
call := regexp.MustCompile(`\bt\("([^"]+)"`)
found := 0
for _, match := range call.FindAllStringSubmatch(string(script), -1) {
found++
if _, ok := tables["ru"][match[1]]; !ok {
t.Errorf("ключ из app.js отсутствует в словаре: %s", match[1])
}
}
if found == 0 {
t.Error("в app.js не найдено ни одного обращения к словарю")
}
}
// Подписи параметров конфигов лежат отдельными файлами: в них должны быть одни
// и те же ключи, и у каждого — подпись и описание.
func TestParamHintsMatch(t *testing.T) {
ru := readHints(t, "static/hints-ru.json")
en := readHints(t, "static/hints-en.json")
for _, section := range []string{"config", "sandbox"} {
if len(ru[section]) == 0 {
t.Fatalf("раздел %s пуст", section)
}
if len(ru[section]) != len(en[section]) {
t.Errorf("%s: ru=%d, en=%d параметров", section, len(ru[section]), len(en[section]))
}
for key, value := range ru[section] {
translated, ok := en[section][key]
if !ok {
t.Errorf("%s: нет английской подписи для %s", section, key)
continue
}
for _, pair := range [][]string{value, translated} {
if len(pair) != 2 || strings.TrimSpace(pair[0]) == "" || strings.TrimSpace(pair[1]) == "" {
t.Errorf("%s.%s: ожидались подпись и описание, получено %v", section, key, pair)
}
}
}
}
}
func readHints(t *testing.T, path string) map[string]map[string][]string {
t.Helper()
data, err := os.ReadFile(path)
if err != nil {
t.Fatal(err)
}
var hints map[string]map[string][]string
if err := json.Unmarshal(data, &hints); err != nil {
t.Fatalf("%s: %v", path, err)
}
return hints
}
// parseStrings вытаскивает словари из i18n.js. Разбирать JavaScript целиком
// незачем: строки записаны построчно, ключ в кавычках и двоеточие.
func parseStrings(t *testing.T) map[string]map[string]string {
t.Helper()
source, err := os.ReadFile("static/i18n.js")
if err != nil {
t.Fatal(err)
}
tables := map[string]map[string]string{}
entry := regexp.MustCompile(`^\s{4}"([^"]+)": "(.*)",$`)
current := ""
for _, line := range strings.Split(string(source), "\n") {
switch strings.TrimSpace(strings.TrimSuffix(line, "\r")) {
case "ru: {":
current = "ru"
tables[current] = map[string]string{}
continue
case "en: {":
current = "en"
tables[current] = map[string]string{}
continue
}
if current == "" {
continue
}
if match := entry.FindStringSubmatch(strings.TrimSuffix(line, "\r")); match != nil {
tables[current][match[1]] = match[2]
}
}
return tables
}
func names(re *regexp.Regexp, text string) []string {
found := []string{}
for _, match := range re.FindAllStringSubmatch(text, -1) {
found = append(found, match[1])
}
sort.Strings(found)
return found
}
func equal(a, b []string) bool {
if len(a) != len(b) {
return false
}
for i := range a {
if a[i] != b[i] {
return false
}
}
return true
}
+912 -180
View File
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+730
View File
@@ -0,0 +1,730 @@
"use strict";
// ---------------------------------------------------------------------------
// Локализация интерфейса
// ---------------------------------------------------------------------------
// Язык выбирается человеком и хранится в localStorage; пока выбора не было,
// панель ориентируется на язык браузера. Строки лежат плоским словарём:
// ключ -> текст, подстановки записываются как {name}.
const LANG_KEY = "pzm-lang";
const LANGS = ["ru", "en"];
const FALLBACK_LANG = "en";
function detectLang() {
let saved = null;
try {
saved = localStorage.getItem(LANG_KEY);
} catch (error) {
// Приватный режим может запрещать хранилище — тогда просто определяем язык.
}
if (LANGS.includes(saved)) return saved;
const preferred = navigator.languages && navigator.languages.length
? navigator.languages
: [navigator.language || ""];
for (const tag of preferred) {
const code = String(tag).toLowerCase().split("-")[0];
if (LANGS.includes(code)) return code;
}
return FALLBACK_LANG;
}
const LANG = detectLang();
// Сервер отдаёт свои сообщения об ошибках на языке панели, и узнаёт его из
// куки: заголовок Accept-Language говорит о браузере, а не о выборе человека.
document.cookie = `pzm_lang=${LANG}; path=/; max-age=31536000; samesite=lax`;
document.documentElement.lang = LANG;
function setLang(lang) {
if (!LANGS.includes(lang) || lang === LANG) return;
try {
localStorage.setItem(LANG_KEY, lang);
} catch (error) {
// Без хранилища выбор не переживёт перезагрузку, но применится сейчас.
}
document.cookie = `pzm_lang=${lang}; path=/; max-age=31536000; samesite=lax`;
// Перерисовать всё на месте было бы можно, но перезагрузка честнее: она
// заново читает и подписи параметров, и данные с сервера.
location.reload();
}
// t возвращает строку по ключу. Неизвестный ключ — это ошибка перевода, а не
// повод показать пустое место: отдаём сам ключ, его видно при проверке.
function t(key, vars) {
const table = STRINGS[LANG] || {};
let text = table[key];
if (text === undefined) text = (STRINGS[FALLBACK_LANG] || {})[key];
if (text === undefined) return key;
if (!vars) return text;
return text.replace(/\{(\w+)\}/g, (match, name) =>
(vars[name] === undefined ? match : String(vars[name])));
}
// Разметка помечена атрибутами: data-i18n ставит текст, а варианты с суффиксом
// — соответствующий атрибут. Так HTML остаётся читаемым и не обрастает кодом.
function applyStaticTranslations(root = document) {
root.querySelectorAll("[data-i18n]").forEach((el) => {
el.textContent = t(el.dataset.i18n);
});
root.querySelectorAll("[data-i18n-html]").forEach((el) => {
el.innerHTML = t(el.dataset.i18nHtml);
});
root.querySelectorAll("[data-i18n-placeholder]").forEach((el) => {
el.placeholder = t(el.dataset.i18nPlaceholder);
});
root.querySelectorAll("[data-i18n-title]").forEach((el) => {
el.title = t(el.dataset.i18nTitle);
});
}
const STRINGS = {
ru: {
"lang.label": "Язык",
"auth.subtitle": "Управление сервером Project Zomboid",
"auth.subtitleSetup": "Создайте учётную запись администратора",
"auth.token": "Код первичной настройки",
"auth.tokenHint": "Код напечатан в журнале менеджера при запуске: <code>journalctl -u pzmanager</code>",
"auth.login": "Логин",
"auth.password": "Пароль",
"auth.signIn": "Войти",
"auth.createAdmin": "Создать администратора",
"auth.expired": "Сессия истекла, войдите заново",
"error.http": "Ошибка {status}",
"error.offline": "Нет связи с менеджером",
"btn.start": "Запустить",
"btn.stop": "Остановить",
"btn.restart": "Перезапустить",
"btn.cancelRestart": "Отменить перезапуск",
"btn.logout": "Выйти",
"btn.cancel": "Отменить",
"btn.save": "Сохранить",
"btn.saveCount": "Сохранить ({count})",
"btn.delete": "Удалить",
"state.stopped": "Остановлен",
"state.restarting": "Ждёт перезапуска",
"state.starting": "Запускается",
"state.running": "Работает",
"state.stopping": "Останавливается",
"state.restartIn": "Перезапуск через {sec} с",
"tab.overview": "Обзор",
"tab.console": "Консоль",
"tab.config": "Конфиг сервера",
"tab.sandbox": "Песочница",
"tab.mods": "Моды",
"tab.backups": "Бэкапы",
"tab.profiles": "Профили",
"tab.settings": "Настройки",
"overview.stateCard": "Состояние",
"overview.playersCard": "Игроки онлайн",
"overview.processCard": "Процесс сервера",
"overview.hostCard": "Хост",
"overview.cpu": "CPU",
"overview.memory": "Память",
"overview.threads": "Потоки",
"overview.ramFree": "ОЗУ свободно",
"overview.load": "Load average",
"overview.diskFree": "Диск свободно",
"overview.uptime": "Работает: {value}",
"overview.loading": "Загружается: {value}",
"overview.starting": "Мир загружается — сервер ещё не принимает подключения",
"overview.profile": "Профиль: {title}",
"overview.lastExit": "Последнее завершение: {reason}",
"overview.memoryOf": "{free} из {total}",
"overview.loadCores": "{load} на {count} ядер",
"install.card": "Серверные файлы",
"install.installed": "Серверные файлы установлены.",
"install.missing": "Серверные файлы не найдены — сервер ещё не установлен.",
"install.install": "Установить сервер через SteamCMD",
"install.update": "Обновить сервер через SteamCMD",
"install.hintInstall": "Займёт несколько минут и около 3 ГБ на диске — прогресс виден во вкладке «Консоль».",
"install.hintUpdate": "Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль».",
"install.confirmInstall": "Установить сервер через SteamCMD?",
"install.confirmUpdate": "Обновить серверные файлы через SteamCMD?",
"install.started": "Задача запущена — следите за вкладкой «Консоль»",
"confirm.stop": "Остановить игровой сервер? Игроки будут отключены.",
"confirm.restart": "Перезапустить сервер? Игроки будут отключены.",
"task.done": "{name} — готово",
"console.autoscroll": "Прокручивать за выводом",
"console.filter": "Фильтр по строке…",
"console.clear": "Очистить экран",
"console.placeholder": "Команда сервера, например: players, save, quit",
"console.placeholderOffline": "Сервер остановлен — консоль принимает команды только на работающем",
"console.send": "Отправить",
"console.help": "Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg \"текст\"</code>, <code>kickuser \"ник\"</code>, <code>banuser \"ник\"</code>, <code>checkModsNeedUpdate</code>.",
"config.title": "Конфигурация сервера",
"config.search": "Поиск параметра…",
"config.saved": "Конфиг сохранён. Изменения применятся после перезапуска сервера.",
"config.noChanges": "Нет изменений",
"config.changedCount": "Изменено параметров: {count}",
"config.noChangesTitle": "Изменений нет",
"config.yes": "да",
"config.no": "нет",
"config.anticheatLabel": "Античит: проверка {number}",
"config.anticheatHint": "Одна из встроенных проверок. Отключайте только при ложных срабатываниях.",
"sandbox.title": "Настройки песочницы",
"sandbox.saved": "Песочница сохранена. Часть параметров действует только на новый мир.",
"group.other": "Прочее",
"group.config.general": "Основное",
"group.config.access": "Доступ и учётные записи",
"group.config.network": "Сеть и порты",
"group.config.pvp": "PVP и урон",
"group.config.world": "Мир и правила",
"group.config.backups": "Бэкапы самой игры",
"group.config.mods": "Моды",
"group.config.chat": "Чат и голос",
"group.config.badwords": "Фильтр брани",
"group.config.visibility": "Видимость игроков",
"group.config.safehouse": "Убежища",
"group.config.factions": "Фракции и войны",
"group.config.radio": "Рации",
"group.config.discord": "Discord",
"group.config.anticheat": "Античит и журналы",
"group.config.vehicles": "Транспорт",
"group.sandbox.zombies": "Зомби",
"group.sandbox.world": "Мир и время",
"group.sandbox.weather": "Погода",
"group.sandbox.loot": "Лут и предметы",
"group.sandbox.character": "Персонаж и навыки",
"group.sandbox.food": "Еда, вода и хозяйство",
"group.sandbox.animals": "Животные",
"group.sandbox.vehicles": "Транспорт",
"group.sandbox.firearms": "Огнестрельное оружие",
"group.sandbox.power": "Электричество и огонь",
"group.sandbox.service": "Служебное",
"group.sandbox.ZombieLore": "Зомби: повадки и характеристики",
"group.sandbox.ZombieConfig": "Зомби: популяция и респавн",
"group.sandbox.MultiplierConfig": "Множители опыта навыков",
"group.sandbox.Map": "Карта",
"group.sandbox.Basement": "Подвалы",
"mods.title": "Моды",
"mods.subtitle": "Галочка включает мод, перетаскивание задаёт порядок загрузки. Сервер сам скачивает моды из мастерской при запуске.",
"mods.inputPlaceholder": "Ссылка на мод или коллекцию, либо просто ID",
"mods.add": "Добавить мод",
"mods.addCollection": "Добавить коллекцию",
"mods.collectionHint": "Коллекция разворачивается в список входящих в неё модов. Сами файлы сервер скачивает сам при запуске — после этого моды можно включать галочками.",
"mods.search": "Поиск по названию…",
"mods.onlyEnabled": "Только включённые",
"mods.mapsTitle": "Карты (Map)",
"mods.mapsPlaceholder": "Например: Muldraugh, KY",
"mods.mapsHint": "Каждая карта с новой строки. Первой должна идти карта мода, последней — базовая.",
"mods.summary": "Модов: {total}, включено: {enabled}, пакетов мастерской: {workshop}",
"mods.local": "локальный мод",
"mods.notFound": "файлы не найдены — сервер скачает их при запуске",
"mods.notDownloaded": "ещё не скачан — включить можно после запуска сервера",
"mods.unnamed": "Мод {id}",
"mods.unknownID": "Mod ID неизвестен",
"mods.dragTitle": "Перетащите, чтобы изменить порядок",
"mods.dragDisabled": "Порядок задаётся у включённых модов",
"mods.toggleTitle": "Включить мод на сервере",
"mods.up": "Выше",
"mods.down": "Ниже",
"mods.remove": "Убрать",
"mods.empty": "Ничего не найдено",
"mods.unsaved": "Есть несохранённые изменения",
"mods.badInput": "Не похоже на ссылку или ID мода",
"mods.duplicate": "Этот мод уже в списке",
"mods.needCollection": "Вставьте ссылку на коллекцию или её ID",
"mods.collectionAdded": "Из коллекции добавлено модов: {added} (всего в ней {total})",
"mods.collectionKnown": "Все {total} модов коллекции уже были в списке",
"mods.saved": "Список модов сохранён. Перезапустите сервер, чтобы он их подтянул.",
"backups.title": "Резервные копии",
"backups.note": "Бэкап снимается с активного профиля: его мир и конфиги.",
"backups.notePlaceholder": "Пометка (необязательно)",
"backups.create": "Создать бэкап",
"backups.colArchive": "Архив",
"backups.colProfile": "Профиль",
"backups.colSize": "Размер",
"backups.colCreated": "Создан",
"backups.download": "Скачать",
"backups.restore": "Восстановить",
"backups.empty": "Пока ни одного архива",
"backups.started": "Бэкап запущен — прогресс во вкладке «Консоль»",
"backups.confirmRestore": "Восстановить мир из {name}? Текущий мир будет перезаписан.\nПеред восстановлением менеджер сам сделает страховочный бэкап.",
"backups.restoreStarted": "Восстановление запущено",
"backups.confirmDelete": "Удалить архив {name}? Это действие необратимо.",
"backups.deleted": "Архив удалён",
"profiles.title": "Профили серверов",
"profiles.subtitle": "У каждого профиля свой мир, конфиг, песочница и набор модов. Одновременно работает один — переключать можно на остановленном сервере.",
"profiles.picker": "Профиль",
"profiles.pickerTitle": "Профиль сервера: свой мир, конфиг и моды",
"profiles.pickerLocked": "Остановите сервер, чтобы переключить профиль",
"profiles.active": "активный",
"profiles.worldReady": "мир создан",
"profiles.configured": "настроен, мир ещё не создан",
"profiles.never": "ни разу не запускался",
"profiles.name": "Название",
"profiles.memoryMax": "Память JVM, максимум",
"profiles.memoryMin": "Память JVM, начальная",
"profiles.memoryMinPlaceholder": "не задана",
"profiles.memoryMinHint": "Пусто — JVM берёт память по мере надобности. Если задать, она займёт этот объём сразу при старте и не сможет подняться, когда его нет.",
"profiles.adminPassword": "Пароль админа игры",
"profiles.adminPasswordSet": "пароль задан",
"profiles.adminPasswordUnset": "не задан",
"profiles.activate": "Сделать активным",
"profiles.memoryExample": "Например 4g",
"profiles.memoryHost": "На машине {total} ОЗУ, свободно {free}. Оставьте запас системе.",
"profiles.switched": "Активный профиль переключён",
"profiles.saved": "Профиль сохранён",
"profiles.confirmDelete": "Убрать профиль {id} из панели?\n\nМир и конфиги останутся на диске — профиль можно вернуть, создав его с тем же идентификатором.",
"profiles.deleted": "Профиль удалён",
"profiles.created": "Профиль создан",
"profiles.newTitle": "Новый профиль",
"profiles.id": "Идентификатор",
"profiles.idHint": "Латиница, цифры, дефис. Станет именем конфига и папки мира.",
"profiles.nameHint": "Как профиль подписан в панели.",
"profiles.namePlaceholder": "Сборка с модами",
"profiles.memory": "Память JVM",
"profiles.memoryHint": "Применяется при запуске этого профиля.",
"profiles.copyFrom": "Скопировать настройки из",
"profiles.copyHint": "Копирует .ini и настройки песочницы. Мир останется новым.",
"profiles.copyNone": "не копировать",
"profiles.create": "Создать профиль",
"import.title": "Импорт пресета сборки",
"import.fileHint": "ZIP-пакет сборки: панель возьмёт из него серверный .ini, настройки песочницы и точки появления, остальное пропустит.",
"import.reading": "Читаю архив…",
"import.set": "Набор из архива",
"import.server": "Сервер: {name}",
"import.mods": "Моды: {mods} · пакеты мастерской: {workshop}",
"import.maps": "Карты: {maps}",
"import.counts": "Настройки сервера: {settings} · песочница: {sandbox}",
"import.spawnYes": "Точки появления: есть",
"import.spawnNo": "Точки появления: нет",
"import.noINI": "Конфига сервера в наборе нет — импортируются только настройки песочницы.",
"import.target": "Куда импортировать",
"import.targetNew": "В новый профиль",
"import.targetExisting": "Поверх существующего профиля",
"import.newID": "Идентификатор нового профиля",
"import.profile": "Профиль",
"import.overwriteHint": "Конфиги профиля будут заменены, прежние останутся рядом с расширением .bak. Мир не трогается.",
"import.keep": "Оставить свои значения вместо тех, что в пресете:",
"import.keepPorts": "Порты и RCON",
"import.keepAccess": "Пароль сервера и объявляемый IP",
"import.keepIdentity": "Имя и описание сервера",
"import.apply": "Импортировать",
"import.noFile": "Выберите ZIP-пакет сборки",
"import.confirm": "Импортировать набор «{name}» в профиль {profile}?\n\nКонфиги профиля будут заменены, прежние останутся рядом с расширением .bak.",
"import.done": "Пресет импортирован в профиль {profile}. Записано файлов: {files}.",
"import.kept": "Свои значения взяты из профиля {profile}: {keys}",
"settings.versionTitle": "Версия панели",
"settings.title": "Настройки менеджера",
"settings.save": "Сохранить настройки",
"settings.saveCount": "Сохранить настройки ({count})",
"settings.changedCount": "Изменено полей: {count}",
"settings.saved": "Настройки сохранены",
"settings.configPath": "Файл конфигурации: {path}",
"settings.usersTitle": "Пользователи панели",
"settings.listen": "Адрес веб-панели",
"settings.listenHint": "Например 127.0.0.1:8080. Применится после перезапуска pzmanager",
"settings.serverDir": "Директория сервера",
"settings.serverDirHint": "Куда SteamCMD ставит файлы Project Zomboid",
"settings.zomboidDir": "Директория данных (~/Zomboid)",
"settings.zomboidDirHint": "Здесь лежат миры, конфиги и логи игры",
"settings.steamcmdPath": "Путь к steamcmd.sh",
"settings.steamcmdPathHint": "Пусто — найти в PATH или скачать автоматически",
"settings.autostart": "Запускать сервер вместе с менеджером",
"settings.autorestart": "Поднимать сервер после падения",
"settings.stopTimeout": "Таймаут остановки, сек",
"settings.stopTimeoutHint": "Сколько ждать после команды quit до SIGTERM",
"settings.logBuffer": "Строк консоли в памяти",
"settings.backupDir": "Директория бэкапов",
"settings.backupSchedule": "Автобэкап, минут",
"settings.backupScheduleHint": "0 — отключить автоматические бэкапы",
"settings.backupKeep": "Хранить архивов",
"settings.backupKeepHint": "0 — не удалять старые",
"settings.backupStopServer": "Останавливать сервер на время бэкапа",
"settings.backupStopServerHint": "Даёт согласованный снимок, но выкидывает игроков",
"users.loginPlaceholder": "Логин",
"users.passwordPlaceholder": "Пароль (минимум 8 символов)",
"users.add": "Добавить пользователя",
"users.changePassword": "Сменить пароль",
"users.newPassword": "Новый пароль для {login} (минимум 8 символов):",
"users.passwordChanged": "Пароль изменён",
"users.confirmDelete": "Удалить пользователя {login}?",
"users.deleted": "Пользователь удалён",
"users.added": "Пользователь добавлен",
"update.checking": "Проверяю обновления…",
"update.check": "Проверить",
"update.apply": "Обновить",
"update.applyTo": "Обновить до {version}",
"update.restart": "Перезапустить панель",
"update.restartTitle": "Перезапустить службу панели",
"update.restartUnavailable": "Недоступно: панель не может управлять своей службой",
"update.failed": "Не удалось проверить обновления: {error}",
"update.available": "Доступна версия {version}",
"update.manual": "Обновить можно командой: {command}",
"update.current": "Установлена последняя версия ({version})",
"update.unknown": "Сведений о релизах нет",
"update.whatsNew": "Что нового",
"update.whatsNewCount": "Что нового (версий: {count})",
"update.noNotes": "Описание не заполнено",
"update.fullNotes": "Полное описание релизов",
"update.hasNew": "Есть новая версия: {version}",
"update.upToDate": "Обновлений нет",
"update.confirm": "Обновить панель до {version}?\n\nИгровой сервер будет остановлен, панель перезапустится.",
"update.started": "Обновление запущено",
"update.follow": "Ход обновления: journalctl -u pzmanager-update -f",
"update.confirmRestart": "Перезапустить панель?\n\nИгровой сервер будет остановлен.",
"update.restarting": "Панель перезапускается",
"update.waiting": "{message} — жду, пока панель поднимется",
"update.waitingState": "{message}…",
"update.timeout": "Панель не поднялась за пять минут — проверьте journalctl -u pzmanager",
"unit.b": "Б",
"unit.kb": "КБ",
"unit.mb": "МБ",
"unit.gb": "ГБ",
"unit.tb": "ТБ",
"unit.days": "{value} д",
"unit.hours": "{value} ч",
"unit.minutes": "{value} мин",
"locale.tag": "ru-RU",
},
en: {
"lang.label": "Language",
"auth.subtitle": "Project Zomboid server management",
"auth.subtitleSetup": "Create an administrator account",
"auth.token": "Setup code",
"auth.tokenHint": "The code is printed to the manager log at startup: <code>journalctl -u pzmanager</code>",
"auth.login": "Login",
"auth.password": "Password",
"auth.signIn": "Sign in",
"auth.createAdmin": "Create administrator",
"auth.expired": "Session expired, please sign in again",
"error.http": "Error {status}",
"error.offline": "No connection to the manager",
"btn.start": "Start",
"btn.stop": "Stop",
"btn.restart": "Restart",
"btn.cancelRestart": "Cancel restart",
"btn.logout": "Sign out",
"btn.cancel": "Cancel",
"btn.save": "Save",
"btn.saveCount": "Save ({count})",
"btn.delete": "Delete",
"state.stopped": "Stopped",
"state.restarting": "Waiting to restart",
"state.starting": "Starting",
"state.running": "Running",
"state.stopping": "Stopping",
"state.restartIn": "Restarting in {sec} s",
"tab.overview": "Overview",
"tab.console": "Console",
"tab.config": "Server config",
"tab.sandbox": "Sandbox",
"tab.mods": "Mods",
"tab.backups": "Backups",
"tab.profiles": "Profiles",
"tab.settings": "Settings",
"overview.stateCard": "State",
"overview.playersCard": "Players online",
"overview.processCard": "Server process",
"overview.hostCard": "Host",
"overview.cpu": "CPU",
"overview.memory": "Memory",
"overview.threads": "Threads",
"overview.ramFree": "RAM free",
"overview.load": "Load average",
"overview.diskFree": "Disk free",
"overview.uptime": "Uptime: {value}",
"overview.loading": "Loading: {value}",
"overview.starting": "The world is loading — the server does not accept connections yet",
"overview.profile": "Profile: {title}",
"overview.lastExit": "Last exit: {reason}",
"overview.memoryOf": "{free} of {total}",
"overview.loadCores": "{load} on {count} cores",
"install.card": "Server files",
"install.installed": "Server files are installed.",
"install.missing": "Server files not found — the server is not installed yet.",
"install.install": "Install server via SteamCMD",
"install.update": "Update server via SteamCMD",
"install.hintInstall": "Takes a few minutes and about 3 GB of disk space — watch the progress on the Console tab.",
"install.hintUpdate": "The server must be stopped. The update takes a few minutes — watch the progress on the Console tab.",
"install.confirmInstall": "Install the server via SteamCMD?",
"install.confirmUpdate": "Update the server files via SteamCMD?",
"install.started": "Task started — watch the Console tab",
"confirm.stop": "Stop the game server? Players will be disconnected.",
"confirm.restart": "Restart the server? Players will be disconnected.",
"task.done": "{name} — done",
"console.autoscroll": "Scroll with output",
"console.filter": "Filter by text…",
"console.clear": "Clear screen",
"console.placeholder": "Server command, for example: players, save, quit",
"console.placeholderOffline": "Server stopped — the console only accepts commands while it runs",
"console.send": "Send",
"console.help": "Handy commands: <code>players</code>, <code>save</code>, <code>servermsg \"text\"</code>, <code>kickuser \"name\"</code>, <code>banuser \"name\"</code>, <code>checkModsNeedUpdate</code>.",
"config.title": "Server configuration",
"config.search": "Find a setting…",
"config.saved": "Config saved. Changes apply after a server restart.",
"config.noChanges": "Nothing changed",
"config.changedCount": "Settings changed: {count}",
"config.noChangesTitle": "No changes",
"config.yes": "yes",
"config.no": "no",
"config.anticheatLabel": "Anti-cheat: check {number}",
"config.anticheatHint": "One of the built-in checks. Disable it only if it fires on legitimate players.",
"sandbox.title": "Sandbox settings",
"sandbox.saved": "Sandbox saved. Some settings only affect a freshly created world.",
"group.other": "Other",
"group.config.general": "General",
"group.config.access": "Access and accounts",
"group.config.network": "Network and ports",
"group.config.pvp": "PVP and damage",
"group.config.world": "World and rules",
"group.config.backups": "In-game backups",
"group.config.mods": "Mods",
"group.config.chat": "Chat and voice",
"group.config.badwords": "Profanity filter",
"group.config.visibility": "Player visibility",
"group.config.safehouse": "Safehouses",
"group.config.factions": "Factions and wars",
"group.config.radio": "Radio",
"group.config.discord": "Discord",
"group.config.anticheat": "Anti-cheat and logs",
"group.config.vehicles": "Vehicles",
"group.sandbox.zombies": "Zombies",
"group.sandbox.world": "World and time",
"group.sandbox.weather": "Weather",
"group.sandbox.loot": "Loot and items",
"group.sandbox.character": "Character and skills",
"group.sandbox.food": "Food, water and farming",
"group.sandbox.animals": "Animals",
"group.sandbox.vehicles": "Vehicles",
"group.sandbox.firearms": "Firearms",
"group.sandbox.power": "Power and fire",
"group.sandbox.service": "Service",
"group.sandbox.ZombieLore": "Zombies: behaviour and traits",
"group.sandbox.ZombieConfig": "Zombies: population and respawn",
"group.sandbox.MultiplierConfig": "Skill XP multipliers",
"group.sandbox.Map": "Map",
"group.sandbox.Basement": "Basements",
"mods.title": "Mods",
"mods.subtitle": "The checkbox enables a mod, dragging sets the load order. The server downloads mods from the Workshop on startup.",
"mods.inputPlaceholder": "Link to a mod or collection, or just an ID",
"mods.add": "Add mod",
"mods.addCollection": "Add collection",
"mods.collectionHint": "A collection expands into the list of mods it contains. The server downloads the files itself on startup — after that the mods can be enabled with checkboxes.",
"mods.search": "Search by name…",
"mods.onlyEnabled": "Enabled only",
"mods.mapsTitle": "Maps (Map)",
"mods.mapsPlaceholder": "For example: Muldraugh, KY",
"mods.mapsHint": "One map per line. The mod map goes first, the base map last.",
"mods.summary": "Mods: {total}, enabled: {enabled}, Workshop items: {workshop}",
"mods.local": "local mod",
"mods.notFound": "files not found — the server will download them on startup",
"mods.notDownloaded": "not downloaded yet — can be enabled after a server start",
"mods.unnamed": "Mod {id}",
"mods.unknownID": "Mod ID unknown",
"mods.dragTitle": "Drag to change the order",
"mods.dragDisabled": "Order applies to enabled mods only",
"mods.toggleTitle": "Enable the mod on the server",
"mods.up": "Up",
"mods.down": "Down",
"mods.remove": "Remove",
"mods.empty": "Nothing found",
"mods.unsaved": "There are unsaved changes",
"mods.badInput": "That does not look like a mod link or ID",
"mods.duplicate": "This mod is already on the list",
"mods.needCollection": "Paste a collection link or its ID",
"mods.collectionAdded": "Mods added from the collection: {added} (of {total} in it)",
"mods.collectionKnown": "All {total} mods of the collection were already on the list",
"mods.saved": "Mod list saved. Restart the server so it picks them up.",
"backups.title": "Backups",
"backups.note": "The backup is taken from the active profile: its world and configs.",
"backups.notePlaceholder": "Note (optional)",
"backups.create": "Create backup",
"backups.colArchive": "Archive",
"backups.colProfile": "Profile",
"backups.colSize": "Size",
"backups.colCreated": "Created",
"backups.download": "Download",
"backups.restore": "Restore",
"backups.empty": "No archives yet",
"backups.started": "Backup started — progress on the Console tab",
"backups.confirmRestore": "Restore the world from {name}? The current world will be overwritten.\nThe manager takes a safety backup first.",
"backups.restoreStarted": "Restore started",
"backups.confirmDelete": "Delete the archive {name}? This cannot be undone.",
"backups.deleted": "Archive deleted",
"profiles.title": "Server profiles",
"profiles.subtitle": "Every profile has its own world, config, sandbox and mod set. Only one runs at a time — switch it while the server is stopped.",
"profiles.picker": "Profile",
"profiles.pickerTitle": "Server profile: its own world, config and mods",
"profiles.pickerLocked": "Stop the server to switch the profile",
"profiles.active": "active",
"profiles.worldReady": "world created",
"profiles.configured": "configured, world not created yet",
"profiles.never": "never started",
"profiles.name": "Name",
"profiles.memoryMax": "JVM memory, maximum",
"profiles.memoryMin": "JVM memory, initial",
"profiles.memoryMinPlaceholder": "not set",
"profiles.memoryMinHint": "Empty — the JVM takes memory as it needs it. If set, it grabs that much at startup and fails to start when the machine has less.",
"profiles.adminPassword": "Game admin password",
"profiles.adminPasswordSet": "password set",
"profiles.adminPasswordUnset": "not set",
"profiles.activate": "Make active",
"profiles.memoryExample": "For example 4g",
"profiles.memoryHost": "The machine has {total} of RAM, {free} free. Leave some for the system.",
"profiles.switched": "Active profile switched",
"profiles.saved": "Profile saved",
"profiles.confirmDelete": "Remove the profile {id} from the panel?\n\nThe world and configs stay on disk — the profile can be brought back by creating it with the same identifier.",
"profiles.deleted": "Profile deleted",
"profiles.created": "Profile created",
"profiles.newTitle": "New profile",
"profiles.id": "Identifier",
"profiles.idHint": "Latin letters, digits, hyphen. Becomes the config name and the world folder.",
"profiles.nameHint": "How the profile is labelled in the panel.",
"profiles.namePlaceholder": "Modded run",
"profiles.memory": "JVM memory",
"profiles.memoryHint": "Applied when this profile starts.",
"profiles.copyFrom": "Copy settings from",
"profiles.copyHint": "Copies the .ini and the sandbox settings. The world stays new.",
"profiles.copyNone": "do not copy",
"profiles.create": "Create profile",
"import.title": "Import a collection preset",
"import.fileHint": "A collection ZIP package: the panel takes the server .ini, the sandbox settings and the spawn regions out of it and skips the rest.",
"import.reading": "Reading the archive…",
"import.set": "Preset from the archive",
"import.server": "Server: {name}",
"import.mods": "Mods: {mods} · Workshop items: {workshop}",
"import.maps": "Maps: {maps}",
"import.counts": "Server settings: {settings} · sandbox: {sandbox}",
"import.spawnYes": "Spawn regions: included",
"import.spawnNo": "Spawn regions: none",
"import.noINI": "The preset has no server config — only the sandbox settings will be imported.",
"import.target": "Where to import",
"import.targetNew": "Into a new profile",
"import.targetExisting": "Over an existing profile",
"import.newID": "Identifier of the new profile",
"import.profile": "Profile",
"import.overwriteHint": "The profile configs will be replaced, the previous ones stay next to them with a .bak extension. The world is left alone.",
"import.keep": "Keep your own values instead of the ones from the preset:",
"import.keepPorts": "Ports and RCON",
"import.keepAccess": "Server password and announced IP",
"import.keepIdentity": "Server name and description",
"import.apply": "Import",
"import.noFile": "Choose a collection ZIP package",
"import.confirm": "Import the preset \"{name}\" into the profile {profile}?\n\nThe profile configs will be replaced, the previous ones stay next to them with a .bak extension.",
"import.done": "Preset imported into the profile {profile}. Files written: {files}.",
"import.kept": "Your own values were taken from the profile {profile}: {keys}",
"settings.versionTitle": "Panel version",
"settings.title": "Manager settings",
"settings.save": "Save settings",
"settings.saveCount": "Save settings ({count})",
"settings.changedCount": "Fields changed: {count}",
"settings.saved": "Settings saved",
"settings.configPath": "Configuration file: {path}",
"settings.usersTitle": "Panel users",
"settings.listen": "Web panel address",
"settings.listenHint": "For example 127.0.0.1:8080. Applies after a pzmanager restart",
"settings.serverDir": "Server directory",
"settings.serverDirHint": "Where SteamCMD installs the Project Zomboid files",
"settings.zomboidDir": "Data directory (~/Zomboid)",
"settings.zomboidDirHint": "Worlds, configs and game logs live here",
"settings.steamcmdPath": "Path to steamcmd.sh",
"settings.steamcmdPathHint": "Empty — look it up in PATH or download automatically",
"settings.autostart": "Start the server together with the manager",
"settings.autorestart": "Bring the server back up after a crash",
"settings.stopTimeout": "Stop timeout, sec",
"settings.stopTimeoutHint": "How long to wait after the quit command before SIGTERM",
"settings.logBuffer": "Console lines kept in memory",
"settings.backupDir": "Backup directory",
"settings.backupSchedule": "Auto backup, minutes",
"settings.backupScheduleHint": "0 — turn automatic backups off",
"settings.backupKeep": "Archives to keep",
"settings.backupKeepHint": "0 — never delete old ones",
"settings.backupStopServer": "Stop the server while backing up",
"settings.backupStopServerHint": "Gives a consistent snapshot, but kicks the players",
"users.loginPlaceholder": "Login",
"users.passwordPlaceholder": "Password (at least 8 characters)",
"users.add": "Add user",
"users.changePassword": "Change password",
"users.newPassword": "New password for {login} (at least 8 characters):",
"users.passwordChanged": "Password changed",
"users.confirmDelete": "Delete the user {login}?",
"users.deleted": "User deleted",
"users.added": "User added",
"update.checking": "Checking for updates…",
"update.check": "Check",
"update.apply": "Update",
"update.applyTo": "Update to {version}",
"update.restart": "Restart panel",
"update.restartTitle": "Restart the panel service",
"update.restartUnavailable": "Unavailable: the panel cannot manage its own service",
"update.failed": "Could not check for updates: {error}",
"update.available": "Version {version} is available",
"update.manual": "Update with this command: {command}",
"update.current": "The latest version is installed ({version})",
"update.unknown": "No release information",
"update.whatsNew": "What's new",
"update.whatsNewCount": "What's new ({count} versions)",
"update.noNotes": "No description",
"update.fullNotes": "Full release notes",
"update.hasNew": "A new version is available: {version}",
"update.upToDate": "No updates",
"update.confirm": "Update the panel to {version}?\n\nThe game server will be stopped and the panel will restart.",
"update.started": "Update started",
"update.follow": "Update progress: journalctl -u pzmanager-update -f",
"update.confirmRestart": "Restart the panel?\n\nThe game server will be stopped.",
"update.restarting": "The panel is restarting",
"update.waiting": "{message} — waiting for the panel to come back",
"update.waitingState": "{message}…",
"update.timeout": "The panel did not come back within five minutes — check journalctl -u pzmanager",
"unit.b": "B",
"unit.kb": "KB",
"unit.mb": "MB",
"unit.gb": "GB",
"unit.tb": "TB",
"unit.days": "{value} d",
"unit.hours": "{value} h",
"unit.minutes": "{value} min",
"locale.tag": "en-US",
},
};
+164 -98
View File
@@ -13,26 +13,34 @@
<div id="auth-screen" class="auth-screen hidden">
<form id="auth-form" class="auth-card">
<h1 class="auth-title">🧟 PZ Manager</h1>
<p id="auth-subtitle" class="auth-subtitle">Управление сервером Project Zomboid</p>
<p id="auth-subtitle" class="auth-subtitle" data-i18n="auth.subtitle"></p>
<label class="field" id="token-field" hidden>
<span>Код первичной настройки</span>
<span data-i18n="auth.token"></span>
<input type="text" name="token" autocomplete="off" spellcheck="false">
<small>Код напечатан в журнале менеджера при запуске: <code>journalctl -u pzmanager</code></small>
<small data-i18n-html="auth.tokenHint"></small>
</label>
<label class="field">
<span>Логин</span>
<span data-i18n="auth.login"></span>
<input type="text" name="login" autocomplete="username" required>
</label>
<label class="field">
<span>Пароль</span>
<span data-i18n="auth.password"></span>
<input type="password" name="password" autocomplete="current-password" required>
</label>
<p id="auth-error" class="error" hidden></p>
<button type="submit" class="btn btn-primary btn-block" id="auth-submit">Войти</button>
<button type="submit" class="btn btn-primary btn-block" id="auth-submit" data-i18n="auth.signIn"></button>
<label class="lang-picker lang-picker-auth">
<span data-i18n="lang.label"></span>
<select class="lang-select">
<option value="ru">Русский</option>
<option value="en">English</option>
</select>
</label>
</form>
</div>
@@ -47,36 +55,42 @@
</div>
<label class="profile-picker">
<span>Профиль</span>
<select id="profile-select" title="Профиль сервера: свой мир, конфиг и моды"></select>
<span data-i18n="profiles.picker"></span>
<select id="profile-select" data-i18n-title="profiles.pickerTitle"></select>
</label>
<div class="controls">
<button class="btn btn-start" id="btn-start">Запустить</button>
<button class="btn btn-stop" id="btn-stop">Остановить</button>
<button class="btn" id="btn-restart">Перезапустить</button>
<button class="btn btn-start" id="btn-start" data-i18n="btn.start"></button>
<button class="btn btn-stop" id="btn-stop" data-i18n="btn.stop"></button>
<button class="btn" id="btn-restart" data-i18n="btn.restart"></button>
</div>
<div class="spacer"></div>
<label class="lang-picker">
<select class="lang-select" data-i18n-title="lang.label">
<option value="ru">Русский</option>
<option value="en">English</option>
</select>
</label>
<span class="user" id="current-user"></span>
<button class="btn btn-ghost" id="btn-logout">Выйти</button>
<button class="btn btn-ghost" id="btn-logout" data-i18n="btn.logout"></button>
</header>
<div id="task-banner" class="task-banner" hidden>
<span class="spinner"></span>
<span id="task-name"></span>
<button class="btn btn-ghost btn-sm" id="btn-task-cancel">Отменить</button>
<button class="btn btn-ghost btn-sm" id="btn-task-cancel" data-i18n="btn.cancel"></button>
</div>
<nav class="tabs" id="tabs">
<button class="tab active" data-tab="overview">Обзор</button>
<button class="tab" data-tab="console">Консоль</button>
<button class="tab" data-tab="config">Конфиг сервера</button>
<button class="tab" data-tab="sandbox">Песочница</button>
<button class="tab" data-tab="mods">Моды</button>
<button class="tab" data-tab="backups">Бэкапы</button>
<button class="tab" data-tab="profiles">Профили</button>
<button class="tab" data-tab="settings">Настройки</button>
<button class="tab active" data-tab="overview" data-i18n="tab.overview"></button>
<button class="tab" data-tab="console" data-i18n="tab.console"></button>
<button class="tab" data-tab="config" data-i18n="tab.config"></button>
<button class="tab" data-tab="sandbox" data-i18n="tab.sandbox"></button>
<button class="tab" data-tab="mods" data-i18n="tab.mods"></button>
<button class="tab" data-tab="backups" data-i18n="tab.backups"></button>
<button class="tab" data-tab="profiles" data-i18n="tab.profiles"></button>
<button class="tab" data-tab="settings" data-i18n="tab.settings"></button>
</nav>
<main class="content">
@@ -85,125 +99,123 @@
<section class="panel active" data-panel="overview">
<div class="cards">
<div class="card">
<h3>Состояние</h3>
<h3 data-i18n="overview.stateCard"></h3>
<div class="stat" id="ov-state"></div>
<div class="starting-note" id="ov-note"></div>
<div class="muted" id="ov-profile"></div>
<div class="muted" id="ov-uptime"></div>
<div class="muted" id="ov-pid"></div>
<div class="muted error" id="ov-lastexit"></div>
</div>
<div class="card">
<h3>Игроки онлайн</h3>
<h3 data-i18n="overview.playersCard"></h3>
<div class="stat" id="ov-players-count">0</div>
<ul class="player-list" id="ov-players"></ul>
</div>
<div class="card">
<h3>Процесс сервера</h3>
<div class="metric"><span>CPU</span><b id="ov-cpu"></b></div>
<div class="metric"><span>Память</span><b id="ov-rss"></b></div>
<div class="metric"><span>Потоки</span><b id="ov-threads"></b></div>
<h3 data-i18n="overview.processCard"></h3>
<div class="metric"><span data-i18n="overview.cpu"></span><b id="ov-cpu"></b></div>
<div class="metric"><span data-i18n="overview.memory"></span><b id="ov-rss"></b></div>
<div class="metric"><span data-i18n="overview.threads"></span><b id="ov-threads"></b></div>
</div>
<div class="card">
<h3>Хост</h3>
<div class="metric"><span>ОЗУ свободно</span><b id="ov-mem"></b></div>
<div class="metric"><span>Load average</span><b id="ov-load"></b></div>
<div class="metric"><span>Диск свободно</span><b id="ov-disk"></b></div>
<h3 data-i18n="overview.hostCard"></h3>
<div class="metric"><span data-i18n="overview.ramFree"></span><b id="ov-mem"></b></div>
<div class="metric"><span data-i18n="overview.load"></span><b id="ov-load"></b></div>
<div class="metric"><span data-i18n="overview.diskFree"></span><b id="ov-disk"></b></div>
</div>
</div>
<div class="card" id="install-card">
<h3>Серверные файлы</h3>
<h3 data-i18n="install.card"></h3>
<p id="install-state" class="muted"></p>
<button class="btn btn-primary" id="btn-install">Установить / обновить через SteamCMD</button>
<p class="muted small">Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль».</p>
<button class="btn btn-primary" id="btn-install" data-i18n="install.install"></button>
<p class="muted small" id="install-hint" data-i18n="install.hintInstall"></p>
</div>
</section>
<!-- Консоль -->
<section class="panel" data-panel="console">
<div class="console-toolbar">
<label class="checkbox"><input type="checkbox" id="console-autoscroll" checked> Прокручивать за выводом</label>
<input type="search" id="console-filter" placeholder="Фильтр по строке…" class="input-sm">
<button class="btn btn-ghost btn-sm" id="btn-console-clear">Очистить экран</button>
<label class="checkbox"><input type="checkbox" id="console-autoscroll" checked>
<span data-i18n="console.autoscroll"></span></label>
<input type="search" id="console-filter" data-i18n-placeholder="console.filter" class="input-sm">
<button class="btn btn-ghost btn-sm" id="btn-console-clear" data-i18n="console.clear"></button>
</div>
<pre id="console-output" class="console"></pre>
<form class="console-input" id="console-form">
<input type="text" id="console-command" placeholder="Команда сервера, например: players, save, quit"
autocomplete="off" spellcheck="false">
<button class="btn btn-primary" type="submit">Отправить</button>
<input type="text" id="console-command" data-i18n-placeholder="console.placeholder"
autocomplete="off" spellcheck="false" disabled>
<button class="btn btn-primary" type="submit" data-i18n="console.send" disabled></button>
</form>
<p class="muted small">Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg "текст"</code>,
<code>kickuser "ник"</code>, <code>banuser "ник"</code>, <code>checkModsNeedUpdate</code>.</p>
<p class="muted small" data-i18n-html="console.help"></p>
</section>
<!-- Конфиг сервера -->
<section class="panel" data-panel="config">
<div class="panel-head">
<div>
<h2>Конфигурация сервера</h2>
<h2 data-i18n="config.title"></h2>
<p class="muted small" id="config-path"></p>
</div>
<div>
<input type="search" id="config-filter" placeholder="Поиск параметра…" class="input-sm">
<button class="btn btn-primary" id="btn-config-save">Сохранить</button>
<input type="search" id="config-filter" data-i18n-placeholder="config.search" class="input-sm">
<button class="btn btn-primary" id="btn-config-save" data-i18n="btn.save" disabled></button>
</div>
</div>
<p class="muted" id="config-empty" hidden></p>
<div id="config-fields" class="fields"></div>
<div id="config-fields"></div>
</section>
<!-- Песочница -->
<section class="panel" data-panel="sandbox">
<div class="panel-head">
<div>
<h2>Настройки песочницы</h2>
<h2 data-i18n="sandbox.title"></h2>
<p class="muted small" id="sandbox-path"></p>
</div>
<div>
<input type="search" id="sandbox-filter" placeholder="Поиск параметра…" class="input-sm">
<button class="btn btn-primary" id="btn-sandbox-save">Сохранить</button>
<input type="search" id="sandbox-filter" data-i18n-placeholder="config.search" class="input-sm">
<button class="btn btn-primary" id="btn-sandbox-save" data-i18n="btn.save" disabled></button>
</div>
</div>
<p class="muted" id="sandbox-empty" hidden></p>
<div id="sandbox-fields" class="fields"></div>
<div id="sandbox-fields"></div>
</section>
<!-- Моды -->
<section class="panel" data-panel="mods">
<div class="panel-head">
<div>
<h2>Моды</h2>
<p class="muted small">Галочка включает мод, перетаскивание задаёт порядок загрузки.
Сервер сам скачивает моды из мастерской при запуске.</p>
<h2 data-i18n="mods.title"></h2>
<p class="muted small" data-i18n="mods.subtitle"></p>
</div>
<button class="btn btn-primary" id="btn-mods-save">Сохранить</button>
<button class="btn btn-primary" id="btn-mods-save" data-i18n="btn.save" disabled></button>
</div>
<p class="muted" id="mods-empty" hidden></p>
<div id="mods-body">
<form class="mod-add" id="mod-add-form">
<input type="text" id="mod-input" autocomplete="off"
placeholder="Ссылка на мод или коллекцию, либо просто ID">
<button class="btn" type="submit">Добавить мод</button>
<button class="btn" type="button" id="btn-add-collection">Добавить коллекцию</button>
<input type="text" id="mod-input" autocomplete="off" data-i18n-placeholder="mods.inputPlaceholder">
<button class="btn" type="submit" data-i18n="mods.add"></button>
<button class="btn" type="button" id="btn-add-collection" data-i18n="mods.addCollection"></button>
</form>
<p class="muted small">Коллекция разворачивается в список входящих в неё модов.
Сами файлы сервер скачивает сам при запуске — после этого моды можно включать галочками.</p>
<p class="muted small" data-i18n="mods.collectionHint"></p>
<div class="mod-toolbar">
<span class="muted small" id="mod-summary"></span>
<div class="spacer"></div>
<input type="search" id="mod-filter" class="input-sm" placeholder="Поиск по названию…">
<label class="checkbox"><input type="checkbox" id="mod-only-enabled"> Только включённые</label>
<input type="search" id="mod-filter" class="input-sm" data-i18n-placeholder="mods.search">
<label class="checkbox"><input type="checkbox" id="mod-only-enabled">
<span data-i18n="mods.onlyEnabled"></span></label>
</div>
<ul class="mod-list" id="mod-list"></ul>
<h3>Карты (Map)</h3>
<textarea id="map-list" rows="3" spellcheck="false"
placeholder="Например: Muldraugh, KY"></textarea>
<p class="muted small">Каждая карта с новой строки. Первой должна идти карта мода, последней — базовая.</p>
<h3 data-i18n="mods.mapsTitle"></h3>
<textarea id="map-list" rows="3" spellcheck="false" data-i18n-placeholder="mods.mapsPlaceholder"></textarea>
<p class="muted small" data-i18n="mods.mapsHint"></p>
</div>
</section>
@@ -211,17 +223,23 @@
<section class="panel" data-panel="backups">
<div class="panel-head">
<div>
<h2>Резервные копии</h2>
<h2 data-i18n="backups.title"></h2>
<p class="muted small" id="backup-dir"></p>
<p class="muted small">Бэкап снимается с активного профиля: его мир и конфиги.</p>
<p class="muted small" data-i18n="backups.note"></p>
</div>
<form id="backup-form">
<input type="text" id="backup-note" placeholder="Пометка (необязательно)" class="input-sm">
<button class="btn btn-primary" type="submit">Создать бэкап</button>
<input type="text" id="backup-note" data-i18n-placeholder="backups.notePlaceholder" class="input-sm">
<button class="btn btn-primary" type="submit" data-i18n="backups.create"></button>
</form>
</div>
<table class="table">
<thead><tr><th>Архив</th><th>Профиль</th><th>Размер</th><th>Создан</th><th></th></tr></thead>
<thead><tr>
<th data-i18n="backups.colArchive"></th>
<th data-i18n="backups.colProfile"></th>
<th data-i18n="backups.colSize"></th>
<th data-i18n="backups.colCreated"></th>
<th></th>
</tr></thead>
<tbody id="backup-rows"></tbody>
</table>
</section>
@@ -230,74 +248,121 @@
<section class="panel" data-panel="profiles">
<div class="panel-head">
<div>
<h2>Профили серверов</h2>
<p class="muted small">У каждого профиля свой мир, конфиг, песочница и набор модов.
Одновременно работает один — переключать можно на остановленном сервере.</p>
<h2 data-i18n="profiles.title"></h2>
<p class="muted small" data-i18n="profiles.subtitle"></p>
</div>
</div>
<div id="profile-cards" class="cards"></div>
<h3>Новый профиль</h3>
<h3 data-i18n="import.title"></h3>
<div class="card import-card">
<p class="muted small" data-i18n="import.fileHint"></p>
<input type="file" id="preset-file" accept=".zip">
<div id="preset-details" hidden>
<div class="cfg-field" id="preset-pick" hidden>
<label for="preset-set" data-i18n="import.set"></label>
<select id="preset-set"></select>
</div>
<div class="preset-summary" id="preset-summary"></div>
<div class="fields">
<div class="cfg-field">
<label for="preset-target" data-i18n="import.target"></label>
<select id="preset-target">
<option value="new" data-i18n="import.targetNew"></option>
<option value="existing" data-i18n="import.targetExisting"></option>
</select>
</div>
<div class="cfg-field" id="preset-new-fields">
<label for="preset-id" data-i18n="import.newID"></label>
<input type="text" id="preset-id" autocomplete="off">
<div class="hint" data-i18n="profiles.idHint"></div>
</div>
<div class="cfg-field" id="preset-existing-fields" hidden>
<label for="preset-profile" data-i18n="import.profile"></label>
<select id="preset-profile"></select>
<div class="hint" data-i18n="import.overwriteHint"></div>
</div>
</div>
<p class="muted small" data-i18n="import.keep"></p>
<div class="preset-keep">
<label class="checkbox"><input type="checkbox" data-keep="ports" checked>
<span data-i18n="import.keepPorts"></span></label>
<label class="checkbox"><input type="checkbox" data-keep="access" checked>
<span data-i18n="import.keepAccess"></span></label>
<label class="checkbox"><input type="checkbox" data-keep="identity" checked>
<span data-i18n="import.keepIdentity"></span></label>
</div>
<button class="btn btn-primary" id="btn-preset-import" data-i18n="import.apply"></button>
</div>
</div>
<h3 data-i18n="profiles.newTitle"></h3>
<form id="profile-add-form" class="fields">
<div class="cfg-field">
<label for="new-profile-id">Идентификатор</label>
<label for="new-profile-id" data-i18n="profiles.id"></label>
<input type="text" id="new-profile-id" placeholder="modded" autocomplete="off">
<div class="hint">Латиница, цифры, дефис. Станет именем конфига и папки мира.</div>
<div class="hint" data-i18n="profiles.idHint"></div>
</div>
<div class="cfg-field">
<label for="new-profile-title">Название</label>
<input type="text" id="new-profile-title" placeholder="Сборка с модами" autocomplete="off">
<div class="hint">Как профиль подписан в панели.</div>
<label for="new-profile-title" data-i18n="profiles.name"></label>
<input type="text" id="new-profile-title" data-i18n-placeholder="profiles.namePlaceholder" autocomplete="off">
<div class="hint" data-i18n="profiles.nameHint"></div>
</div>
<div class="cfg-field">
<label for="new-profile-memory">Память JVM</label>
<label for="new-profile-memory" data-i18n="profiles.memory"></label>
<input type="text" id="new-profile-memory" placeholder="8g" autocomplete="off">
<div class="hint">Применяется при запуске этого профиля.</div>
<div class="hint" data-i18n="profiles.memoryHint"></div>
</div>
<div class="cfg-field">
<label for="new-profile-copy">Скопировать настройки из</label>
<label for="new-profile-copy" data-i18n="profiles.copyFrom"></label>
<select id="new-profile-copy"></select>
<div class="hint">Копирует .ini и настройки песочницы. Мир останется новым.</div>
<div class="hint" data-i18n="profiles.copyHint"></div>
</div>
<div class="cfg-field">
<button class="btn btn-primary" type="submit">Создать профиль</button>
<button class="btn btn-primary" type="submit" data-i18n="profiles.create"></button>
</div>
</form>
</section>
<!-- Настройки -->
<section class="panel" data-panel="settings">
<h2>Версия панели</h2>
<h2 data-i18n="settings.versionTitle"></h2>
<div class="card update-card">
<div class="update-row">
<div>
<div class="stat" id="update-current"></div>
<p class="muted small" id="update-state">Проверяю обновления…</p>
<p class="muted small" id="update-state" data-i18n="update.checking"></p>
</div>
<div class="update-actions">
<button class="btn btn-sm" id="btn-update-check">Проверить</button>
<button class="btn btn-sm btn-primary" id="btn-update-apply" hidden>Обновить</button>
<button class="btn btn-sm" id="btn-manager-restart">Перезапустить панель</button>
<button class="btn btn-sm" id="btn-update-check" data-i18n="update.check"></button>
<button class="btn btn-sm btn-primary" id="btn-update-apply" data-i18n="update.apply" hidden></button>
<button class="btn btn-sm" id="btn-manager-restart" data-i18n="update.restart"></button>
</div>
</div>
<p class="muted small" id="update-manual" hidden></p>
<details id="update-notes" hidden>
<summary>Что нового</summary>
<pre class="release-notes" id="update-notes-body"></pre>
<summary data-i18n="update.whatsNew"></summary>
<div class="release-notes" id="update-notes-body"></div>
</details>
</div>
<h2>Настройки менеджера</h2>
<h2 data-i18n="settings.title"></h2>
<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" data-i18n="settings.save" disabled></button>
<h2>Пользователи панели</h2>
<h2 data-i18n="settings.usersTitle"></h2>
<ul class="user-list" id="user-list"></ul>
<form id="user-add-form" class="mod-add">
<input type="text" id="new-user-login" placeholder="Логин" autocomplete="off">
<input type="password" id="new-user-password" placeholder="Пароль (минимум 8 символов)" autocomplete="new-password">
<button class="btn" type="submit">Добавить пользователя</button>
<input type="text" id="new-user-login" data-i18n-placeholder="users.loginPlaceholder" autocomplete="off">
<input type="password" id="new-user-password" data-i18n-placeholder="users.passwordPlaceholder"
autocomplete="new-password">
<button class="btn" type="submit" data-i18n="users.add"></button>
</form>
</section>
@@ -305,6 +370,7 @@
</div>
<div id="toasts" class="toasts"></div>
<script src="/i18n.js"></script>
<script src="/app.js"></script>
</body>
</html>
+122 -8
View File
@@ -108,7 +108,11 @@ code {
background: var(--muted);
}
.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; }
/* Пояснение под состоянием — тем же цветом, что и пульсирующий индикатор:
пока он мигает, сервер ещё не принимает игроков. */
.starting-note { color: var(--warn); }
.dot.stopped { background: #5b636f; }
@keyframes pulse { 50% { opacity: .35; } }
@@ -267,6 +271,40 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
gap: 12px;
}
.cfg-group {
border: 1px solid var(--border);
border-radius: var(--radius);
background: var(--bg-soft);
margin-bottom: 10px;
}
.cfg-group > summary {
padding: 11px 14px;
cursor: pointer;
font-weight: 600;
font-size: 14px;
user-select: none;
list-style: none;
}
.cfg-group > summary::-webkit-details-marker { display: none; }
.cfg-group > summary::before {
content: "▸";
display: inline-block;
width: 14px;
color: var(--muted);
}
.cfg-group[open] > summary::before { content: "▾"; }
.cfg-group > summary:hover { background: var(--bg-card); border-radius: var(--radius); }
.cfg-count {
color: var(--muted);
font-weight: 400;
font-size: 12px;
margin-left: 4px;
}
.cfg-group > .fields { padding: 0 14px 14px; }
.cfg-field {
background: var(--bg-card);
border: 1px solid var(--border);
@@ -275,7 +313,17 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
}
.cfg-field.changed { border-color: var(--accent-dark); }
.cfg-field label { display: block; font-size: 13px; margin-bottom: 6px; }
.cfg-field .hint { color: var(--muted); font-size: 12px; margin-top: 5px; }
.cfg-field .hint {
color: var(--muted);
font-size: 12px;
margin-top: 5px;
/* Описания из конфига бывают в абзац: показываем начало, остальное — в
подсказке при наведении. */
display: -webkit-box;
-webkit-line-clamp: 3;
-webkit-box-orient: vertical;
overflow: hidden;
}
.cfg-field .key { color: var(--muted); font-family: var(--mono); font-size: 11px; }
/* ---------- Моды ---------- */
@@ -465,16 +513,82 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
.release-notes {
margin: 10px 0 0;
padding: 12px;
padding: 12px 14px;
background: var(--bg);
border: 1px solid var(--border);
border-radius: 8px;
max-height: 260px;
overflow: auto;
white-space: pre-wrap;
word-break: break-word;
font-size: 12.5px;
max-height: 240px;
/* Прокручивается сам блок, а не страница под ним. */
overflow-y: auto;
overscroll-behavior: contain;
font-size: 13px;
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); }
/* Переключатель языка: в шапке — только список, на экране входа — с подписью. */
.lang-picker {
display: inline-flex;
align-items: center;
gap: 8px;
font-size: 13px;
color: var(--muted);
}
.lang-picker select {
width: auto;
padding: 5px 10px;
font-size: 13px;
}
.lang-picker-auth {
justify-content: center;
margin-top: 18px;
width: 100%;
}
/* Импорт пресета: карточка с разбором архива и параметрами импорта. */
.import-card { margin-bottom: 20px; }
.import-card input[type=file] {
width: auto;
max-width: 100%;
margin: 4px 0 12px;
padding: 8px;
color: var(--text);
background: var(--bg-soft);
border: 1px dashed var(--border);
border-radius: var(--radius);
}
.preset-summary {
margin: 10px 0 14px;
padding: 10px 12px;
background: var(--bg-soft);
border-radius: var(--radius);
font-size: 13px;
line-height: 1.7;
}
.preset-keep { display: flex; flex-wrap: wrap; gap: 14px; margin: 6px 0 14px; }