Профили серверов: несколько миров с раздельными настройками

Профиль — это отдельный сервер: свой мир, .ini, песочница, набор модов и
лимит памяти JVM. Project Zomboid различает их по -servername, поэтому
файлы профилей не пересекаются. Работает всегда один профиль: серверные
файлы, игровые порты и файл запуска JVM общие, так что переключение
разрешено только на остановленном сервере.

- config: список профилей вместо одиночных server_name/admin_password/
  java_memory; старые поля переносятся в первый профиль при загрузке;
- supervisor: запускает активный профиль и выставляет его -Xmx на каждом
  старте, потому что файл запуска общий;
- бэкапы: архив снимается с одного профиля (мир + его конфиги), имя
  профиля попадает в имя файла, ротация считается по профилям;
- API профилей: список, создание с копированием настроек из другого
  профиля, правка, удаление и переключение активного;
- панель: селектор профиля в шапке и вкладка со списком профилей.

Удаление профиля убирает его только из панели: мир и конфиги остаются на
диске, чтобы случайное нажатие не стоило сохранений.

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

internal/api/handlers_config.go

@@ -111,27 +111,22 @@ func (s *Server) handlePutSandbox(w http.ResponseWriter, r *http.Request) {
 }
 
 // managerConfigDTO — вид конфига менеджера, удобный для формы в браузере:
-// длительности в секундах, пароль наружу не отдаётся.
+// длительности в секундах. Всё, что относится к конкретному серверу (имя,
+// пароль админа, память JVM), живёт в профилях и правится отдельно.
 type managerConfigDTO struct {
-	Listen             string   `json:"listen"`
-	ServerDir          string   `json:"server_dir"`
-	ZomboidDir         string   `json:"zomboid_dir"`
-	SteamCMDPath       string   `json:"steamcmd_path"`
-	ServerName         string   `json:"server_name"`
-	JavaMemory         string   `json:"java_memory"`
-	ExtraArgs          []string `json:"extra_args"`
-	AutoStart          bool     `json:"autostart"`
-	AutoRestart        bool     `json:"autorestart"`
-	StopTimeoutSec     int64    `json:"stop_timeout_sec"`
-	LogBufferLines     int      `json:"log_buffer_lines"`
-	BackupDir          string   `json:"backup_dir"`
-	BackupScheduleMin  int64    `json:"backup_schedule_min"`
-	BackupKeep         int      `json:"backup_keep"`
-	BackupStopServer   bool     `json:"backup_stop_server"`
-	HasAdminPassword   bool     `json:"has_admin_password"`
-	AdminPassword      string   `json:"admin_password,omitempty"`
-	ConfigPath         string   `json:"config_path"`
-	RequiresRestartMsg string   `json:"requires_restart_msg,omitempty"`
+	Listen            string `json:"listen"`
+	ServerDir         string `json:"server_dir"`
+	ZomboidDir        string `json:"zomboid_dir"`
+	SteamCMDPath      string `json:"steamcmd_path"`
+	AutoStart         bool   `json:"autostart"`
+	AutoRestart       bool   `json:"autorestart"`
+	StopTimeoutSec    int64  `json:"stop_timeout_sec"`
+	LogBufferLines    int    `json:"log_buffer_lines"`
+	BackupDir         string `json:"backup_dir"`
+	BackupScheduleMin int64  `json:"backup_schedule_min"`
+	BackupKeep        int    `json:"backup_keep"`
+	BackupStopServer  bool   `json:"backup_stop_server"`
+	ConfigPath        string `json:"config_path"`
 }
 
 func (s *Server) handleGetManagerConfig(w http.ResponseWriter, r *http.Request) {
@@ -141,9 +136,6 @@ func (s *Server) handleGetManagerConfig(w http.ResponseWriter, r *http.Request)
 		ServerDir:         c.ServerDir,
 		ZomboidDir:        c.ZomboidDir,
 		SteamCMDPath:      c.SteamCMDPath,
-		ServerName:        c.ServerName,
-		JavaMemory:        c.JavaMemory,
-		ExtraArgs:         c.ExtraArgs,
 		AutoStart:         c.AutoStart,
 		AutoRestart:       c.AutoRestart,
 		StopTimeoutSec:    c.StopTimeout.Seconds(),
@@ -152,14 +144,11 @@ func (s *Server) handleGetManagerConfig(w http.ResponseWriter, r *http.Request)
 		BackupScheduleMin: int64(c.Backup.Schedule.Duration().Minutes()),
 		BackupKeep:        c.Backup.Keep,
 		BackupStopServer:  c.Backup.StopServer,
-		HasAdminPassword:  c.AdminPassword != "",
 		ConfigPath:        c.Path(),
 	})
 }
 
