Документация / Портал и доступ

Мастер настройки txAdmin

Все поля четырёх шагов, ограничения и повторная настройка.

Когда открывается мастер

При первом запуске FXServer.exe мастер открывается вместо обычной панели, если ещё нет локального владельца txAdmin. Стандартный адрес — http://127.0.0.1:40120. Не заменяйте его на публичный IP: мастер проверяет loopback-адрес, Host и источник запроса.

Для повторной настройки сначала остановите игровой процесс в панели и завершите монитор, затем запустите Configure-Server.cmd. Повторный мастер просит существующий пароль master-администратора txAdmin; он не создаёт нового владельца и не меняет пароль сам по себе.

Шаг 1. Администратор

Поле Требование
Логин 3–20 ASCII-символов: буквы, цифры, подчёркивания; точки и дефисы допустимы внутри, но не последним символом
Пароль Не менее 12 символов, не более 72 байт UTF-8, без пробелов по краям
Повтор пароля Должен точно совпадать; при повторной настройке не нужен

Длина в байтах отличается от числа символов для кириллицы и других Unicode-символов. Пароль хранится в виде хеша. Запишите логин и сохраните пароль в менеджере паролей. Не используйте пароль аккаунта сайта как обязательный шаблон: это отдельная локальная учётная запись.

При повторной настройке серия неправильных попыток приводит к временному ограничению. После пяти неудачных проверок мастер блокирует попытки примерно на минуту. Обновление страницы не заменяет правильный пароль.

Шаг 2. Сервер

Название: от 1 до 18 символов, без кавычек, обратной косой черты, точки с запятой и управляющих символов. Это ограничение мастера; в портале название карточки может быть длиннее.

Игровой порт: целое число от 1024 до 65535. Порт должен быть свободен по TCP и UDP. Нельзя использовать порт панели и диапазон 40120–40150. Обычно оставляют 30120.

Количество игроков: 1–128. Выберите значение, которое вы действительно проверили под нагрузкой; максимальное число в форме не гарантирует производительность.

Сеть: «Только этот компьютер» привязывает игру к 127.0.0.1; «Локальная сеть / интернет» — к 0.0.0.0. Второй вариант нужен для автоматической публикации. Выбор сети не создаёт правило firewall и не делает NAT автоматически.

OneSync: включён или выключен. Для базовой конфигурации оставляйте включённым. Фреймворк может требовать конкретного режима; управляйте им через профиль txAdmin, а не противоречащими друг другу строками в нескольких конфигах.

Выбор файлов

«Готовый базовый сервер» использует папку game из комплекта. «Моя папка с server.cfg и ресурсами» требует абсолютного ASCII-пути к существующему server-data, внутри которого есть server.cfg и resources.

Для существующей папки мастер сохраняет копию server.cfg.before-openm-…, удаляет прежние верхнеуровневые строки привязки TCP/UDP и подключение openm-server.cfg, затем добавляет своё подключение конфига. Остальное содержимое сохраняется. Мастер не анализирует все вложенные конфиги: старые endpoints внутри других файлов нужно проверить вручную. SQL-схему и зависимости режима он не устанавливает.

Шаг 3. Доступ игроков

Включите «У меня есть ID и ключ доступа сервера OpenM», вставьте ID из портала и ключ из блока «Ключ доступа игроков». Формат ключа — 43 символа. Данные другого сервера или публикационный seed не подходят.

Если отложить этот шаг, панель и игровой процесс могут работать, но вход игроков остаётся закрытым. Это режим подготовки сервера, а не обход центральной авторизации. Для автоматической публикации доступ игроков должен быть настроен.

На повторной настройке пустое поле ключа означает повторное использование сохранённого значения для того же ID. Если снимете флажок настройки доступа, мастер сохранит отключённый доступ и удалит локально используемый admission-файл. Перед такими изменениями подготовьте резервную копию.

Шаг 4. Каталог OpenM

Включите автоматическую публикацию, выберите publisher.json и .seed из одной карточки. Альтернативой загрузке .seed служит вставка его значения в поле ключа публикации. JSON ограничен 8 КиБ, seed-файл — 128 байт; обычные файлы портала существенно меньше этих пределов.

Мастер проверяет ID, keyId, допустимый origin каталога, публичный endpoint и формат seed. Он создаёт локальные пути заново, поэтому пути внутри скачанного JSON не используются как команды доступа к произвольным файлам.

Публичный адрес может включать внешний порт NAT, отличный от локального игрового порта. Оба должны вести к одному узлу: JSON содержит внешний endpoint, локальный probe издателя использует игровой порт из шага 2.

Сохранение и переход в панель

Перед сохранением проверяется возможность занять выбранный TCP/UDP-порт. Мастер записывает game/openm-server.cfg либо такой же файл в выбранной папке, профиль txData/default/config.json, собственные настройки и секреты. Локальный владелец создаётся после сохранения остальных данных.

Нажмите «Сохранить и открыть txAdmin» один раз. Дождитесь входной страницы и используйте созданные учётные данные. Если переход не состоялся, откройте адрес панели вручную и проверьте консоль. При ошибке не запускайте параллельно второй FXServer на тех же портах.

Контроль после изменения

Проверьте фактический игровой порт, ID в /info.json, состояние процесса, heartbeat accepted и новое подключение игрока. Изменение только текста в форме до сохранения ничего не применяет. Смена адреса в портале и изменение порта в мастере — отдельные операции, которые нужно согласовать по сетевому руководству.

В версии архива 1.1.3 некоторые подсказки ещё используют формулировку «настроенный шлюз». Центральный шлюз теперь подключает одобренные опубликованные серверы автоматически; отдельная заявка на маршрут не нужна. См. актуальное поведение шлюза.

Введите название, параметр или текст ошибки.

Esc — закрыть · Tab — выбрать результат