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

Своя машина

Панель для своего сервера

Берёте VDS или выделенный сервер у любого провайдера, ставите агента одной командой — и машина появляется в панели. Root остаётся у вас, железо и локацию выбираете вы.

curl -fsSL https://api.shardox.net/install/install.sh | sudo sh -s -- --token <ENROLL_TOKEN>
Команду с вашим одноразовым токеном покажет панель

Требования

Какая машина подойдёт

Обычно это VDS или выделенный сервер с публичным IP. Процессор — x86_64.

Linux

  • Ubuntu 22.04 или 24.04
  • Debian 12 или 13
  • Docker Engine 24+ — если его нет, установщик предложит поставить
  • Доступ root (sudo)

Windows

  • Windows 10 версии 1809 и новее, Windows 11 — основная платформа
  • Windows Server 2019 и новее
  • Docker, WSL и Hyper-V не нужны
  • Права администратора

Для любой системы

  • Публичный IP: панель не пробрасывает порты через NAT, домашняя машина — не основной сценарий
  • Исходящий доступ в интернет: игры и моды качаются из Steam, Mojang и других официальных источников
  • Игровые порты открываете вы — shardox health --ports покажет, что закрыто и какой командой открыть

Установка

Одна команда — и нода в панели

Команду с вашим токеном покажет панель после нажатия «Добавить ноду». Вот как она выглядит:

curl -fsSL https://api.shardox.net/install/install.sh | sudo sh -s -- --token <ENROLL_TOKEN>
Токен одноразовый и действует один час.
  1. Скрипт скачивает агента

    Бинарники приходят с нашего сервера и проверяются по подписи.

  2. Нода регистрируется

    Агент создаёт ключ, получает сертификат по одноразовому токену и ставит службы.

  3. Диагностика

    Сразу после установки запускается shardox health: связь, рантайм, диск и ресурсы.

Агент

Что делает агент на машине

Одна служба shardox — и демон, и командная строка. Игровые данные живут на вашей машине, панель получает их от агента.

  • Разворачивает серверы

    Создаёт серверы из шаблонов игр, ставит лимиты и следит за их состоянием.

  • Отдаёт консоль и файлы

    Консоль, логи и файловый менеджер работают через агента — без SSH и RDP.

  • Выполняет расписания

    Рестарты, команды, вайпы и обновления срабатывают по часам машины.

  • Обновляет игры

    Сам проверяет новые сборки в Steam и обновляет через SteamCMD по вашей политике.

  • Собирает метрики

    CPU, память, сеть и диск — по серверам и по ноде.

  • Обновляется без простоя

    Новая версия агента ставится без перезапуска игровых серверов и откатывается, если что-то пошло не так.

Командная строка

Всё видно и с самой машины

shardox status покажет связь с панелью, ресурсы и серверы, а shardox health — что мешает игрокам подключиться.

shardox status
$ shardox statusShardox agent 1.4.2 · engine 1.4.2 (protocol 7) — okNode      node-7f3a  "fra-vds-1"   Windows 11 24H2Panel     connected 3d 4h, control ctl-1, rtt 18 msUpdate    1.5.0 available (stable)Resources CPU 34% of 16 cores · RAM 21.3/64 GiBServers   4 total · 3 running · 1 stopped  rust-main     Rust            running   112/200  dayz-pve      DayZ            running   41/60  mc-paper      Minecraft Java  running   12/50  ark-island    ARK: SA         stopped
Состояние ноды
shardox health --ports
$ shardox health --portsPorts  rust-main   28015/udp  listening ✓  firewall ✗  external ✗    → Windows Firewall blocks inbound UDP 28015. Fix (PowerShell, admin):      New-NetFirewallRule -DisplayName "Shardox rust-main 28015/udp" -Direction Inbound -Protocol UDP -LocalPort 28015 -Action Allow  mc-paper    25565/tcp  listening ✓  firewall ✓  external ✓
Проверка портов

Windows

Shardox Engine — контейнеры на Windows без виртуализации

Наш движок понимает тот же API, что и Docker, поэтому шаблоны серверов одинаковые на Linux и Windows.

  • Свой пользователь

    Каждый сервер работает от отдельного скрытого пользователя без входа в систему и RDP.

  • Песочница

    AppContainer, отдельный рабочий стол и ограничения Job Object: CPU, память, процессы.

  • Сетевые правила

    Сервер слушает только свои порты и не видит локальную сеть и порты агента.

  • Квоты диска

    Квота NTFS на каждый сервер, доступ — только к своим файлам.

Изоляция без виртуализации делит ядро с системой — как песочница браузера. Для своих серверов на своей машине этого достаточно.

Безопасность

Как агент защищает машину

Агент — гость на вашей машине, поэтому он открывает минимум и проверяет всё, что ставит.

  • Только исходящие соединения

    Агент сам подключается к панели по TLS 1.3 и не принимает входящих соединений.

  • Сертификат на каждую ноду

    mTLS, сертификат продлевается сам; при удалении ноды он отзывается.

  • Проверка подписи

    Релизы агента подписаны Ed25519, образы закреплены по digest. Неподписанное не ставится.

  • Доступ к управлению

    Локальная командная строка и Docker API доступны только root и администраторам и никогда не пробрасываются в серверы.

  • Команда без shell

    Участникам проекта доступны консоль игры и файлы сервера, но не командная оболочка машины.

  • Журнал действий

    Каждое действие в панели и с машины попадает в журнал проекта.

Готовы подключить машину?

Регистрация займёт минуту, установка агента — ещё пару.