Установка в /opt и доступ к панели по сети

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

Адрес панели задаётся при установке (PZ_LISTEN), каталог и пользователь —
через PZ_HOME и PZ_USER. Конфиг создаётся только при первой установке,
поэтому повторный запуск установщика обновляет бинарник, не трогая
настройки, миры и учётки.

Адрес теперь занимается до автозапуска игрового сервера: если IP ещё не
поднят или порт занят, менеджер падает сразу с внятной ошибкой, а не
оставляет работающий сервер PZ без панели управления.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

README.md

@@ -47,7 +47,7 @@ systemd ──> pzmanager ──> start-server.sh ──> java (GameServer)
 
 ## Быстрый старт
 
-Собрать бинарник (нужен Go 1.24+):
+Собрать бинарник (нужен Go 1.24+; собирать можно на любой ОС, включая Windows):
 
 ```bash
 make build-linux
@@ -59,8 +59,30 @@ make build-linux
 sudo ./deploy/install.sh
 ```
 
-Установщик заведёт пользователя `pzserver`, поставит зависимости (SteamCMD,
-JRE, SDL2), положит бинарник в `/usr/local/bin` и включит systemd-юнит.
+Установщик заведёт системного пользователя `pzserver`, поставит зависимости
+(SteamCMD, JRE, SDL2), положит бинарник в `/usr/local/bin`, создаст структуру
+в `/opt/pzmanager` и включит systemd-юнит:
+
+```
+/opt/pzmanager/
+├── config.yaml     настройки менеджера
+├── data/           учётки панели и скачанный SteamCMD
+├── server/         серверные файлы Project Zomboid
+├── Zomboid/        миры, конфиги и логи игры
+└── backups/        архивы
+```
+
+Куда ставить и на каком адресе слушать, задаётся переменными окружения:
+
+```bash
+# панель доступна в локальной сети по адресу машины
+sudo PZ_LISTEN=10.10.1.142:8080 ./deploy/install.sh
+
+# другой каталог и пользователь
+sudo PZ_HOME=/srv/pz PZ_USER=zomboid ./deploy/install.sh
+```
+
+По умолчанию панель слушает `127.0.0.1:8080` — только с самой машины.
 
 Дальше:
 
@@ -70,29 +92,30 @@ JRE, SDL2), положит бинарник в `/usr/local/bin` и включи
    journalctl -u pzmanager -n 30 --no-pager
    ```
 
-2. Откройте панель. По умолчанию она слушает только `127.0.0.1:8080`, так что
-   зайти на неё можно через SSH-туннель:
+2. Откройте панель в браузере и создайте администратора, введя этот код.
+   Если панель слушает localhost, пробросьте порт:
 
    ```bash
    ssh -L 8080:127.0.0.1:8080 пользователь@сервер
    ```
 
-   Затем откройте <http://127.0.0.1:8080> и создайте администратора, введя код
-   из журнала.
-
 3. Во вкладке «Обзор» нажмите **Установить / обновить через SteamCMD** и
    дождитесь окончания — прогресс виден во вкладке «Консоль».
 
-4. Запустите сервер. При первом запуске PZ создаст `~/Zomboid/Server/*.ini` —
+4. Запустите сервер. При первом запуске PZ создаст `Zomboid/Server/*.ini` —
    после этого станут доступны вкладки «Конфиг сервера», «Песочница» и «Моды».
 
-Не забудьте открыть игровые порты:
+Порты, которые нужно открыть:
 
 ```bash
-sudo ufw allow 16261/udp
-sudo ufw allow 16262/udp
+sudo ufw allow 8080/tcp     # веб-панель, если она слушает не localhost
+sudo ufw allow 16261/udp    # игровой порт
+sudo ufw allow 16262/udp    # второй игровой порт
 ```
 
+Обновление ставится поверх: соберите новый бинарник и повторите
+`sudo ./deploy/install.sh` — конфиг, миры и учётки останутся на месте.
+
 ## Моды
 
 Project Zomboid хранит моды в двух строках конфига: `WorkshopItems` — что
@@ -160,6 +183,11 @@ Mod ID, который нужен серверу, лежит внутри сам
 **SSH-туннель (по умолчанию)** — ничего настраивать не нужно, панель слушает
 только localhost.
 
+**Доверенная локальная сеть** — `PZ_LISTEN=<ip>:8080` при установке или
+`listen` в конфиге. Учтите, что HTTP не шифруется: пароль от панели идёт по
+сети открытым текстом, так что для доступа через интернет этот вариант не
+годится.
+
 **HTTPS через reverse-proxy** — если панель нужна с телефона. Настройте nginx с
 сертификатом (например, от Let's Encrypt):
 
@@ -200,14 +228,15 @@ pzmanager users                  # список пользователей
 
 ## Конфигурация
 
-Файл `~/.config/pzmanager/config.yaml` создаётся при первом запуске. Всё, что в
-нём есть, правится и через вкладку «Настройки».
+Файл `/opt/pzmanager/config.yaml` создаёт установщик (при запуске без него
+менеджер возьмёт `~/.config/pzmanager/config.yaml`). Всё, что в нём есть,
+правится и через вкладку «Настройки».
 
 ```yaml
-listen: 127.0.0.1:8080          # адрес веб-панели
-data_dir: /home/pzserver/.local/share/pzmanager
-server_dir: /home/pzserver/pzserver   # куда SteamCMD ставит сервер
-zomboid_dir: /home/pzserver/Zomboid   # миры, конфиги и логи игры
+listen: 127.0.0.1:8080          # адрес веб-панели; 0.0.0.0 или IP — доступ по сети
+data_dir: /opt/pzmanager/data
+server_dir: /opt/pzmanager/server     # куда SteamCMD ставит сервер
+zomboid_dir: /opt/pzmanager/Zomboid   # миры, конфиги и логи игры
 steamcmd_path: ""               # пусто — найти в PATH или скачать
 profiles:                       # серверы: у каждого свой мир и настройки
   - id: vanilla                 # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla
@@ -224,7 +253,7 @@ autorestart: true               # поднимать сервер после п
 stop_timeout: 1m30s             # сколько ждать после quit до SIGTERM
 log_buffer_lines: 5000          # строк консоли в памяти
 backup:
-  dir: /home/pzserver/pzbackups
+  dir: /opt/pzmanager/backups
   schedule: 6h                  # 0 — отключить автобэкапы
   keep: 20                      # архивов на профиль
   stop_server: false            # останавливать сервер на время бэкапа