Přeskočit na obsah
VORQUL
Dokumentace

Referenční materiál, ne marketingový text

Instalace, konfigurace, subsystémy a chyby, které opravdu nastávají. Každá referenční stránka stojí sama o sobě a dá se číst bez zbytku.

·

Dokumentace Vorqul pokrývá požadavky, instalaci a první nastavení obou produktů, na což navazuje referenční stránka ke každému subsystému: moderace, automod a analytika pro VorqulBOT, a webhosting, DNS, mail, databáze, SFTP, firewall a monitoring pro VorqulPanel.

01 Požadavky

VorqulPanel očekává čistý server s Debian 12, Ubuntu 22.04+ nebo AlmaLinux 9, přístup pod rootem, alespoň 2 GB RAM a Javu 17 nebo novější. VorqulBOT očekává Node.js 18+ (22 LTS) a Discord aplikaci se zapnutými intenty message content a server members.

  • Linux server s přístupem pod rootem
  • Java 17+ pro panel
  • Node.js 18+ (22 LTS) pro bota
  • Kontejnerové prostředí je volitelné, ne povinné

02 Instalace

Panel se dodává jako tenký JAR plus adresář lib/ a pomocný skript, který zaregistruje systemd unit, vytvoří servisního uživatele a otevře port panelu. Bot se dodává jako repozitář, který naklonujete, nastavíte přes .env a spustíte přes npm, Pterodactyl egg nebo přiložený launcher.

Podrobné návody jsou na /docs/install: VorqulBOT za asi deset minut, VorqulPanel za 15 až 30.

03 První nastavení

Pro panel: otevřete webové rozhraní na portu, který vypíše instalátor, vytvořte administrátorský účet, přidejte první doménu a spusťte vestavěný test konfigurace. Pro bota: pozvěte ho s doporučenou sadou oprávnění, zapněte moduly, které potřebujete, a ještě před čímkoli jiným nastavte roli pro tým a kanál na logy.

04 Řešení problémů

  • Instalace balíčků selhává: téměř vždy je příčinou RestrictSUIDSGID=yes v systemd unitě, které rozbíjí post-install skripty.
  • Panel není dostupný: firewall potřebuje výslovné pravidlo pro port panelu a pro SSH na vlastním portu.
  • Certifikáty jsou vydané, ale stránka stále běží na HTTP: převzatý vhost potřebuje potvrzené převzetí, než ho panel přepíše.
  • Chybí slash příkazy: zopakujte krok deploy a ověřte, že v pozvánce byl scope applications.commands.