Przejdź do treści
VORQUL
Referencja / Słownik pojęć

Pojęcia, zdefiniowane raz

48 pojęć powtarzających się w dokumentacji i na stronach produktów. Każda definicja jest samodzielna, więc można ją zacytować bez otaczającej strony, i każda odsyła do przewodnika lub referencji, gdzie pojęcie jest używane.

Słownik definiuje 48 pojęć w pięciu grupach: produkt i licencjonowanie, administracja panelem, DNS, certyfikaty i poczta, bot Discord, web i wyszukiwanie AI. Każde hasło ma jednozdaniową definicję, szczegóły, odsyłacz do strony, na której pojęcie jest użyte, oraz powiązane pojęcia. Hasła są też publikowane jako dane strukturalne DefinedTerm.

Produkt i licencjonowanie

Oprogramowanie działające na sprzęcie, który operator posiada lub wynajmuje bezpośrednio, bez niczego po stronie producenta.

Produkt self-hosted instalujesz na własnej maszynie i tam działa. Żadna baza producenta nie trzyma twoich zapisów, nie ma kont na użytkownika i żadna usługa nie może cofnąć dostępu do danych, które już leżą na twoim dysku. Tak działają oba produkty Vorqul: VorqulBOT jako proces Node, a VorqulPanel jako Java JAR.

VorqulPanelDirect answers

Powiązane Panel sterowania serweraTelemetriaLicencja jednorazowa

Jeden interfejs administracyjny do usług działających na serwerze z Linuksem.

Panel sterowania zbiera hosting WWW, DNS, pocztę, bazy danych, dostęp do plików, reguły firewalla i monitoring w jednym interfejsie. Zwykłe zmiany nie oznaczają już osobnego pliku konfiguracji dla każdego podsystemu. VorqulPanel obejmuje te obszary na jednym serwerze, a własne dane trzyma w SQLite, ewentualnie w MySQL, MariaDB lub PostgreSQL.

VorqulPanel

Powiązane Self-hostedPrzełącznik modułuBaza danych panelu

Pojedynczy zakup obejmujący jedno wdrożenie, zamiast powtarzalnej subskrypcji.

VorqulPanel jest licencjonowany w ten sposób. Płacisz raz za wdrożenie, cena zależy od liczby serwerów, na których działa, a kupionej wersji możesz używać dalej bez odnawiania. Redystrybucja, odsprzedaż, sublicencjonowanie i hosting dla osób trzecich są wykluczone.

License

Powiązane Self-hostedTelemetria

Dane o użyciu, które zainstalowane oprogramowanie wysyła z powrotem do swojego producenta.

Telemetria występuje w oprogramowaniu open source i komercyjnym, a producenci zwykle nazywają ją anonimową. Produkty Vorqul nie wysyłają żadnej. To znaczy też brak sprawdzania licencji w trakcie działania i nic, co przestałoby działać, gdyby przestał działać producent.

Direct answers

Powiązane Self-hostedAudit log

Zapis działań administracyjnych, do którego tylko się dopisuje, żeby zmiany dało się przypisać konkretnej osobie także później.

Wiedzieć, że ustawienie się zmieniło, to jedno. Wiedzieć, kto je zmienił, kiedy i skąd, to właśnie daje audit log. VorqulBOT prowadzi go dla każdego serwera, a VorqulPanel dla każdej maszyny, i oba zostają na infrastrukturze, którą kontroluje operator.

Moderation

Powiązane Uwierzytelnianie dwuskładnikowe (TOTP)Historia spraw

Gdzie VorqulPanel trzyma własny stan: domyślnie SQLite, z MySQL, MariaDB i PostgreSQL jako opcjami i SQL Server w wersji beta.

Jest oddzielona od baz, które panel tworzy dla twoich stron. Zmiana silnika później nie przenosi danych, więc wybierz go przy instalacji przez DB_ENGINE.

Database managementUnattended install

Powiązane Panel sterowania serweraKopia offsite

Ustawienie, które włącza lub wyłącza całą część VorqulPanel: game hosting, hosting WWW, pocztę albo jedną z ich podfunkcji.

