Перейти к содержимому
VORQUL
Документация / VorqulPanel / Установка и администрирование

Установка VorqulPanel на сервер Linux

Больше всего времени уходит на ожидание установки пакетов и распространения DNS, а не на саму панель. Порядок ниже позволяет не заблокировать себе доступ.

Установка VorqulPanel занимает примерно 15-30 минут на чистом сервере Linux. Нужны Debian 12, Ubuntu 22.04 или новее либо AlmaLinux 9, доступ root и не менее 2 ГБ ОЗУ. Панель поставляется одним JAR-файлом со скриптом scripts/install.sh, который устанавливает Java 25, если ее нет, создает служебного пользователя, регистрирует юнит systemd vorqul-panel и открывает порты с 8765 по 8767. Сборки нет, среды контейнеров и внешней базы данных не нужно. Собственное состояние панель по умолчанию хранит в SQLite.

Время
15-30 минут
Среда выполнения
Java 25 или новее, устанавливается за вас
Дистрибутивы
Debian 12, Ubuntu 22.04+, AlmaLinux 9
Хранилище панели
SQLite, внешняя БД не нужна

Требования

Минимальные требования перед установкой
ОЗУ Минимум 2 ГБ
Доступ Root на чистом сервере
Java 25 или новее, установщик добавит ее
Порты SSH, 8765-8767, 80 и 443
DNS A-запись, указывающая на сервер, для сертификатов
Среда контейнеров Не требуется
Requirements for Установка VorqulPanel: ОЗУ Минимум 2 ГБ, Доступ Root на чистом сервере, Java 25 или новее, установщик добавит ее, Порты SSH, 8765-8767, 80 и 443, DNS A-запись, указывающая на сервер, для сертификатов, Среда контейнеров Не требуется.

Установка

Чистый сервер - это настоящее требование, а не просто рекомендация. Панель управляет nginx, Apache, BIND9, Postfix, Dovecot, MariaDB и nftables, и ей намного проще на машине, где она сама все это установила.

  1. Step 01

    Debian 12, Ubuntu 22.04 или новее либо AlmaLinux 9, только что развернутый, с доступом root по SSH.

    Установка на сервер, где уже работает чужой веб-стек, возможна. Установщик не предлагает переустанавливать уже имеющиеся веб-сервер, PHP-FPM, MariaDB, certbot, BIND, Postfix или fail2ban, а панель читает существующие vhost, не переписывая их, пока вы не подтвердите перехват. Но начинать лучше не с такой установки.

  2. Step 02

    Панель - это один JAR-файл, ему нужна Java 25 или новее. Установщик ставит ее, если она отсутствует, поэтому здесь ничего делать не нужно, если только вы не хотите проверить заранее.

    bash
    java -version
  3. Step 03

    Узнайте, на каком порту слушает ваш демон SSH, и убедитесь, что сможете вернуться. Файрвол появится позже, и для SSH понадобится отдельное правило.

    Нестандартный порт SSH вместе со стандартным набором правил файрвола - классический способ закрыть себе доступ к свежеустановленной панели.

Установка

