Перейти к содержанию

Как управлять сервером Valheim через веб-панель

Выбор standalone или Windows-агента, административный пароль, защищённый удалённый доступ и диагностика связи панели с модом.
Версия не проверена

Valheim Admin от NeocorDK добавляет веб-консоль и административную панель к выделенному серверу. Для Linux и арендуемого хостинга панель обслуживает мод; для собственного Windows-сервера предусмотрен отдельный агент. Выбор режима определяет, сможете ли вы запускать процесс игры из браузера.

Выберите режим

Возможность · Linux или арендуемый хостинг · Свой Windows-сервер с агентом
ВозможностьLinux или арендуемый хостингСвой Windows-сервер с агентом
Консоль, журнал, управление игроками, конфигиЧерез модЧерез мод и агент
Запуск, остановка, watchdog, обновленияОстаются за панелью хостинга или владельцем процессаПоддерживаются агентом
Панель при выключенном игровом сервереНедоступнаДоступна, пока работает агент
Информация
Сохранённый README не закреплён за точным номером релиза. Агент и мод должны соответствовать друг другу по версии; работу последней сборки, интерфейс и сетевую доступность мы не проверяли. Агент описан только для Windows.

Linux и арендуемый сервер: standalone

  1. Убедитесь, что сервер использует BepInEx и хостинг позволяет выделить дополнительный TCP-порт. Установите ValheimAdmin через менеджер либо поместите ValheimAdmin.dll в серверный BepInEx/plugins.
  2. После первого запуска найдите в BepInEx-журнале строку Web panel admin password. Это административный пароль; не публикуйте его вместе с адресом карты.
  3. По умолчанию панель слушает TCP 8095. Если хостинг выдал другой порт, задайте его в [Web] Port файла BepInEx/config/neocor.ValheimAdmin.cfg и настройте соответствующий доступ на стороне хостинга.
  4. Откройте адрес панели с выбранным портом. Для административного входа через интернет предварительно используйте HTTPS/TLS; обычный HTTP передаёт пароль незашифрованным.

Если хотите задать собственный пароль standalone-панели, README указывает [Web] AdminPassword в neocor.ValheimAdmin.cfg: при следующем запуске значение заменяется хешем. Описанный мод не заменяет средства запуска и остановки игрового процесса у Linux-хостинга.

Windows: настройка агента

  1. Распакуйте Windows x64-пакет ValheimAdmin из релизов автора. Установите mod/ValheimAdmin.dll в серверный BepInEx/plugins.
  2. Остановите прежний запуск сервера через .bat: в этой схеме процессом должен управлять агент, а не две параллельные программы.
  3. Запустите agent/ValheimAdmin.Agent.exe один раз для создания agent.json и случайного пароля. Сохраните пароль приватно и закройте агент перед редактированием.
  4. Укажите ServerDir с valheim_server.exe и реальные значения Server: имя, мир, пароль и порт. В JSON используйте удвоенные обратные слеши или прямые /.
  5. Оставляйте AutoStart = false, пока настройки содержат заглушки. Когда они проверены, включите AutoStart при необходимости. PanelPassword позволяет задать собственный пароль, который при следующем старте заменяется хешем.
  6. Снова запустите агент и откройте http://127.0.0.1:8095 на этом компьютере. Это локальная проверка, а не адрес для игроков из интернета.

Удалённый доступ и границы публичной карты

По умолчанию агент принимает подключения на 127.0.0.1 и адресе Tailscale. Для своих устройств автор предлагает доступ через Tailscale. Если нужен открытый интернет-доступ, используйте HTTPS в agent.json с PFX-сертификатом либо обратный прокси с TLS; не входите административным паролем через публичный HTTP.

Для доступа к агенту с других сетевых адресов в README предусмотрены BindAddresses и разрешение выбранного TCP-порта в firewall; доступ из интернета может требовать настройки маршрутизатора. Не смешивайте этот адрес с локальным BridgePort: агент и мод связываются через 127.0.0.1 и общий секрет.

Карта открывается без входа. По умолчанию публично видны исследованные области, игроки с включённым Visible on map и сделанные публичными метки. Проверьте параметры [Map] Public… перед тем, как делиться адресом. Наличие пароля админки не делает всю страницу и все слои карты приватными.

Первая проверка административной консоли

  1. Откройте Admin sign-in внизу меню и войдите административным паролем.
  2. В Console начните с help или диагностических status, players, plugins, описанных автором. Сверьте ответ с тем сервером, которым собираетесь управлять.
  3. Обычная команда выполняется на сервере. Форма @Player <command> относится к игре выбранного игрока и требует соответствующего клиентского мода и разрешения AllowServerCommands.
  4. Не используйте выдачу предметов или чит-команды как нейтральную проверку связи: README предупреждает, что чит-команды отмечают персонажа и влияют на достижения.

Если панель или связь с модом не работает

Симптом · Проверка по README
СимптомПроверка по README
Standalone-панель не открываетсяРазрешён ли выбранный TCP-порт; есть ли в BepInEx-журнале Web panel (standalone mode) listening
mod not connectedЛежит ли ValheimAdmin.dll в серверном BepInEx/plugins и загружает ли её BepInEx; проверьте LogOutput.log
Versions differОбновлены ли агент и мод вместе
Ошибка JSON при старте агентаНе остались ли одиночные обратные слеши в путях agent.json
Карта offline или preparingДождитесь загрузки мира и первичной отрисовки; автор описывает её как отдельный этап

Если административный пароль потерян

Для собственного Windows-агента автор указывает ValheimAdmin.Agent.exe --set-password <new>. Для standalone-хостинга — новый [Web] AdminPassword и очистку [Web] AdminPasswordHash в конфигурации мода. Это действия владельца установки: не публикуйте реальные пароли в примерах, общей конфигурации или сообщениях игрокам.

Информация
Гайд описывает действия по первичному README и не разворачивает панель, не меняет порты, пароли или сохранения. Клиентский мод для обычного подключения игроков необязателен, но отдельные функции — snapshots, восстановление и команды на клиенте — требуют его и разрешений. Не переносите эти условия на весь функционал без проверки.

Гайд был полезен?