Linux
- Ubuntu 22.04 или 24.04
- Debian 12 или 13
- Docker Engine 24+ — если его нет, установщик предложит поставить
- Доступ root (sudo)
Своя машина
Берёте VDS или выделенный сервер у любого провайдера, ставите агента одной командой — и машина появляется в панели. Root остаётся у вас, железо и локацию выбираете вы.
curl -fsSL https://api.shardox.net/install/install.sh | sudo sh -s -- --token <ENROLL_TOKEN>Требования
Обычно это VDS или выделенный сервер с публичным IP. Процессор — x86_64.
shardox health --ports покажет, что закрыто и какой командой открытьУстановка
Команду с вашим токеном покажет панель после нажатия «Добавить ноду». Вот как она выглядит:
curl -fsSL https://api.shardox.net/install/install.sh | sudo sh -s -- --token <ENROLL_TOKEN>Бинарники приходят с нашего сервера и проверяются по подписи.
Агент создаёт ключ, получает сертификат по одноразовому токену и ставит службы.
Сразу после установки запускается shardox health: связь, рантайм, диск и ресурсы.
Агент
Одна служба shardox — и демон, и командная строка. Игровые данные живут на вашей машине, панель получает их от агента.
Создаёт серверы из шаблонов игр, ставит лимиты и следит за их состоянием.
Консоль, логи и файловый менеджер работают через агента — без SSH и RDP.
Рестарты, команды, вайпы и обновления срабатывают по часам машины.
Сам проверяет новые сборки в Steam и обновляет через SteamCMD по вашей политике.
CPU, память, сеть и диск — по серверам и по ноде.
Новая версия агента ставится без перезапуска игровых серверов и откатывается, если что-то пошло не так.
Командная строка
shardox status покажет связь с панелью, ресурсы и серверы, а shardox health — что мешает игрокам подключиться.
$ 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 --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
Наш движок понимает тот же API, что и Docker, поэтому шаблоны серверов одинаковые на Linux и Windows.
Каждый сервер работает от отдельного скрытого пользователя без входа в систему и RDP.
AppContainer, отдельный рабочий стол и ограничения Job Object: CPU, память, процессы.
Сервер слушает только свои порты и не видит локальную сеть и порты агента.
Квота NTFS на каждый сервер, доступ — только к своим файлам.
Изоляция без виртуализации делит ядро с системой — как песочница браузера. Для своих серверов на своей машине этого достаточно.
Безопасность
Агент — гость на вашей машине, поэтому он открывает минимум и проверяет всё, что ставит.
Агент сам подключается к панели по TLS 1.3 и не принимает входящих соединений.
mTLS, сертификат продлевается сам; при удалении ноды он отзывается.
Релизы агента подписаны Ed25519, образы закреплены по digest. Неподписанное не ставится.
Локальная командная строка и Docker API доступны только root и администраторам и никогда не пробрасываются в серверы.
Участникам проекта доступны консоль игры и файлы сервера, но не командная оболочка машины.
Каждое действие в панели и с машины попадает в журнал проекта.
Регистрация займёт минуту, установка агента — ещё пару.