Одна команда выполняет всю установку. Ничего компилировать не нужно.

  1. Step 04

    Релиз - это одна папка с JAR-файлом, каталогом scripts и шаблонами юнитов systemd. Поместите ее в постоянное место, например /root/vorqul-panel.

    Сохраните папку после установки. Она нужна для vorqulctl fix-libs и последующих обновлений. Библиотеки из lib/ установщик загружает из Maven Central с проверкой контрольных сумм, поэтому копировать их не нужно.

    VorqulPanel находится в стадии alpha и пока не раздается для тестирования по электронной почте. Когда вам передадут сборку, вместе с архивом будут точные команды для этой версии. Шаги здесь описывают, что эти команды делают.

    • vorqul-panel.jar - сама панель
    • scripts/install.sh - установщик, обязателен
    • scripts/vorqul-helper - вспомогательная программа от root для портов файрвола, лимитов ресурсов и служб
    • scripts/vorqulctl - инструмент командной строки
    • scripts/vorqul-doctor.sh - необязательный диагностический скрипт
    • systemd/ содержит шаблоны служб, необязательно, потому что у установщика есть своя копия
  2. Step 05

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

    • Спрашивает, какие модули включить: игровой хостинг, веб-хостинг, почта
    • Спрашивает, какие пакеты установить: nginx или Apache, PHP-FPM, MariaDB, certbot, BIND, Postfix с Dovecot, Rspamd, игровые инструменты, fail2ban
    • Устанавливает Java, если ее нет, и создает системного пользователя vorqul
    • Копирует JAR в /opt/vorqul-panel, записывает конфигурацию со случайным секретом и настраивает службы systemd
    • Открывает порты в ufw или firewalld и выводит адрес настройки
    bash
    sudo bash scripts/install.sh

    Установщик ищет JAR в target/, рядом с корнем репозитория или рядом со скриптом, поэтому запускайте его из распакованной папки.

  3. Step 06

    У каждого вопроса есть переменная окружения. С YES=1 ничего не спрашивается, используются переменные или значения по умолчанию.

    • INSTAL_DIR (по умолчанию /opt/vorqul-panel), DATA_DIR и LOG_DIR задают, где лежат JAR, данные и логи
    • SYSTEM_USER (по умолчанию vorqul) - пользователь, от которого работает панель
    • PORT, SFTP_PORT и SFTP_DAEMON_PORT по умолчанию равны 8765, 8766 и 8767
    • MOD_GAMES, MOD_WEB и MOD_MAIL по умолчанию равны 1 и включают три части панели
    • WEB_SERVER принимает nginx, apache или none и действует только при MOD_WEB=1
    • INSTALL_PHP, INSTALL_MARIADB, INSTALL_CERTBOT, INSTALL_BIND, INSTALL_MAIL, INSTALL_RSPAMD, INSTALL_FAIL2BAN и INSTALL_GAMETOOLS выбирают пакеты
    • DB_ENGINE по умолчанию sqlite, доступны также mysql, postgres и mssql, а для подключения служат DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS
    • WEB_ADMIN=1 устанавливает вспомогательную программу от root и узкий файл sudoers, USE_EXISTING=0 позволяет установщику трогать уже установленное ПО
    bash
    sudo YES=1 MOD_MAIL=0 WEB_SERVER=nginx INSTALL_PHP=1 INSTALL_MARIADB=1 INSTALL_CERTBOT=1 bash scripts/install.sh

    Поддержка SQL Server находится в стадии beta. SQLite, MySQL, MariaDB и PostgreSQL проверены на реальных серверах. Последующая смена db.engine не переносит данные.

  4. Step 07

    Панель работает как защищенная служба systemd с именем vorqul-panel. Проверьте, что она запустилась, а если нет, прочитайте журнал.

    bash
    sudo systemctl status vorqul-panel
    sudo vorqulctl status
    sudo vorqulctl logs err

    Если при настройке не устанавливаются пакеты, обычно причина в RestrictSUIDSGID=yes в юните, который ломает скрипты после установки.

  5. Step 08

    Установщик открывает 8765, 8766 и 8767 в ufw или firewalld. С чистым nftables он сначала спрашивает и добавляет одно правило, которое не переживает перезагрузку.

    С чистым nftables также добавьте tcp dport { 8765, 8766, 8767 } accept в /etc/nftables.conf. За обратным прокси публичными должны быть только 80 и 443, а 8765 нужно держать закрытым от интернета.

    • Панель 8765, встроенный SFTP 8766, демон SFTP 8767, все по tcp
    • Сайты 80 и 443, почта 25, 587, 465, 143, 993 и 4190, DNS 53 по tcp и udp
    • Каждый игровой сервер открывает собственный порт при создании, а Hytale использует UDP 5520

Установка