Wyłączony przełącznik ukrywa pozycję menu i sprawia też, że API odpowiada 404, więc funkcji nie da się osiągnąć nawet przez URL. Nic nie jest odinstalowywane i żadne dane nie są usuwane, a po ponownym włączeniu wszystko wraca.

Feature switches

Powiązane Root helper (vorqul-helper)vorqulctl

Drugi krok logowania z kodem czasowym z aplikacji, który VorqulPanel potrafi wymagać od adminów.

Włącz je w Settings, Account zaraz po utworzeniu admina. Jeśli stracisz dostęp, vorqulctl reset-admin wydaje nowy link konfiguracyjny.

First login

Powiązane Setup URLAudit log

Administracja panelem

Narzędzie wiersza poleceń instalowane z VorqulPanel do uruchamiania, aktualizacji, odzyskiwania i sprawdzania panelu.

Opakowuje usługę systemd i zadania wokół niej: status, logs, setup-url, reset-admin, modules, update z automatycznym wycofaniem, fix-libs i uninstall. Uruchamia się jako root albo przez sudo.

Command reference

Powiązane Setup URLRoot helper (vorqul-helper)Przełącznik modułu

Mały skrypt należący do roota, który wykonuje kilka uprzywilejowanych akcji potrzebnych VorqulPanel, dzięki czemu sam panel może działać jako użytkownik bez uprawnień.

Przyjmuje stałą listę akcji i odrzuca wszystko inne. Jego polityka leży w /etc/vorqul-helper.conf i jest zawężona do włączonych modułów, dlatego samo włączenie modułu w Settings nie daje panelowi tych praw.

The root helper

Powiązane vorqulctlLimity cgroup v2Przełącznik modułu

Jednorazowy link wypisany przez instalator, który otwiera formularz tworzenia pierwszego konta admina.

Dopóki nie ma admina, może go utworzyć każdy, kto pierwszy dotrze do portu panelu, dlatego okno zamyka się godzinę po starcie panelu. vorqulctl setup-url wypisuje nowy link, a vorqulctl reset-admin wydaje link dla nowego admina.

First login

Powiązane vorqulctlUwierzytelnianie dwuskładnikowe (TOTP)

Krok bezpieczeństwa, który VorqulPanel wykonuje przed zastosowaniem zmiany serwera WWW: testuje nową konfigurację, a jeśli test się nie powiedzie, przywraca starą.

Dlatego zły vhost nie kładzie całego serwera. Ta sama idea dotyczy stref DNS, które przed przeładowaniem BIND są sprawdzane przez named-checkzone.

Web hostingDNS

Powiązane Host wirtualny (vhost)Przejęcie vhostaStrefa DNS

Blok konfiguracji serwera WWW, który mówi nginx lub Apache, jaką stronę obsłużyć dla danej nazwy domeny.

VorqulPanel zapisuje tylko własne pliki vhostów z prefiksem vorqul- i zostawia w spokoju wszystko inne w konfiguracji serwera WWW.

Web hosting

Powiązane Przejęcie vhostaTest konfiguracji z cofnięciemTryb reverse proxy

Wyraźne potwierdzenie, którego trzeba, zanim VorqulPanel może zarządzać stroną znalezioną już skonfigurowaną na serwerze.

Adoptowane strony są czytane bez przepisywania. Po potwierdzeniu najpierw robiona jest kopia, a przejęcie usuwa tylko link w sites-enabled i nigdy nie kasuje oryginalnego pliku.

Installing on a used server

Powiązane Host wirtualny (vhost)Test konfiguracji z cofnięciem

Ustawienie domeny, które stawia vhost serwera WWW przed aplikacją działającą na lokalnym porcie.

Panel zapisuje vhost i potrafi wystawić certyfikat, więc dowolna aplikacja, także usługa w Node.js lub Pythonie, działa na zwykłej domenie z HTTPS.

Web hosting

Powiązane Host wirtualny (vhost)ACME i Let's Encrypt

Mechanizm jądra Linuksa, którym VorqulPanel ogranicza pamięć, CPU i liczbę procesów każdego serwera gry.

