Materiał referencyjny, a nie tekst marketingowy
Instalacja, konfiguracja, podsystemy i awarie, które naprawdę się zdarzają. Każda strona referencyjna jest samodzielna i można ją czytać bez reszty.
Dokumentacja Vorqul obejmuje wymagania, instalację i pierwszą konfigurację obu produktów, a następnie stronę referencyjną dla każdego podsystemu: moderację, automod i analitykę dla VorqulBOT oraz hosting WWW, DNS, pocztę, bazy danych, SFTP, firewall i monitoring dla VorqulPanel.
01 Wymagania
VorqulPanel oczekuje czystego serwera z Debian 12, Ubuntu 22.04+ lub AlmaLinux 9, dostępu na roocie, co najmniej 2 GB RAM i Javy 17 lub nowszej. VorqulBOT oczekuje Node.js 18+ (22 LTS) oraz aplikacji Discord z włączonymi intentami message content i server members.
- Serwer Linux z dostępem na roocie
- Java 17+ dla panelu
- Node.js 18+ (22 LTS) dla bota
- Środowisko kontenerowe jest opcjonalne, nie wymagane
02 Instalacja
Panel dostarczany jest jako cienki JAR plus katalog lib/ i skrypt pomocniczy, który rejestruje jednostkę systemd, tworzy użytkownika usługi i otwiera port panelu. Bot dostarczany jest jako repozytorium, które klonujesz, konfigurujesz przez .env i uruchamiasz przez npm, egg Pterodactyl albo dołączony launcher.
Szczegółowe przewodniki są pod /docs/install: VorqulBOT w około dziesięć minut, VorqulPanel w 15 do 30.
03 Pierwsza konfiguracja
Dla panelu: otwórz interfejs webowy na porcie wypisanym przez instalator, utwórz konto administratora, dodaj pierwszą domenę i uruchom wbudowany test konfiguracji. Dla bota: zaproś go z zalecanym zestawem uprawnień, włącz potrzebne moduły, a przed czymkolwiek innym ustaw rolę zespołu i kanał logów.
04 Rozwiązywanie problemów
- Instalacja pakietów zawodzi: prawie zawsze przyczyną jest RestrictSUIDSGID=yes w jednostce systemd, które psuje skrypty post-install.
- Panel niedostępny: firewall potrzebuje wyraźnej reguły dla portu panelu oraz dla SSH na własnym porcie.
- Certyfikaty wydane, ale strona nadal działa na HTTP: przejęty vhost wymaga potwierdzonego przejęcia, zanim panel go nadpisze.
- Brak komend slash: powtórz krok deploy i sprawdź, czy w zaproszeniu był scope applications.commands.
Zainstaluj samodzielnie
Dwa przewodniki, po jednym na produkt. Oba napisane tak, by dało się przejść je raz, od góry do dołu, bez wcześniejszego kontaktu z tym oprogramowaniem.
Install VorqulBOT
- Part 1 - The Discord side
- Part 2 - Choose your storage
- Part 3a - Deploy on a clean Debian or Ubuntu server
- Part 3b - Deploy on Pterodactyl
- Part 4 - First setup inside Discord
- Part 5 - Updating
Install VorqulPanel
- Part 1 - Prepare the server
- Part 2 - Install the panel
- Part 3 - First setup in the web interface
VorqulBOT
Bot Discord, self-hosted
VorqulPanel
Infrastruktura serwerowa
Reference pages are published in English only.