Дальше всё происходит в браузере.

  1. Step 09

    Перейдите на http://your-server:8765/. Пока нет администратора, откроется форма настройки. Полную ссылку выдаёт установщик или команда ниже.

    bash
    sudo vorqulctl setup-url

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

  2. Step 10

    Сразу создайте первый аккаунт, затем включите двухфакторную аутентификацию в Settings, Account. Для администраторов её можно сделать обязательной.

    Если вы потеряете аккаунт администратора, выполните sudo vorqulctl reset-admin, а затем sudo vorqulctl start. Команда выведет новую ссылку настройки, по ней вы создадите нового администратора.

  3. Step 11

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

    Если веб-страница недоступна, впишите те же два значения в /opt/vorqul-panel/vorqul-panel.conf как license.key и license.domain, затем перезапустите службу. Серверу нужен исходящий HTTPS, чтобы связаться с сервером лицензий.

    license.domain должен совпадать с доменом, для которого выдан ключ. Файл лицензии вручную создавать не нужно, потому что data/license.json лишь хранит кэш подписанного ответа сервера.

  4. Step 12

    В Settings есть вкладки Game hosting, Web hosting и Mail. Отключите то, чем эта машина не занимается. Выключенный переключатель скрывает страницу, а её API начинает отвечать 404.

    Отключение модуля ничего не удаляет и не стирает данные. В Services, Manual setup показано, что установлено и чего не хватает, а рядом с каждым пунктом есть кнопка Install.

  5. Step 13

    Сначала направьте A-запись на сервер, затем добавьте домен в панели, нажмите Apply, чтобы записать vhost, и нажмите HTTPS, когда DNS начнёт указывать сюда.

    Сертификаты приходят от acme.sh или certbot, и обоим нужно, чтобы DNS-запись уже работала. Если запись только что изменили, дождитесь распространения, а не повторяйте попытки в цикле.

    Если сертификат выдан, но сайт всё ещё отдаёт обычный HTTP, обычно это принятый vhost, для которого ещё не подтверждён перехват.

  6. Step 14

    Каждый Apply запускает проверку конфигурации веб-сервера с автоматическим откатом. Запустите её один раз специально, чтобы увидеть, как выглядит успешный результат.

    Именно откат не даёт плохому vhost положить весь сервер. Панель проверяет новую конфигурацию до перезагрузки и возвращает старую, если проверка не пройдена.

Команды