Zastępuje nice, cpulimit i ulimit, które albo nie ograniczają rzeczywistego zużycia, albo zamrażają proces. Serwer ponad pułapem jest zabijany we własnej grupie, a panel zapisuje, że zrobiło to jądro, więc odróżnisz zabicie z braku pamięci od awarii.

Game hosting

Powiązane Analiza awariiRoot helper (vorqul-helper)

Funkcja VorqulPanel, która czyta ostatnie linie padniętego serwera gry i nazywa prawdopodobną przyczynę oraz rozwiązanie.

Typowe przyczyny to zła wersja Javy, zajęty port, brak pamięci, brakujące EULA, zepsuty plugin albo pełny dysk. Automatyczny restart jest pomijany, gdy restart nie może pomóc.

Game hosting

Powiązane Limity cgroup v2

Kopia zapasowa wysłana do magazynu poza serwerem, żeby utrata maszyny nie oznaczała utraty kopii.

VorqulPanel szyfruje kopię przez AES-256-GCM, zanim opuści serwer. Cele konfiguruje się w panelu, a do chmury takiej jak Google Drive można dotrzeć przez rclone.

Backups guide

Powiązane Restore drillBaza danych panelu

Zaplanowana kontrola, w której panel rozpakowuje własną najnowszą kopię i otwiera w niej bazę danych.

Dowodzi, że archiwum da się naprawdę odtworzyć, a to coś innego niż to, że archiwum istnieje.

Backups guide

Powiązane Kopia offsite

Konto do przesyłania plików ograniczone do jednego katalogu, więc nie może przeglądać reszty serwera.

Każdy serwer gry we VorqulPanel dostaje własne konto SFTP w chroot, a strony mogą mieć je ograniczone do swojego folderu. Ochrona przed zgadywaniem haseł jest wbudowana.

SFTP

Powiązane Audit lognftables

Linuksowy filtr pakietów, którym VorqulPanel steruje obok ufw i firewalld do otwierania i zamykania portów.

Panel tylko dodaje i usuwa własne oznaczone reguły we własnych tabelach. Nigdy nie opróżnia zestawu reguł, nie zmienia polityki domyślnej ani nie dotyka reguł SSH.

Firewall

Powiązane SFTP w chrootRoot helper (vorqul-helper)

DNS, certyfikaty i poczta

Zestaw rekordów DNS domeny, który VorqulPanel potrafi obsługiwać sam przez BIND9.

Panel zapisuje i sprawdza plik strefy oraz potrafi kopiować rekordy do Cloudflare i z niego, niczego tam nie usuwając.

DNS

Powiązane Test konfiguracji z cofnięciemDKIMRekord PTR

Protokół i bezpłatny urząd certyfikacji, których VorqulPanel używa przez acme.sh lub certbot do wystawiania certyfikatów HTTPS.

Wystawienie wymaga, żeby rekord DNS najpierw wskazywał na serwer, albo tokenu Cloudflare DNS, którym nazwę można potwierdzić bez portu 80. Let's Encrypt pozwala tylko na pięć nieudanych weryfikacji na hostname na godzinę, dlatego panel przed kontaktem z urzędem sprawdza DNS, port 80 i pokrycie vhostem.

Web hosting

Powiązane Tryb reverse proxyStrefa DNS

Kryptograficzny podpis poczty wychodzącej, publikowany jako rekord DNS, po którym odbiorcy sprawdzają, że wiadomość pochodzi z twojej domeny.

We VorqulPanel klucz powstaje przez Rspamd przy dodawaniu domeny pocztowej, a panel pokazuje rekord do opublikowania. Leży pod domeną z nagłówka From, nigdy pod nazwą hosta poczty.

Mail

Powiązane SPF i DMARCRekord PTRDostarczalność

Dwa rekordy DNS, które mówią, które serwery mogą wysyłać pocztę dla domeny i co odbiorcy mają zrobić z pocztą niespełniającą kontroli.

Działają razem z DKIM. VorqulPanel generuje rekordy, a jego kontrola dostarczalności zgłasza, gdy któregoś brakuje albo jest błędny.

Mail

Powiązane DKIMDostarczalnośćMTA-STS i TLS-RPT