-// handlePutManagerConfig сохраняет настройки менеджера. Пустой admin_password
-// означает "оставить прежний", иначе его нельзя было бы не потерять при
-// каждом сохранении формы.
+// handlePutManagerConfig сохраняет общие настройки менеджера.
 func (s *Server) handlePutManagerConfig(w http.ResponseWriter, r *http.Request) {
 	var dto managerConfigDTO
 	if !decodeJSON(w, r, &dto) {
@@ -171,13 +160,6 @@ func (s *Server) handlePutManagerConfig(w http.ResponseWriter, r *http.Request)
 	c.ServerDir = dto.ServerDir
 	c.ZomboidDir = dto.ZomboidDir
 	c.SteamCMDPath = dto.SteamCMDPath
-	c.ServerName = dto.ServerName
-	c.JavaMemory = dto.JavaMemory
-	// Пустой список аргументов от формы означает "не трогать": ExtraArgs
-	// правятся только через файл конфигурации.
-	if dto.ExtraArgs != nil {
-		c.ExtraArgs = dto.ExtraArgs
-	}
 	c.AutoStart = dto.AutoStart
 	c.AutoRestart = dto.AutoRestart
 	c.LogBufferLines = dto.LogBufferLines
@@ -188,9 +170,6 @@ func (s *Server) handlePutManagerConfig(w http.ResponseWriter, r *http.Request)
 		c.StopTimeout = config.Duration(time.Duration(dto.StopTimeoutSec) * time.Second)
 	}
 	c.Backup.Schedule = config.Duration(time.Duration(dto.BackupScheduleMin) * time.Minute)
-	if dto.AdminPassword != "" {
-		c.AdminPassword = dto.AdminPassword
-	}
 
 	if err := c.Save(); err != nil {
 		writeError(w, http.StatusInternalServerError, err.Error())

internal/api/handlers_profiles.go

@@ -0,0 +1,223 @@
+package api
+
+import (
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+
+	"github.com/mrleo1nid/pzmanager/internal/config"
+	"github.com/mrleo1nid/pzmanager/internal/pzserver"
+)
+
+// profileDTO — профиль в том виде, в каком его показывает панель. Пароль
+// наружу не отдаётся, только признак того, что он задан.
+type profileDTO struct {
+	ID               string   `json:"id"`
+	Title            string   `json:"title"`
+	JavaMemory       string   `json:"java_memory"`
+	ExtraArgs        []string `json:"extra_args"`
+	HasAdminPassword bool     `json:"has_admin_password"`
+	AdminPassword    string   `json:"admin_password,omitempty"`
+	// Признаки состояния на диске: по ним панель подсказывает, что профиль
+	// ещё ни разу не запускался.
+	HasConfig  bool `json:"has_config"`
+	WorldReady bool `json:"world_ready"`
+	Active     bool `json:"active"`
+	// CopyFrom заполняется только при создании профиля.
+	CopyFrom string `json:"copy_from,omitempty"`
+}
+
+func (s *Server) profileToDTO(p config.Profile) profileDTO {
+	return profileDTO{
+		ID:               p.ID,
+		Title:            p.Title,
+		JavaMemory:       p.JavaMemory,
+		ExtraArgs:        p.ExtraArgs,
+		HasAdminPassword: p.AdminPassword != "",
+		HasConfig:        fileExists(s.cfg.ServerConfigPathFor(p.ID)),
+		WorldReady:       fileExists(s.cfg.WorldDirFor(p.ID)),
+		Active:           p.ID == s.cfg.Active,
+	}
+}
+
+func (s *Server) handleListProfiles(w http.ResponseWriter, r *http.Request) {
+	profiles := make([]profileDTO, 0, len(s.cfg.Profiles))
+	for _, p := range s.cfg.Profiles {
+		profiles = append(profiles, s.profileToDTO(p))
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"profiles": profiles,
+		"active":   s.cfg.Active,
+		// Переключать профиль можно только на остановленном сервере.
+		"can_switch": s.sup.State() == pzserver.StateStopped,
+	})
+}
+
+// handleCreateProfile заводит новый профиль и, если попросили, копирует в него
+// конфиг и настройки песочницы существующего.
+func (s *Server) handleCreateProfile(w http.ResponseWriter, r *http.Request) {
+	var dto profileDTO
+	if !decodeJSON(w, r, &dto) {
+		return
+	}
+
+	profile := config.Profile{
+		ID:            dto.ID,
+		Title:         dto.Title,
+		JavaMemory:    dto.JavaMemory,
+		ExtraArgs:     dto.ExtraArgs,
+		AdminPassword: dto.AdminPassword,
+	}
+	if err := s.cfg.AddProfile(profile); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+
+	if dto.CopyFrom != "" {
+		if err := s.copyProfileConfigs(dto.CopyFrom, profile.ID); err != nil {
+			// Профиль уже добавлен в память — откатываем, чтобы не остался
+			// наполовину настроенный.
+			_ = s.cfg.DeleteProfile(profile.ID)
+			writeError(w, http.StatusBadRequest, err.Error())
+			return
+		}
+	}
+
+	if err := s.cfg.Save(); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	s.sup.AppendLog("manager", fmt.Sprintf("Создан профиль %q", profile.Name()))
+	writeJSON(w, http.StatusCreated, s.profileToDTO(profile))
+}
+
+// copyProfileConfigs дублирует .ini и SandboxVars.lua исходного профиля под
+// именем нового: так новый сервер стартует с уже знакомыми настройками и
+// списком модов, но со своим миром.
+func (s *Server) copyProfileConfigs(from, to string) error {
+	if _, ok := s.cfg.Profile(from); !ok {
+		return fmt.Errorf("профиль-источник %q не найден", from)
+	}
+	pairs := [][2]string{
+		{s.cfg.ServerConfigPathFor(from), s.cfg.ServerConfigPathFor(to)},
+		{s.cfg.SandboxConfigPathFor(from), s.cfg.SandboxConfigPathFor(to)},
+	}
+	copied := 0
+	for _, pair := range pairs {
+		err := copyFile(pair[0], pair[1])
+		if os.IsNotExist(err) {
+			continue
+		}
+		if err != nil {
+			return fmt.Errorf("скопировать настройки: %w", err)
+		}
+		copied++
+	}
+	if copied == 0 {
+		return fmt.Errorf("у профиля %q ещё нет файлов настроек — сначала запустите его хотя бы раз", from)
+	}
+	s.sup.AppendLog("manager", fmt.Sprintf("Настройки профиля %q скопированы в %q", from, to))
+	return nil
+}
+
+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, "профиль не найден")
+		return
+	}
+
+	var dto profileDTO
+	if !decodeJSON(w, r, &dto) {
+		return
+	}
+
+	updated := config.Profile{
+		ID:         id,
+		Title:      dto.Title,
+		JavaMemory: dto.JavaMemory,
+		ExtraArgs:  dto.ExtraArgs,
+		// Пустой пароль означает "оставить прежний": наружу мы его не отдаём,
+		// и форма присылает пустую строку, пока его не меняли.
+		AdminPassword: current.AdminPassword,
+	}
+	if dto.AdminPassword != "" {
+		updated.AdminPassword = dto.AdminPassword
+	}
+
+	if err := s.cfg.UpdateProfile(id, updated); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.cfg.Save(); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+
+	note := "Профиль сохранён"
+	if s.sup.State() != pzserver.StateStopped && id == s.cfg.Active {
+		note = "Профиль сохранён. Память и аргументы запуска применятся после перезапуска сервера."
+	}
+	writeJSON(w, http.StatusOK, map[string]any{"saved": true, "note": note})
+}
+
+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())
+		return
+	}
+	if err := s.cfg.Save(); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	s.sup.AppendLog("manager", fmt.Sprintf(
+		"Профиль %q удалён из панели. Мир и конфиги остались на диске: %s",
+		id, s.cfg.WorldDirFor(id)))
+	writeJSON(w, http.StatusOK, map[string]any{"deleted": id})
+}
+
+// handleActivateProfile переключает активный профиль. Делать это на живом
+// сервере нельзя: профили делят игровые порты и файлы запуска.
+func (s *Server) handleActivateProfile(w http.ResponseWriter, r *http.Request) {
+	if s.sup.State() != pzserver.StateStopped {
+		writeError(w, http.StatusConflict, "сначала остановите игровой сервер")
+		return
+	}
+	id := r.PathValue("id")
+	if err := s.cfg.SetActive(id); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.cfg.Save(); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	s.sup.AppendLog("manager", fmt.Sprintf("Активный профиль: %s", s.cfg.ActiveProfile().Name()))
+	writeJSON(w, http.StatusOK, map[string]any{"active": id})
+}
+
+func copyFile(src, dst string) error {
+	in, err := os.Open(src)
+	if err != nil {
+		return err
+	}
+	defer in.Close()
+
+	// O_EXCL: перезаписывать чужой конфиг при создании профиля нельзя.
+	out, err := os.OpenFile(dst, os.O_CREATE|os.O_EXCL|os.O_WRONLY, 0o644)
+	if err != nil {
+		return err
+	}
+	defer out.Close()
+
+	_, err = io.Copy(out, in)
+	return err
+}
+
+func fileExists(p string) bool {
+	_, err := os.Stat(p)
+	return err == nil
+}