Всё, что вы вводите на сервере. Запускайте vorqulctl от root или через sudo.

  1. Step 15

    Панель работает как служба vorqul-panel, а отдельный демон SFTP называется vorqul-sftp.

    bash
    sudo systemctl status vorqul-panel
    sudo systemctl restart vorqul-panel
    sudo systemctl stop vorqul-panel
    sudo systemctl enable vorqul-panel
    sudo journalctl -u vorqul-panel -n 100 --no-pager
  2. Step 16

    Короткие команды, которыми вы будете пользоваться чаще всего.

    • vorqulctl status показывает состояние службы, порт и версию
    • vorqulctl start, stop и restart управляют службой
    • vorqulctl enable и disable определяют, запускается ли она при загрузке
    • vorqulctl logs [tail|follow|err|all] читает журнал панели, по умолчанию последние 100 строк
    • vorqulctl info выводит пути, порты и каталог данных
    • vorqulctl version выводит версию панели
  3. Step 17

    Для первого входа, потерянного администратора или быстрой копии конфигурации.

    • vorqulctl setup-url снова выводит ссылку первой настройки
    • vorqulctl reset-admin создаёт новый setup URL для нового аккаунта администратора и снова включает вход по паролю
    • vorqulctl config открывает файл конфигурации в редакторе
    • vorqulctl backup записывает в /tmp архив tar.gz с конфигурацией и каталогом данных
  4. Step 18

    Модули, среды выполнения, библиотеки, обновления и удаление.

    • vorqulctl modules [games|web|mail on|off] показывает или переключает модуль вместе с его правами на хосте
    • vorqulctl deps <runtime> устанавливает среды выполнения, например node20, java25 или steamcmd
    • vorqulctl fix-libs заново скачивает библиотеки в lib/
    • vorqulctl fix-priv заново устанавливает файл sudoers, root-помощник и override для systemd
    • vorqulctl update <jar> устанавливает новый JAR с резервной копией, атомарной заменой, перезапуском, проверкой работоспособности и автоматическим откатом
    • vorqulctl uninstall [--purge-data] удаляет панель и сохраняет данные, если вы не укажете очистку
    bash
    sudo vorqulctl modules mail on
    sudo vorqulctl update /path/to/vorqul-panel.jar
  5. Step 19

    Панель работает от непривилегированного пользователя. Всё, что требует root, проходит через vorqul-helper, который принимает фиксированный список действий и ничего больше.

    Помощник читает /etc/vorqul-helper.conf. Файл принадлежит root и записывается установщиком. Он урезан до выбранных вами модулей, поэтому одно включение модуля в Settings не даёт панели нужных прав. Панель показывает баннер с командой, и этой командой является sudo vorqulctl modules <name> on.

    Какие бы модули ни были включены, панель никогда не останавливает SSH, nftables, ufw, firewalld или cron, никогда не сбрасывает межсетевой экран и не меняет его политику по умолчанию, только добавляет и удаляет собственные помеченные правила и никогда сама ничего не банит в fail2ban.

  6. Step 20

    Если игровой сервер не запускается, а журнал пуст, запустите doctor. Он ни с чем не связывается, ничего не меняет и вручную выполняет каждую команду игрового сервера, чтобы вы увидели настоящую ошибку.

    /healthz возвращает JSON с версией, временем работы, состоянием базы данных и числом запущенных серверов. Это удобная цель для вашего собственного мониторинга.

    bash
    ./scripts/vorqul-doctor.sh /opt/vorqul-panel
    curl -s http://127.0.0.1:8765/healthz

Справочник

Где что лежит после установки по умолчанию.

  1. Step 21

    Всё, чем владеет панель, находится в /opt/vorqul-panel, если вы не изменили INSTAL_DIR или DATA_DIR.

    • /opt/vorqul-panel содержит JAR, lib/ и vorqul-panel.conf
    • /opt/vorqul-panel/data содержит базу данных, игровые серверы и резервные копии
    • /opt/vorqul-panel/logs содержит vorqul-panel.log
    • /etc/systemd/system/vorqul-panel.service и vorqul-sftp.service это юниты
    • /usr/local/bin/vorqulctl это инструмент командной строки
    • /usr/local/sbin/vorqul-helper и /etc/vorqul-helper.conf это root-помощник и его политика
    • /etc/sudoers.d/vorqul-panel это узкий файл sudoers
  2. Step 22

    Первые три относятся к панели. Остальные зависят от того, какие части вы используете.

    • 8765 tcp это веб-интерфейс и API
    • 8766 tcp это встроенный SFTP, а 8767 tcp это отдельный демон SFTP
    • 80 и 443 tcp для сайтов и сертификатов
    • 25, 587, 465, 143, 993 и 4190 tcp для почты
    • 53 tcp и udp для DNS
    • Каждый игровой сервер использует свой порт

Справочник