Odwrotny wpis DNS przypisujący adresowi IP serwera nazwę hosta, który sprawdzają serwery odbierające pocztę.

Ustawia się go tam, gdzie wynajmowane jest IP, więc żaden panel nie zmieni go za ciebie. Nazwa hosta poczty niezgodna z PTR szkodzi dostarczalności bardziej niż brak certyfikatu.

Mail

Powiązane DKIMDostarczalność

Polityki publikowane w DNS, które mówią serwerom wysyłającym, że do twojego serwera poczty muszą użyć TLS, i gdzie zgłaszać błędy.

Bez MTA-STS ktoś, kto potrafi przechwycić połączenie, może wyciąć ofertę STARTTLS, a nadawca po cichu przejdzie na transmisję bez szyfrowania. Sam plik polityki musi być dostępny pod https://mta-sts.twoja-domena/.well-known/mta-sts.txt.

Mail

Powiązane SPF i DMARCDostarczalność

Czy poczta, którą wysyłasz, naprawdę trafia do skrzynki, a nie zostaje odrzucona albo wrzucona do spamu.

Zależy od PTR, SPF, DKIM, DMARC i od reputacji adresu IP. VorqulPanel sprawdza rekordy, kolejkę poczty i główne publiczne blocklisty i mówi, które z nich jest problemem.

Mail

Powiązane DKIMSPF i DMARCRekord PTRMTA-STS i TLS-RPT

Bot Discord

Zbiorczy wynik, który VorqulBOT liczy z sygnałów aktywności, utrzymania członków, wzrostu i wdrażania nowych osób na serwerze Discord.

Wynik łączy cztery osobne trendy w jedną liczbę, którą można obserwować w czasie. Ocenia serwer względem jego własnej historii, nikogo nie porównuje z nikim innym i nie wydaje żadnego werdyktu o moderacji.

Server Health ScoreLeveling

Numerowany, przeszukiwalny zapis każdej akcji moderacyjnej na serwerze Discord.

Każdy ban, kick, ostrzeżenie czy timeout tworzy sprawę z celem, moderatorem, powodem, czasem trwania i znacznikiem czasu. Po miesiącach nadal możesz powiedzieć, dlaczego zapadła decyzja i kto ją podjął, i właśnie po to się je trzyma.

ModerationAutoMod

Powiązane Audit logDrabina eskalacjiTranskrypt ticketu

Jedna lista 44 modułów, którą czyta zarówno VorqulBOT, jak i jego dashboard, więc przełącznik nie może istnieć w jednym i być ignorowany w drugim.

Rejestr nazywa każdy moduł, grupę, do której należy, i czy domyślnie jest włączony. Dziewięć jest włączonych na starcie: moderacja, levelowanie, afk, ankiety, ekonomia, gry, giveaway, przypomnienia i komendy z prefiksem. Pozostałe 35 jest wyłączonych. Proces bota i webowy dashboard czytają ten sam plik, więc obie połowy nie mogą się rozjechać, co jest typowym błędem botów z oddzielnym interfejsem WWW.

PluginsVorqulBOT

Jedna z 15 kontroli wiadomości, które VorqulBOT uruchamia, zanim wiadomość zobaczy moderator, każda z własnym progiem, akcją i czasem trwania.

Filtry obejmują spam, powtarzany tekst, linki, zaproszenia, wielkie litery, wzmianki, masowe wzmianki, ghost pingi, zalewanie emoji, zalewanie spoilerami, zalgo, phishing, fałszywe nitro, oszustwa krypto i własne wyrażenia regularne. Domyślnie włączone są tylko phishing i fałszywe nitro. Każdy filtr działa niezależnie, więc jeden może usuwać, drugi dawać timeout, a trzeci bana.

AutoMod

Powiązane Drabina eskalacjiShadow-mute

Reguła, która zamienia określoną liczbę wykroczeń w oknie czasowym na ostrzejszą akcję, bez decydowania moderatora za każdym razem.