internal/api/handlers_tasks.go

@@ -58,23 +58,49 @@ func (s *Server) handleListBackups(w http.ResponseWriter, r *http.Request) {
 		writeError(w, http.StatusInternalServerError, err.Error())
 		return
 	}
-	writeJSON(w, http.StatusOK, map[string]any{"backups": archives, "dir": s.backups.Dir()})
+	// Фильтр по профилю необязателен: панель показывает архивы всех профилей,
+	// помечая каждый, но умеет и сузить список.
+	if profile := r.URL.Query().Get("profile"); profile != "" {
+		filtered := archives[:0]
+		for _, a := range archives {
+			if a.Profile == profile {
+				filtered = append(filtered, a)
+			}
+		}
+		archives = filtered
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"backups": archives,
+		"dir":     s.backups.Dir(),
+		"active":  s.cfg.Active,
+	})
 }
 
 func (s *Server) handleCreateBackup(w http.ResponseWriter, r *http.Request) {
 	var body struct {
-		Note string `json:"note"`
+		Note    string `json:"note"`
+		Profile string `json:"profile"`
 	}
 	if r.ContentLength > 0 && !decodeJSON(w, r, &body) {
 		return
 	}
+	if body.Profile == "" {
+		body.Profile = s.cfg.Active
+	}
+	if _, ok := s.cfg.Profile(body.Profile); !ok {
+		writeError(w, http.StatusBadRequest, "профиль не найден")
+		return
+	}
+	// Живой сервер держит мир в памяти, и снимок чужого профиля тут ни при
+	// чём: остановка нужна только для профиля, который сейчас работает.
+	profileIsRunning := body.Profile == s.cfg.Active && s.sup.State() != pzserver.StateStopped
 
-	name := "Резервное копирование мира"
+	name := "Резервное копирование мира: " + body.Profile
 	err := s.jobs.Start(name, func(ctx context.Context, log func(string)) error {
 		// Опциональная остановка сервера даёт согласованный снимок: PZ
 		// сбрасывает мир на диск только при сохранении.
 		restart := false
-		if s.cfg.Backup.StopServer && s.sup.State() != pzserver.StateStopped {
+		if s.cfg.Backup.StopServer && profileIsRunning {
 			log("Останавливаю сервер перед бэкапом")
 			if err := s.sup.Stop(); err != nil && !errors.Is(err, pzserver.ErrNotRunning) {
 				return err
@@ -82,7 +108,7 @@ func (s *Server) handleCreateBackup(w http.ResponseWriter, r *http.Request) {
 			restart = true
 		}
 
-		_, err := s.backups.Create(ctx, log, body.Note)
+		_, err := s.backups.Create(ctx, log, body.Profile, body.Note)
 
 		if restart {
 			log("Поднимаю сервер обратно")
@@ -144,13 +170,19 @@ func (s *Server) handleRestoreBackup(w http.ResponseWriter, r *http.Request) {
 		writeError(w, http.StatusBadRequest, err.Error())
 		return
 	}
+	// Страховочную копию снимаем с того профиля, поверх которого ляжет архив;
+	// у старых архивов профиль в имени не записан — берём активный.
+	restoreProfile := s.backups.ProfileOf(name)
+	if _, ok := s.cfg.Profile(restoreProfile); !ok {
+		restoreProfile = s.cfg.Active
+	}
 
 	taskName := "Восстановление из архива " + name
 	err := s.jobs.Start(taskName, func(ctx context.Context, log func(string)) error {
 		// Перед перезаписью снимаем страховочную копию текущего состояния:
 		// восстановление не туда — самая дорогая ошибка в этой панели.
 		log("Делаю страховочный бэкап текущего мира")
-		if _, err := s.backups.Create(ctx, log, "pre-restore"); err != nil {
+		if _, err := s.backups.Create(ctx, log, restoreProfile, "pre-restore"); err != nil {
 			return fmt.Errorf("страховочный бэкап не создан, восстановление отменено: %w", err)
 		}
 		return s.backups.Restore(ctx, log, name)
@@ -185,9 +217,10 @@ func StartBackupScheduler(ctx context.Context, s *Server) {
 					s.sup.AppendLog("manager", "Плановый бэкап пропущен: выполняется другая задача")
 					continue
 				}
-				err := s.jobs.Start("Плановое резервное копирование",
+				profile := s.cfg.Active
+				err := s.jobs.Start("Плановое резервное копирование: "+profile,
 					func(ctx context.Context, log func(string)) error {
-						_, err := s.backups.Create(ctx, log, "auto")
+						_, err := s.backups.Create(ctx, log, profile, "auto")
 						return err
 					})
 				if err != nil && !errors.Is(err, job.ErrBusy) {
@@ -198,15 +231,17 @@ func StartBackupScheduler(ctx context.Context, s *Server) {
 	}()
 }
 
-// applyJavaMemory переносит лимит памяти из конфига менеджера в файл запуска
+// applyJavaMemory переносит лимит памяти активного профиля в файл запуска
 // сервера. Вызывается после установки: SteamCMD перезаписывает этот файл.
+// При обычном старте то же самое делает супервизор.
 func (s *Server) applyJavaMemory(log func(string)) error {
-	if s.cfg.JavaMemory == "" {
+	profile := s.cfg.ActiveProfile()
+	if profile.JavaMemory == "" {
 		return nil
 	}
-	if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, s.cfg.JavaMemory); err != nil {
+	if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil {
 		return err
 	}
-	log("Лимит памяти JVM выставлен: " + s.cfg.JavaMemory)
+	log("Лимит памяти JVM выставлен: " + profile.JavaMemory)
 	return nil
 }

internal/api/server.go

@@ -95,6 +95,11 @@ func (s *Server) Handler() http.Handler {
 		"PUT /api/config/sandbox":          s.handlePutSandbox,
 		"GET /api/config/manager":          s.handleGetManagerConfig,
 		"PUT /api/config/manager":          s.handlePutManagerConfig,
+		"GET /api/profiles":                s.handleListProfiles,
+		"POST /api/profiles":               s.handleCreateProfile,
+		"PUT /api/profiles/{id}":           s.handleUpdateProfile,
+		"DELETE /api/profiles/{id}":        s.handleDeleteProfile,
+		"POST /api/profiles/{id}/activate": s.handleActivateProfile,
 		"GET /api/mods":                    s.handleGetMods,
 		"PUT /api/mods":                    s.handlePutMods,
 		"POST /api/mods/lookup":            s.handleLookupMods,