Файл называется /opt/vorqul-panel/vorqul-panel.conf, в каждой строке один ключ = значение. Почти всё это есть и переключателями в Settings, так что вручную править файл приходится редко. После изменений перезапустите службу.

  1. Step 23

    Ключи, которые определяют, как панель принимает соединения и где хранит данные.

    • server.host и server.port задают адрес и порт прослушивания
    • server.public.url это адрес, который открывают пользователи, он нужен для входа через Google или Discord
    • server.tls.keystore указывает на хранилище PKCS12 для прямого HTTPS
    • data.dir это каталог данных
    • db.engine принимает значения sqlite, mysql, postgres или mssql, а для используемого движка есть блок db.<engine>.host, port, database, user и password
    • security.secret подписывает сессии и создаётся установщиком, поэтому менять его без нужды не стоит
    • panel.trust.proxies перечисляет единственные узлы, которым разрешено задавать заголовки пересылки
    • cloudflare.mode заставляет панель доверять CF-Connecting-IP только из диапазонов Cloudflare
  2. Step 24

    feature.games, feature.webhosting и feature.mail это главные переключатели. У каждого есть дочерние, и дочерний включён, только пока включён родительский.

    • Web: feature.domains, ssl, dns, databases, cache, webconfigs, webfiles, subdomains, websftp, webapps, webstats
    • Mail: feature.mail.dkim, antispam, tls, rules, catchall, autoconfig, delivery, webmail, dnsrecipe
    • Инструменты сайтов: webcron, webbackup, webgit, webruntime
    • terminal.enabled включает терминал в браузере. По умолчанию он выключен и доступен только администраторам с 2FA
  3. Step 25

    Как панель обращается с запущенными серверами.

    • servers.keepRunning, servers.nice и servers.oomAdjust настраивают, как серверы выживают и как планируются
    • limits.cgroups включает лимиты cgroup v2, при этом limits.memory.headroomPercent по умолчанию равен 125, а limits.pids.max по умолчанию выключен
    • limits.servers.maxRunning ограничивает, сколько серверов работает одновременно
    • process.stop.timeout это число секунд, которое сервер получает на сохранение при остановке, по умолчанию 30, максимум 150
  4. Step 26

    Расписания и хранение для панели, внешних копий и резервных копий сайтов.

    • backup.panel.cron и backup.panel.retention задают расписание резервных копий панели и сколько их хранить
    • backup.offsite.* описывает, куда отправляются зашифрованные копии
    • web.backup.keep это число хранимых резервных копий сайтов, по умолчанию 7
    • log.level задаёт, сколько панель пишет в журнал

    Если изменение, похоже, не применяется, запустите doctor или прочитайте vorqulctl logs err. Чаще всего причина в опечатке в файле.

Возможности