VorqulBOT ma dwie. Eskalacja AutoMod uruchamia się przy powtarzających się trafieniach filtra w oknie, domyślnie godzinnym. Akcje przy ostrzeżeniach działają tak samo, ale ręcznie: liczba, okno w dniach i akcja, więc trzy ostrzeżenia w siedem dni mogą oznaczać mute. Kilka reguł można łączyć, a recydywiści eskalują sami.

ModerationAutoMod

Powiązane Historia sprawFiltr AutoModJail

Mute, przy którym członek nadal widzi własne wiadomości, a nikt inny ich nie widzi.

Usuwa sprzężenie zwrotne. Jeśli powiesz członkowi, że jest wyciszony, kłóci się o to albo wraca z innego konta. Jeśli widzi swoje wiadomości opublikowane jak zwykle, zwykle traci zainteresowanie. VorqulBOT oferuje to jako shadowmute i unshadowmute obok zwykłego mute, timeoutu i jaila.

Moderation

Stan moderacyjny, który odbiera członkowi role i zawęża jego dostęp do ograniczonego zestawu kanałów.

Jail leży między timeoutem a banem. Członek zostaje na serwerze i nadal można z nim rozmawiać, co pomaga, gdy wyjaśniasz incydent, ale traci dostęp do wszystkiego, do czego miał wcześniej. Role wracają po unjail.

Moderation

Powiązane Kontrola kont alternatywnychDrabina eskalacji

Moduł, który pozwala starym komendom tekstowym, jak !daily, działać obok komend slash.

Komendy slash wygrywają niemal pod każdym względem, ale serwer, który od trzech lat pisze !daily, będzie pisał dalej. Most mapuje formę tekstową na ten sam handler. Nikt nie musi się przeuczać i nic nie jest utrzymywane dwa razy. To jeden z dziewięciu modułów włączonych domyślnie.

VorqulBOTEconomy

Powiązane Komenda slash

Plik konfiguracji, który mówi panelowi Pterodactyl, jak zainstalować i uruchomić daną aplikację.

VorqulBOT go dostarcza. Importujesz go, wgrywasz pliki przez SFTP, wpisujesz token Discord w zmiennych Startup i naciskasz start. Pierwszy start sam instaluje zależności i kompiluje kod. Jeśli już prowadzisz panel do game hostingu, to najkrótsza droga do uruchomienia bota.

VorqulBOTDirect answers

Powiązane Self-hostedPrivileged intents

Limit na poziomie serwera we VorqulBOT (free, premium lub pro), który podnosi pułapy kilku funkcji.

Pułapy dotyczą przypiętych wiadomości, ról reakcji, automatycznych odpowiedzi, zaplanowanych wiadomości i wychodzących webhooków. Free pozwala na 3 przypięte wiadomości, 5 ról reakcji, 10 automatycznych odpowiedzi, 5 zaplanowanych wiadomości i brak webhooków. Pro pozwala na 100, 100, 500, 200 i 5. Bot jest self-hosted, więc poziom ustawiasz swoim serwerom sam i nigdy nie kupujesz go ode mnie.

Direct answers

Hash HMAC-SHA256 treści żądania, wysyłany w nagłówku, żeby odbiorca mógł udowodnić, że żądanie pochodzi od bota.

VorqulBOT wysyła na wybrany adres cztery zdarzenia o członkach: dołączenie, odejście, ban i unban. Jeśli ustawisz wspólny sekret, każde żądanie niesie nagłówek X-Vorqul-Signature obliczony z treści tym sekretem, a twój endpoint może odrzucić wszystko, co nie pasuje. Bez sekretu zdarzenia nadal przychodzą, tyle że bez uwierzytelnienia.

Plugins

Powiązane Logowanie do dashboardu przez OAuth2

Minimalny czas między dwiema wiadomościami, które obie dają XP. VorqulBOT domyślnie używa 60 sekund.

Bez cooldownu levelowanie nagradza ilość, a szczyt rankingu trafia do tego, kto napisze najwięcej jednowyrazowych wiadomości. Z nim dwadzieścia szybkich wiadomości daje dokładnie tyle co jedna. To najważniejsze ustawienie systemu levelowania, a serwery najczęściej zostawiają je takie, z jakim przyszedł bot.

Leveling

