RCON в Valheim: удалённое администрирование без встроенной консоли

В ванильном Valheim нет RCON. Выделенный сервер не открывает порт удалённой консоли и не читает команды, набранные в его собственный стандартный ввод, - поэтому консоль на хостинговой панели показывает лог, но не может выполнить kick или save. Удалённое администрирование немодифицированного сервера - это три вещи: админские команды, которые вводит в игре игрок из adminlist.txt, правка трёх файлов списков (которые сервер перечитывает на ходу) и управление самим процессом - запуск, остановка и перезапуск - из панели, по SSH или через Docker. Если нужны настоящие удалённые команды, мод BepInEx добавляет защищённый паролем слушатель Source RCON; сейчас актуальный - RCON Next. Он работает, но это незашифрованная админская лазейка на порту TCP, и относиться к ней нужно соответственно.

В этом руководстве разбирается каждый вариант, что он умеет и чего не умеет, и как выбрать.

Что даёт ванильный Valheim#

Пришедшие из Minecraft или Rust ждут консоли сервера, принимающей команды, и удалённого протокола, делающего то же по сети. В Valheim нет ни того ни другого. Вместо этого есть:

Любое админское действие, которое вам когда-либо понадобится на ванильном сервере, умещается в одну из этих строк. Ограничение в том, что для команд нужен человек в игре. Без мода нельзя выполнить save или kick в три часа ночи из скрипта.

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

Админская консоль в игре#

Настоящая админская консоль находится на клиенте. Игрок, чей ID есть в adminlist.txt, открывает её клавишей F5 - после добавления -console в параметры запуска игры в Steam, что и разблокирует клавишу, - и команды выполняются на сервере, к которому он подключён.

kick Ragnarban 76561198012345678unban 76561198012345678bannedsaveinfo

kick и ban принимают имя персонажа, IP или ID пользователя; надёжнее всего ID, потому что имена не уникальны. save немедленно принудительно сохраняет мир, и это стоит делать перед чем-либо рискованным. Полный список, включая то, что каждая команда реально делает на выделенном сервере, есть в справочнике консольных команд администратора Valheim.

Чит-команды - devcommands, god, fly, spawn - на ванильном выделенном сервере не работают даже у админов. Server Devcommands от JereKuusela включает их, добавляет собственные команды, например broadcast, и имеет настройки прав, определяющие, кто из админов что может. Это по-прежнему инструмент внутри игры: кто-то должен быть подключён, чтобы вводить команды. Его настройка описана в статье Server Devcommands на выделенном сервере.

Администрирование через файлы списков#

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

// Griefed the shared smelter, 2026-10-0276561198087654321// Crossplay server: platform-prefixed IDXbox_2535412345678901

Строки, начинающиеся с //, - комментарии, и это место, где стоит записать, почему человек попал в список. Что каждый файл позволяет делать извне игры:

• Забанить кого-то удалённо: добавьте его ID в bannedlist.txt. Это блокирует следующее подключение. Если игрок сейчас в сети, дополнительно выкиньте его в игре или перезапустите сервер - не думайте, что правка файла убирает уже подключённого игрока.
• Закрыть сервер для знакомых игроков: поместите ID в permittedlist.txt. Как только в файле появляется хоть один ID, зайти могут только перечисленные игроки. Очистите файл, чтобы открыть сервер снова.
• Выдать или отозвать права админа: правьте adminlist.txt. Игроку, которого повысили во время подключения, может понадобиться переподключиться, прежде чем консоль примет его команды.

На кроссплей-сервере ID имеют префикс платформы (Steam_, Xbox_), и голый SteamID64, работающий на сервере только для Steam, не совпадёт. Надёжный способ получить точный вид - пусть игрок один раз подключится, и скопируйте ID из лога сервера. Форматы и расположение файлов на каждой платформе описаны в статье Списки админов, банов и допущенных игроков.

Консоли панелей, SSH и systemd#

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

На панели, построенной на Pterodactyl и Wings, вкладка консоли в реальном времени показывает вывод сервера и содержит кнопки питания. Туда можно печатать, но ванильный Valheim игнорирует набранное - на сервере нечему читать ввод. Это удивляет в первый раз, и неисправностью панели не является. Кнопка остановки в панели отправляет прерывание, которое нужно серверу, чтобы сохраниться перед выходом.

На вашей собственной Linux-машине SSH плюс systemd дают те же возможности:

$ sudo systemctl stop valheim        # clean stop, world saved first$ sudo systemctl restart valheim$ journalctl -u valheim -f           # live log$ nano ~/.config/unity3d/IronGate/Valheim/bannedlist.txt