Краткая карта интерфейса, чтобы вы знали, где что искать.

  1. Step 27

    Меню сгруппировано по тому, чем управляет. Группы Web hosting, Mail и Game hosting можно отключить в Settings.

    • Overview это панель с системной статистикой
    • Web hosting: Websites overview, Domains and sites, DNS zones, Databases, Cache, SSL certificates, Web server configs
    • Mail: Mail и Mail delivery
    • Game hosting: Game overview, Game servers, Scheduler, Backups
    • System, только для администраторов: Services, Nginx, Logs, Cron, Monitoring, Firewall, Security, Fail2ban, Tools, Webhooks, Users, Audit log и Terminal (по умолчанию выключен)
    • Account: Settings и Licence для администраторов
    • Пользователи без прав администратора видят также My websites, если у них есть доступ хотя бы к одному сайту
  2. Step 28

    Более 240 шаблонов с установкой в один клик, живая консоль, файлы, резервные копии, расписания и SFTP для каждого сервера.

    • Minecraft, Hytale, семейство Source, Rust, Valheim, ARK, Palworld, FiveM, боты Discord, голосовые серверы и раздел для локальных ИИ-инструментов
    • Анализ сбоев называет причину и способ исправления, например неверную версию Java или остановку из-за нехватки памяти
    • Ограничения ресурсов для каждого сервера через cgroup v2 вместо nice или cpulimit
    • Права для каждого пользователя от View до списка Custom, например консоль, питание, файлы и резервные копии
    • Установка и обновление в один клик, живая консоль с вводом команд и файловый менеджер с редактированием, загрузкой, распаковкой zip и tar и chmod
    • Ручные и плановые резервные копии, планировщик перезапусков, копий и команд, а также SFTP-аккаунт в chroot для каждого сервера
  3. Step 29

    Виртуальные хосты nginx или Apache, Let's Encrypt, DNS, базы данных и инструменты для каждого сайта.

    • Домены для nginx или Apache с бесплатным HTTPS от Let's Encrypt, поддомены с отображением покрытия сертификатом, режим обратного прокси и импорт существующих сайтов
    • Зоны BIND9 с проверкой перед перезагрузкой и синхронизацией с Cloudflare
    • Базы данных и пользователи MariaDB с импортом, экспортом и Adminer, а также подсказки по ускорению базы
    • Версии, пулы и модули PHP
    • Инструменты для каждого сайта: настройки PHP, защита паролем, блокировка по IP, cron, резервные копии, развёртывание из git и приложения на Node.js или Python
    • Настройки Nginx для всего сервера и для каждого сайта
    • Файлы, аккаунты FTP и SFTP для каждого сайта и установщики Roundcube и phpMyAdmin в один клик
    • Redis, Valkey и memcached на одной странице
  4. Step 30

    Postfix и Dovecot с DKIM, проверкой доставляемости, очередью, журналом доставки, проверкой чёрных списков и Roundcube.

    Добавьте домен, сгенерируйте ключ DKIM и опубликуйте DNS-записи, которые покажет панель. Проверьте, что PTR-запись вашего IP совпадает с именем почтового хоста. Она задаётся там, где арендован IP, и никакая панель её не изменит.

    • Postfix, Dovecot и Rspamd устанавливаются одной кнопкой
    • Почтовые ящики, алиасы, catch-all, пересылка и автоответы об отсутствии
    • DKIM, SPF и DMARC, проверка доставляемости, почтовая очередь, журнал доставки и проверка чёрных списков
    • TLS-сертификат в один клик, экспорт DNS-записей и публикация в Cloudflare
    • Автонастройка для Thunderbird, Outlook и устройств Apple
  5. Step 31

    Управление службами, наблюдатели с самовосстановлением, публичная страница статуса, оповещения, межсетевой экран, поиск вредоносного ПО, роли и журнал аудита.

    • Установка, запуск, остановка и чтение журналов nginx, Apache, MariaDB, PHP-FPM и fail2ban, а также просмотр журналов, их очистка и редактор cron
    • Мониторы HTTP, TCP, ping, срока SSL, диска, памяти, CPU и служб с самовосстановлением, историей за 30 дней и публичной страницей статуса по адресу /status
    • Webhooks, embed-сообщения Discord и оповещения по e-mail о сбоях, резервных копиях, нехватке диска и истекающих сертификатах
    • Межсетевой экран на ufw, firewalld или nftables, необязательный базовый экран с автоматическим откатом и мастер настройки fail2ban
    • Обновление реального IP для Cloudflare и терминал в браузере только для администраторов с 2FA
    • Три роли, Admin, Operator и Viewer, с правами для каждого сервера View, Control, Manage или Custom
    • Двухфакторная аутентификация TOTP, вход через Google или Discord, блокировка входа, защита от CSRF, управление активными сессиями и журнал аудита с экспортом в CSV
    • Поиск вредоносного ПО с помощью ClamAV, LMD, rkhunter и chkrootkit, а также пакеты с квотами для пользователей

Резервные копии