Heurystyczny wynik, który moderator może uruchomić dla jednego członka, liczony z wieku konta, awatara, daty dołączenia i ról.

Konto młodsze niż 7 dni dostaje 40, młodsze niż 30 dni 25, a młodsze niż 90 dni 10. Domyślny awatar dodaje 20, dołączenie mniej niż dobę temu 15, brak ról 10, a boty dostają zero. Traktuj wynik jako podstawę do ludzkiej decyzji i pomiń automatyczne banowanie. Takie heurystyki dają fałszywe alarmy, a błędny ban kosztuje więcej zaufania, niż oszczędza czasu.

ModerationAnti-Raid

Powiązane JailHistoria spraw

Rozmowa w tickecie pomocy zapisana do pliku tekstowego i wysłana na wskazany przez ciebie kanał.

VorqulBOT eksportuje ostatnie 100 wiadomości kanału ticketu. Tyle zwraca Discord jednym zapytaniem i zwykle obejmuje to cały ticket. Plik jest celowo prosty: tekst, autorzy i znaczniki czasu, więc otwiera się wszędzie i łatwo go przeszukiwać. Nic nie idzie do zewnętrznej usługi.

Tickets

Ustawienia Discorda, które bot musi włączyć, żeby widzieć obecność, członków serwera i treść wiadomości.

VorqulBOT potrzebuje włączonych intentów obecności, członków serwera i treści wiadomości w portalu deweloperskim Discorda. Bez nich komendy wyglądają, jakby nic nie robiły.

Discord setup

Powiązane Komenda slashLogowanie do dashboardu przez OAuth2

Komenda Discorda wpisywana z ukośnikiem na początku, którą bot rejestruje w Discordzie, a ten pokazuje ją w wyborze komend.

Rejestracja wymaga zakresu applications.commands w zaproszeniu i kroku deploy. Gdy komend slash brakuje, powtórz deploy i sprawdź zakres zaproszenia.

VorqulBOT

Powiązane Privileged intentsPrefix bridge

Jak logujesz się do dashboardu VorqulBOT: przez Discord, z adresem przekierowania, który musi zgadzać się z zarejestrowanym.

Niezgodność redirect URI w portalu Discord i adresu dashboardu to najczęstsza przyczyna nieudanego logowania. Jeśli zostawisz NEXTAUTH_URL puste, adres zostanie wykryty automatycznie.

First dashboard sign-in

Powiązane Privileged intentsPodpis webhooka

Web i wyszukiwanie AI

Tekstowy indeks w katalogu głównym witryny, który wskazuje modelom językowym jej kanoniczną treść.

Konwencja bierze kształt z robots.txt i działa odwrotnie: zamiast ograniczać roboty, daje im wyselekcjonowaną mapę. To powstająca konwencja, nie zatwierdzony standard, i nikt niezależnie nie wykazał, ile pomaga w wyszukiwaniu. vorqul.com publikuje go pod /llms.txt, a pełną wersję pod /llms-full.txt.

llms.txt

Powiązane Entity homeRenderowanie po stronie serwera

Jedyna kanoniczna strona należąca do marki, która w formie czytelnej dla maszyn mówi, czym ona jest.

Entity home zawiera jasne twierdzenia o kategorii, celu i odbiorcach, popiera je danymi strukturalnymi i jest potwierdzana, gdy ten sam opis pojawia się w profilach stron trzecich. Jeśli te źródła się rozjeżdżają, system ufa encji mniej. Dla Vorqul jest to strona /about powiązana z identyfikatorem w Wikidata.

About

Powiązane llms.txt

Tworzenie kompletnego HTML, zanim trafi do klienta, zamiast składania strony JavaScriptem w przeglądarce.

Roboty wyszukujące za silnikami odpowiedzi pobierają HTML i zwykle pomijają JavaScript, więc wszystko, co powstaje dopiero po hydratacji u klienta, jest dla nich niewidoczne. vorqul.com jest zbudowany statycznie. Każda strona przychodzi jako kompletny HTML, a niewielka ilość JavaScriptu obsługuje menu, podpowiedź języka i analitykę, na którą się zgodziłeś.

Powiązane llms.txt

Sprawdzono