Последний путь - каталог сохранений по умолчанию для сервера, запущенного от этого пользователя в Linux; если вы запускаете сервер с -savedir, файлы списков лежат в этой папке. Значения по умолчанию для каждой конфигурации перечислены в статье Каталог сохранений Valheim и расположение файлов.

Юнит должен останавливать сервер сигналом SIGINT и давать ему время на запись, иначе удалённый "перезапуск" превращается в потерянные полчаса игры. Настройки есть в статье Valheim как сервис systemd.

Некоторые запускают сервер внутри tmux или screen, чтобы "подключаться к консоли". Это даёт лог в терминале и Ctrl+C для чистой остановки, но не даёт команд - по той же причине, что описана выше. Это не стоит потери автоматических перезапусков, которые даёт сервис.

Docker exec и контейнер#

В Docker docker exec даёт оболочку внутри контейнера, что полезно для файлов и управления процессом, но не для игровых команд.

$ docker compose logs -f valheim                     # the server log$ docker exec -it valheim bash                       # a shell in the container$ docker compose restart valheim                     # clean restart

В образе lloesche/valheim-server сервер, обновлятор и задача бэкапа работают под supervisord, поэтому внутри контейнера supervisorctl status показывает каждый из них, а supervisorctl restart valheim-server перезапускает только игру. Файлы списков лежат в /config, который смонтирован с хоста, поэтому обычно проще править их прямо на хосте. Если названия процессов не совпадают, сверьтесь с README образа.

Задайте для сервиса stop_grace_period в минуту-две. Десяти секунд, которые Docker использует по умолчанию, большому миру для сохранения не хватает, и тогда docker compose down или перезапуск заканчиваются убийством. Полный файл compose разобран в статье Valheim в Docker.

Моды RCON: RCON Next#

Если нужно выполнять серверные команды извне игры - из скрипта, бота Discord или веб-панели, - нужен мод, добавляющий удалённый протокол. Актуальный вариант на Thunderstore - RCON Next от ferrinius, плагин BepInEx для выделенного сервера, открывающий слушатель Source RCON с аутентификацией по паролю. Он заменяет старую rcon.dll из проекта BepInEx.rcon от AviiNL; не запускайте оба, а старый сначала удалите.

Он состоит из двух частей. Сам RCON Next обрабатывает подключение и вход, но сам не добавляет команд Valheim - он предоставляет команды, которые регистрируют другие плагины. Дополнительный плагин RCON Next Valheim добавляет собственные консольные команды сервера, такие как save. Другие моды могут регистрировать через него свои команды. Какие именно команды доступны, зависит от версий и плагинов, которые вы установите, так что актуальный список читайте на страницах модов, а не предполагайте, что команда существует.

Установка идёт по обычной схеме BepInEx: положить плагины в BepInEx/plugins, один раз запустить сервер, чтобы создать конфигурацию, остановить, отредактировать, запустить снова. Файл конфигурации - BepInEx/config/com.github.ferrinius.rcon-next.cfg:

[rcon-next]enabled = trueport = 2458password = a-long-random-string-nobody-will-guess

Если рядом лежит старый nl.avii.plugins.rcon.cfg от предыдущего плагина, RCON Next импортирует его настройки при первом запуске. Проверьте результат, а не считайте, что старый пароль перенёсся.

Подключиться может любой клиент Source RCON. Например, с gorcon/rcon-cli:

$ rcon -a 203.0.113.10:2458 -p 'a-long-random-string-nobody-will-guess' save

Порт TCP, тогда как собственные порты Valheim - UDP, поэтому ему нужно отдельное правило файрвола и проброс. На хостинге ему нужно отдельное выделение порта: используйте порт, который даёт хостинг, и впишите этот номер в конфигурацию, а не считайте, что 2458 свободен. На RE:NODE дополнительные порты добавляются на вкладке Network.

Защита мода RCON#

Относитесь к слушателю RCON как к полному админскому доступу к серверу, потому что он им и является. В документации мода сказано то же, и добавлена самая важная деталь: Source RCON не шифруется. Пароль и каждая команда идут по сети открытым текстом.

1. Используйте длинный случайный пароль. Сгенерируйте его; не используйте пароль сервера, который знают все игроки.
2. Не открывайте его в интернет, если можно этого избежать. Ограничьте порт в файрволе теми адресами, которым он нужен, или подключайтесь через VPN или туннель SSH.
3. Предпочитайте локальные подключения. Бот или скрипт на той же машине могут подключаться к 127.0.0.1, и тогда порт вообще не нужно открывать.
4. Удалите его, когда перестанете пользоваться. Неиспользуемый админский порт - это один риск без пользы.