Настройте их в первый же день. Бывает три вида, и у каждого своё место в интерфейсе.

  1. Step 32

    Резервные копии панели, игровых серверов и сайтов существуют отдельно.

    По расписанию панель также распаковывает собственную самую свежую копию и открывает внутри неё базу данных. Это доказывает, что архив можно восстановить, а не просто что он существует.

    • Резервная копия панели охватывает конфигурацию, базу данных и управляемые ею конфигурации хоста, делается по расписанию cron с хранением
    • Резервные копии игровых серверов делаются вручную или по расписанию, проверяются после записи, восстанавливаются из интерфейса, а ZIP-архивы можно скачать
    • Резервная копия сайта это один ZIP с файлами и, по желанию, базой данных. Её можно загрузить на другой сервер Vorqul, чтобы перенести сайт
  2. Step 33

    Backups, Offsite targets. Копии шифруются AES-256-GCM до того, как покинут сервер.

    Чтобы самостоятельно прочитать зашифрованную копию, используйте команду decrypt-backup из JAR.

    • Прямые цели: SSH, SFTP, FTP и S3
    • Google Drive, OneDrive и Dropbox через rclone
    bash
    java -jar vorqul-panel.jar decrypt-backup backup.zip.enc backup.zip
  3. Step 34

    Установите rclone, один раз создайте remote, затем используйте этот remote как внешнюю цель.

    В rclone config создайте remote с именем gdrive типа drive. На сервере без браузера ответьте no на вопрос об автоматической настройке и выполните rclone authorize "drive" на своём компьютере, затем вставьте выведенный токен. Строка lsd должна показать ваши папки Drive, прежде чем вы укажете remote в панели.

    bash
    sudo apt install rclone
    rclone config
    rclone lsd gdrive:
  4. Step 35

    Игровые серверы и сайты восстанавливаются из интерфейса. База данных панели восстанавливается вручную при остановленной панели.

    Панель выводит точную команду, а не подменяет базу данных, которую держит открытой. Восстановление конфигураций хоста работает по одному файлу и сохраняет копию .vorqul-pre-restore всего, что заменяет.

Обслуживание

Обновление никогда не затрагивает конфигурацию, базу данных и игровые серверы.

  1. Step 36

    Безопасный путь. Он сохраняет текущий JAR и конфигурацию, атомарно подменяет файл, перезапускает службу, ждёт /healthz и откатывает изменения, если новая версия не запустилась.

    bash
    sudo vorqulctl update /path/to/vorqul-panel.jar
    sudo vorqulctl fix-libs

    Запускайте fix-libs после этого, только если новой версии нужны новые библиотеки.

  2. Step 37

    Повторный запуск установщика распознаёт существующую установку, сохраняет конфигурацию и обновляет lib/, юниты и помощник.

    Заменённые файлы сохраняются в каталоге данных, в backups/_install/, и хранятся последние 10 запусков.

    Запущенные игровые серверы получают собственную команду остановки и process.stop.timeout секунд на сохранение, затем SIGTERM и наконец SIGKILL. Они снова запускаются, когда возвращается панель, а плановый перезапуск не считается сбоем.

    bash
    sudo bash scripts/install.sh
  3. Step 38

    Первая команда удаляет службы, помощник и правила sudoers и оставляет ваши данные. Вторая также удаляет каталог данных и пользователя vorqul после того, как вы введёте DELETE.

    bash
    sudo vorqulctl uninstall
    sudo vorqulctl uninstall --purge-data

    Пакеты, установленные панелью, сайты в /var/www, почтовые ящики и правила межсетевого экрана остаются на месте.

Решение проблем

The failures that actually happen, and what causes them.

Вопросы об установке

Итоги

Установка VorqulPanel занимает примерно 15-30 минут на чистом сервере Linux. Нужны Debian 12, Ubuntu 22.04 или новее либо AlmaLinux 9, доступ root и не менее 2 ГБ ОЗУ. Панель поставляется одним JAR-файлом со скриптом scripts/install.sh, который устанавливает Java 25, если ее нет, создает служебного пользователя, регистрирует юнит systemd vorqul-panel и открывает порты с 8765 по 8767. Сборки нет, среды контейнеров и внешней базы данных не нужно. Собственное состояние панель по умолчанию хранит в SQLite.

  • Время: 15-30 минут
  • Среда выполнения: Java 25 или новее, устанавливается за вас
  • Дистрибутивы: Debian 12, Ubuntu 22.04+, AlmaLinux 9
  • Хранилище панели: SQLite, внешняя БД не нужна
Термины на этой странице

Панель управления сервером Самостоятельное размещение Разовая лицензия Журнал аудита vorqulctl Root-помощник Setup URL База данных панели Переключатель модуля Перехват vhost Внешняя резервная копия Двухфакторная аутентификация

Связанное

Reviewed