Документация

Справочный материал, а не маркетинговый текст

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

Yamiru · 2026-08-28

Документация Vorqul охватывает требования, установку и первую настройку обоих продуктов, а затем справочную страницу по каждой подсистеме: модерация, автомод и аналитика для VorqulBOT, а также веб-хостинг, DNS, почта, базы данных, SFTP, фаервол и мониторинг для VorqulPanel.

01 Требования

VorqulPanel ожидает чистый сервер с Debian 12, Ubuntu 22.04+ или AlmaLinux 9, доступ под root, минимум 2 ГБ ОЗУ и Java 17 или новее. VorqulBOT ожидает Node.js 18+ (22 LTS) и приложение Discord с включёнными интентами message content и server members.

Linux-сервер с доступом под root
Java 17+ для панели
Node.js 18+ (22 LTS) для бота
Контейнерная среда опциональна, не обязательна

02 Установка

Панель поставляется как тонкий JAR плюс каталог lib/ и вспомогательный скрипт, который регистрирует systemd-юнит, создаёт сервисного пользователя и открывает порт панели. Бот поставляется как репозиторий: клонируете, настраиваете через .env и запускаете через npm, Pterodactyl egg или прилагаемый лаунчер.

Пошаговые руководства - на /docs/install: VorqulBOT примерно за десять минут, VorqulPanel за 15-30.

03 Первая настройка

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

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

Установка пакетов не проходит: почти всегда причина в RestrictSUIDSGID=yes в systemd-юните, ломающем post-install скрипты.
Панель недоступна: фаерволу нужно явное правило для порта панели и для SSH на нестандартном порту.
Сертификаты выпущены, но сайт всё ещё отдаёт HTTP: перенятый vhost требует подтверждённого перехвата, прежде чем панель его перепишет.
Нет slash-команд: повторите шаг deploy и убедитесь, что в приглашении был scope applications.commands.

Установка