Туннель SSH сохраняет трафик зашифрованным, а порт закрытым для остального мира:

$ ssh -N -L 2458:127.0.0.1:2458 valheim@203.0.113.10$ rcon -a 127.0.0.1:2458 -p 'the-password' save

Общие правила - и почему RCON на порту по умолчанию сканируют уже через несколько часов после запуска - описаны в статье RCON без риска.

Помните и о стоимости обслуживания. Любой плагин BepInEx может сломаться при обновлении игры, а плагин RCON, который не загрузился, уносит с собой ваше удалённое администрирование именно в тот день, когда оно может понадобиться. Держите консоль в игре и файлы списков как запасной вариант, который работает всегда.

Когда удалённое администрирование не работает#

`F5` ничего не делает в игре. Консоль не включена на клиенте. Добавьте -console в параметры запуска Valheim в Steam (правый клик по игре, Properties, Launch Options) и перезапустите игру. У игроков Game Pass и Xbox аналога нет, поэтому выдайте права админа кому-то в Steam.

Консоль открывается, но пишет, что вы не админ. ID в adminlist.txt не совпадает с формой, которую видит сервер. На кроссплей-сервере нужен префикс Steam_ или Xbox_; на сервере только для Steam - голый SteamID64. Скопируйте его из строки подключения в логе сервера, а не набирайте со страницы профиля, затем переподключитесь.

Бан не сработал. Либо ID был в неверной форме, как выше, либо файл правили не в том каталоге сохранений - сервер, запущенный с -savedir, читает списки оттуда, а не из расположения по умолчанию. Проверьте, в какой папке лежит мир, который сервер действительно загружает; файлы списков находятся рядом с папкой worlds_local.

Клиент RCON не может подключиться. Двигайтесь от ближнего к дальнему. Включён ли enabled = true и изменён ли пароль по умолчанию? Иначе слушатель не запустится, и лог BepInEx это скажет. Загружен ли вообще плагин - ищите его в BepInEx/LogOutput.log. Открыт ли порт для TCP, а не только для UDP, и тот ли это порт, который реально выделил ваш хостинг? Сначала попробуйте с самого сервера на 127.0.0.1; если так работает, проблема в сети, а не в моде.

RCON подключается, но команда неизвестна. RCON Next знает только команды, которые регистрируют установленные плагины. Без RCON Next Valheim нет даже save. Проверьте, что оба плагина на месте и версии у них согласованы.

Удалённый перезапуск потерял прогресс. Остановка была убийством. То, что отправляет перезапуск, должно отправлять прерывание и ждать World saved в логе, прежде чем процесс завершится. Это настройка хоста или сервиса, RCON её не исправляет.

Какой вариант выбрать#

Большинству групп RCON не нужен вовсе.

Плановые перезапуски - случай, в котором чаще всего думают, что нужен RCON, потому что в других играх перед перезапуском выполняют save. Valheim этого не требует: сохранение происходит при чистой остановке. Как собрать это без всяких модов, описано в статье Плановые перезапуски Valheim.

На RE:NODE сервер работает в собственном контейнере, консоль панели показывает его вывод, кнопки питания останавливают сервер чисто, для файлов списков есть файловый менеджер и SFTP, а для каждого сервера - субпользователи, так что соадмину можно дать консоль и файлы без доступа к оплате. В разделе о консоли в руководствах показаны органы управления.

FAQ#

Есть ли в Valheim RCON?

В ванильной игре нет. У выделенного сервера нет протокола удалённой консоли и нет ввода в консоль. RCON появляется только с модом BepInEx вроде RCON Next.

Почему я не могу вводить команды в консоль своей панели?

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

Нужно ли игрокам устанавливать мод RCON?

Нет. RCON Next работает только на выделенном сервере. Игроки заходят с немодифицированной игрой, так что он совместим с кроссплеем.

Можно ли забанить кого-то, не заходя в игру?

Да. Добавьте его ID в bannedlist.txt, который сервер перечитывает на ходу. Это не даст ему подключиться снова; если он в этот момент в сети, выкиньте его в игре или перезапустите сервер, чтобы бан применился и к его текущей сессии.

Безопасно ли открывать RCON в интернет?

Не совсем. Source RCON не шифруется, поэтому пароль идёт по сети открытым текстом. Ограничьте порт известными адресами, туннелируйте его через SSH или VPN либо подключайтесь с той же машины.