Pojmy, definované raz

Softvér, ktorý beží na hardvéri, ktorý prevádzkovateľ vlastní alebo si priamo prenajíma, bez čohokoľvek na strane výrobcu.

Self-hosted produkt si nainštalujete na vlastný stroj a beží tam. Žiadna databáza výrobcu nedrží vaše záznamy, neexistuje účet za používateľa a žiadna služba vám nemôže zrušiť prístup k dátam, ktoré už máte na disku. Takto fungujú oba produkty Vorqul: VorqulBOT beží ako proces Node a VorqulPanel ako Java JAR.

VorqulPanelDirect answers

Súvisiace Ovládací panel serveraTelemetriaJednorazová licencia

Jedno administračné rozhranie pre služby, ktoré bežia na Linuxovom serveri.

Ovládací panel dáva webhosting, DNS, mail, databázy, prístup k súborom, pravidlá firewallu a monitoring pod jedno rozhranie. Bežné zmeny už neznamenajú samostatný konfiguračný súbor pre každý podsystém. VorqulPanel pokrýva tieto oblasti na jednom serveri a vlastné dáta drží v SQLite, prípadne v MySQL, MariaDB alebo PostgreSQL.

VorqulPanel

Súvisiace Self-hostedPrepínač moduluDatabáza panela

Jediný nákup, ktorý pokrýva jedno nasadenie, namiesto opakovaného predplatného.

VorqulPanel sa licencuje takto. Platíte raz za nasadenie, cena závisí od počtu serverov, na ktorých beží, a verziu, ktorú ste kúpili, môžete používať ďalej bez obnovy. Redistribúcia, predaj, sublicencovanie a hosting pre tretie strany sú vylúčené.

License

Súvisiace Self-hostedTelemetria

Údaje o používaní, ktoré nainštalovaný softvér posiela späť svojmu výrobcovi.

Telemetria sa objavuje v open source aj komerčnom softvéri a výrobcovia ju zvyčajne volajú anonymná. Produkty Vorqul neposielajú žiadnu. To znamená aj žiadnu kontrolu licencie za behu a nič, čo by prestalo fungovať, keby prestal fungovať výrobca.

Direct answers

Súvisiace Self-hostedAudit log

Záznam administračných akcií, do ktorého sa len pridáva, aby sa dali zmeny pripísať konkrétnej osobe aj neskôr.

Vedieť, že sa nastavenie zmenilo, je jedna vec. Vedieť, kto ho zmenil, kedy a odkiaľ, je to, čo dáva audit log. VorqulBOT ho vedie pre každý server a VorqulPanel pre každý stroj a oba zostávajú na infraštruktúre, ktorú prevádzkovateľ ovláda.

Moderation

Súvisiace Dvojfaktorové overenie (TOTP)História prípadov

Kde VorqulPanel drží vlastný stav: predvolene SQLite, s MySQL, MariaDB a PostgreSQL ako možnosťami a SQL Server v beta.

Je oddelená od databáz, ktoré panel vytvára pre vaše weby. Zmena enginu neskôr dáta neprenesie, preto ho vyberte pri inštalácii cez DB_ENGINE.

Database managementUnattended install

Súvisiace Ovládací panel serveraOffsite záloha

Nastavenie, ktoré zapne alebo vypne celú časť VorqulPanelu: game hosting, webhosting, mail alebo niektorú z ich podfunkcií.

Vypnutý prepínač skryje položku menu a zároveň spôsobí, že API odpovie 404, takže sa funkcia nedá dosiahnuť ani cez URL. Nič sa neodinštaluje a nemažú sa žiadne dáta a po opätovnom zapnutí je všetko späť.

Feature switches

Súvisiace Root helper (vorqul-helper)vorqulctl

Druhý krok prihlásenia s časovým kódom z aplikácie, ktorý VorqulPanel vie vyžadovať od adminov.

Zapnite ho v Settings, Account hneď po vytvorení admina. Ak stratíte prístup, vorqulctl reset-admin vydá nový odkaz na nastavenie.

First login

Súvisiace Setup URLAudit log

Nástroj príkazového riadka, ktorý sa inštaluje s VorqulPanelom na spúšťanie, aktualizáciu, obnovu a kontrolu panela.

Obaľuje službu systemd a úlohy okolo nej: status, logs, setup-url, reset-admin, modules, update s automatickým návratom, fix-libs a uninstall. Spúšťa sa ako root alebo cez sudo.

Command reference

Súvisiace Setup URLRoot helper (vorqul-helper)Prepínač modulu

Malý skript vo vlastníctve roota, ktorý robí niekoľko privilegovaných akcií, ktoré VorqulPanel potrebuje, takže samotný panel môže bežať ako neprivilegovaný používateľ.

Prijíma pevný zoznam akcií a všetko ostatné odmietne. Jeho politika je v /etc/vorqul-helper.conf a je zúžená na moduly, ktoré ste zapli, a preto zapnutie modulu iba v Settings panelu tieto práva nedá.

The root helper

Súvisiace vorqulctlLimity cgroup v2Prepínač modulu

Jednorazový odkaz, ktorý vypíše inštalátor a ktorý otvorí formulár na vytvorenie prvého admin účtu.

Kým neexistuje admin, vytvoriť ho môže ten, kto sa prvý dostane na port panela, preto sa okno zatvorí hodinu po štarte panela. vorqulctl setup-url vypíše nový odkaz a vorqulctl reset-admin vydá odkaz pre nového admina.

First login

Súvisiace vorqulctlDvojfaktorové overenie (TOTP)

Bezpečnostný krok, ktorý VorqulPanel spustí pred použitím zmeny webservera: otestuje novú konfiguráciu a ak test zlyhá, vráti starú.

Preto zlý vhost nezhodí celý server. Rovnaká myšlienka platí pre DNS zóny, ktoré sa pred reloadom BIND overia cez named-checkzone.

Web hostingDNS

Súvisiace Virtuálny host (vhost)Prevzatie vhostuDNS zóna

Blok konfigurácie webservera, ktorý nginxu alebo Apache hovorí, aký web servírovať pre dané doménové meno.

VorqulPanel zapisuje iba vlastné súbory vhostov s predponou vorqul- a všetko ostatné v konfigurácii webservera nechá na pokoji.

Web hosting

Súvisiace Prevzatie vhostuTest konfigurácie s návratomRežim reverse proxy

Výslovné potvrdenie, ktoré je potrebné, kým VorqulPanel smie spravovať web, ktorý našiel už nastavený na serveri.

Adoptované weby sa čítajú bez prepisovania. Po potvrdení sa najprv spraví záloha a prevzatie iba odstráni odkaz v sites-enabled, pôvodný súbor nikdy nemaže.

Installing on a used server

Súvisiace Virtuálny host (vhost)Test konfigurácie s návratom

Nastavenie domény, ktoré predsadí vhost webservera pred aplikáciu bežiacu na lokálnom porte.

Panel zapíše vhost a vie vydať certifikát, takže ľubovoľná aplikácia, aj služba v Node.js alebo Pythone, beží na bežnej doméne s HTTPS.

Web hosting

Súvisiace Virtuálny host (vhost)ACME a Let's Encrypt

Mechanizmus jadra Linuxu, ktorým VorqulPanel obmedzuje pamäť, CPU a počet procesov každého game servera.

Nahrádza nice, cpulimit a ulimit, ktoré buď neobmedzujú skutočné využitie, alebo proces zamrazia. Server nad stropom sa zabije vo vlastnej skupine a panel zaznamená, že to spravilo jadro, takže rozoznáte zabitie pre nedostatok pamäte od pádu.

Game hosting

Súvisiace Analýza pádovRoot helper (vorqul-helper)

Funkcia VorqulPanelu, ktorá prečíta posledné riadky padnutého game servera a pomenuje pravdepodobnú príčinu a riešenie.

Typické príčiny sú zlá verzia Javy, už obsadený port, nedostatok pamäte, chýbajúce EULA, pokazený plugin alebo plný disk. Automatický reštart sa preskočí, keď reštart nemôže pomôcť.

Game hosting

Súvisiace Limity cgroup v2

Kópia zálohy odoslaná na úložisko mimo servera, aby strata stroja neznamenala stratu záloh.

VorqulPanel kópiu zašifruje cez AES-256-GCM ešte pred odoslaním zo servera. Ciele sa nastavujú v paneli a do cloudu ako Google Drive sa dá dostať cez rclone.

Backups guide

Súvisiace Restore drillDatabáza panela

Plánovaná kontrola, pri ktorej panel rozbalí vlastnú najnovšiu zálohu a otvorí databázu v nej.

Dokazuje, že sa archív dá naozaj obnoviť, čo je niečo iné než to, že archív existuje.

Backups guide

Súvisiace Offsite záloha

Účet na prenos súborov obmedzený na jeden adresár, takže nemôže prehliadať zvyšok servera.

Každý game server vo VorqulPaneli dostane vlastný SFTP účet v chroote a weby ho môžu mať obmedzený na svoj priečinok. Ochrana proti hádaniu hesiel je zabudovaná.

SFTP

Súvisiace Audit lognftables

Linuxový paketový filter, ktorý VorqulPanel ovláda popri ufw a firewalld na otváranie a zatváranie portov.

Panel iba pridáva a odstraňuje vlastné označené pravidlá vo vlastných tabuľkách. Nikdy nevyprázdni sadu pravidiel, nezmení predvolenú politiku ani sa nedotkne pravidiel SSH.

Firewall

Súvisiace SFTP v chrooteRoot helper (vorqul-helper)

Sada DNS záznamov pre doménu, ktorú vie VorqulPanel servírovať sám cez BIND9.

Panel zapisuje a overuje súbor zóny a vie kopírovať záznamy do Cloudflare a z neho bez toho, aby tam čokoľvek zmazal.

DNS

Súvisiace Test konfigurácie s návratomDKIMPTR záznam

Protokol a bezplatná certifikačná autorita, ktoré VorqulPanel cez acme.sh alebo certbot používa na vydávanie HTTPS certifikátov.

Vydanie vyžaduje, aby sa DNS záznam najprv preložil na server, alebo token Cloudflare DNS, ktorým sa meno dokáže aj bez portu 80. Let's Encrypt dovoľuje iba päť neúspešných overení na hostname za hodinu, a preto panel pred kontaktom s autoritou skontroluje DNS, port 80 a pokrytie vhostom.

Web hosting

Súvisiace Režim reverse proxyDNS zóna

Kryptografický podpis odchádzajúcej pošty, zverejnený ako DNS záznam, podľa ktorého príjemcovia overia, že správa prišla z vašej domény.

Vo VorqulPaneli sa kľúč vytvorí cez Rspamd pri pridaní mailovej domény a panel ukáže záznam na zverejnenie. Patrí pod doménu v hlavičke From, nikdy pod mailový hostname.

Mail

Súvisiace SPF a DMARCPTR záznamDoručiteľnosť

Dva DNS záznamy, ktoré určujú, ktoré servery smú posielať poštu za doménu a čo majú príjemcovia robiť s poštou, ktorá kontrolou neprejde.

Fungujú spolu s DKIM. VorqulPanel záznamy generuje a jeho kontrola doručiteľnosti nahlási, keď jeden chýba alebo je zlý.

Mail

Súvisiace DKIMDoručiteľnosťMTA-STS a TLS-RPT

Reverzný DNS záznam, ktorý priraďuje IP adrese servera hostname a ktorý príjemcovia pošty kontrolujú.

Nastavuje sa tam, kde sa IP prenajíma, takže ho za vás žiadny panel nezmení. Mailový hostname, ktorý nesedí s PTR, škodí doručiteľnosti viac než chýbajúci certifikát.

Mail

Súvisiace DKIMDoručiteľnosť

Politiky zverejnené v DNS, ktoré odosielajúcim serverom hovoria, že musia na váš mailový server použiť TLS, a kam hlásiť zlyhania.

Bez MTA-STS môže ten, kto vie spojenie zachytiť, odstrániť ponuku STARTTLS a odosielateľ potichu prejde na nešifrovaný prenos. Samotný súbor politiky musí byť dostupný na https://mta-sts.vasa-domena/.well-known/mta-sts.txt.

Mail

Súvisiace SPF a DMARCDoručiteľnosť

Či pošta, ktorú posielate, naozaj dorazí do schránky a nie je odmietnutá alebo odložená ako spam.

Závisí od PTR, SPF, DKIM, DMARC a od reputácie IP adresy. VorqulPanel kontroluje záznamy, mailovú frontu a hlavné verejné blocklisty a povie vám, ktorý z nich je problém.

Mail

Súvisiace DKIMSPF a DMARCPTR záznamMTA-STS a TLS-RPT

Súhrnné skóre, ktoré VorqulBOT počíta zo signálov aktivity, udržania členov, rastu a zapájania nováčikov na Discord serveri.

Skóre zlúči štyri samostatné trendy do jedného čísla, ktoré môžete sledovať v čase. Hodnotí server voči jeho vlastnej histórii, nikoho neporovnáva s nikým iným a nevynáša žiadny verdikt o moderácii.

Server Health ScoreLeveling

Číslovaný záznam každej moderátorskej akcie na Discord serveri, v ktorom sa dá vyhľadávať.

Každý ban, kick, varovanie alebo timeout vytvorí prípad s cieľom, moderátorom, dôvodom, trvaním a časom. O mesiace neskôr stále viete povedať, prečo sa rozhodlo tak a kto to rozhodol, a práve kvôli tomu sa prípady uchovávajú.

ModerationAutoMod

Súvisiace Audit logEskalačný rebríkPrepis ticketu

Jediný zoznam 44 modulov, ktorý číta VorqulBOT aj jeho dashboard, takže prepínač nemôže existovať v jednom a v druhom sa ignorovať.

Register pomenúva každý modul, skupinu, do ktorej patrí, a či je predvolene zapnutý. Deväť je zapnutých od začiatku: moderácia, levelovanie, afk, ankety, ekonomika, hry, giveaway, pripomienky a prefixové príkazy. Ostatných 35 je vypnutých. Proces bota a webový dashboard čítajú ten istý súbor, takže sa obe polovice nemôžu rozísť, čo je typická chyba botov s oddeleným webovým rozhraním.

PluginsVorqulBOT

Jedna z 15 kontrol správ, ktoré VorqulBOT spustí skôr, než správu uvidí moderátor, každá s vlastným prahom, akciou a trvaním.

Filtre pokrývajú spam, opakovaný text, odkazy, pozvánky, veľké písmená, zmienky, hromadné zmienky, ghost pingy, záplavy emoji, záplavy spoilerov, zalgo, phishing, falošný nitro, krypto podvody a vlastné regulárne výrazy. Predvolene sú zapnuté iba phishing a falošný nitro. Každý filter funguje samostatne, takže jeden môže mazať, ďalší dať timeout a tretí ban.

AutoMod

Súvisiace Eskalačný rebríkShadow-mute

Pravidlo, ktoré z určitého počtu previnení v časovom okne spraví prísnejšiu akciu, bez toho aby sa moderátor rozhodoval zakaždým.

VorqulBOT má dve. Eskalácia AutoModu sa spustí pri opakovaných zásahoch filtra v okne, predvolene jedna hodina. Akcie pri varovaniach fungujú rovnako, ale ručne: počet, okno v dňoch a akcia, takže tri varovania za sedem dní môžu znamenať mute. Viac pravidiel sa dá kombinovať a opakovaní páchatelia eskalujú sami.

ModerationAutoMod

Súvisiace História prípadovFilter AutoModJail

Mute, pri ktorom člen stále vidí svoje správy a nikto iný nie.

Odstráni spätnú väzbu. Ak členovi poviete, že je umlčaný, hádá sa o tom alebo sa vráti z iného účtu. Ak vidí svoje správy zverejnené ako zvyčajne, väčšinou stratí záujem. VorqulBOT ho ponúka ako shadowmute a unshadowmute vedľa bežného mute, timeoutu a jailu.

Moderation

Moderačný stav, ktorý členovi odoberie roly a zúži jeho prístup na obmedzenú skupinu kanálov.

Jail je medzi timeoutom a banom. Člen zostáva na serveri a stále sa s ním dá rozprávať, čo pomáha, kým riešite incident, ale stratí prístup ku všetkému, k čomu sa predtým dostal. Roly sa vrátia pri unjail.

Moderation

Súvisiace Kontrola alternatívnych účtovEskalačný rebrík

Modul, ktorý nechá staré textové príkazy ako !daily fungovať vedľa slash príkazov.

Slash príkazy vyhrávajú takmer vo všetkom, ale server, ktorý tri roky píše !daily, bude písať ďalej. Most namapuje textovú formu na ten istý handler. Nikto sa nemusí preúčať a nič sa neudržiava dvakrát. Je to jeden z deviatich modulov zapnutých predvolene.

VorqulBOTEconomy

Súvisiace Slash príkaz

Konfiguračný súbor, ktorý panelu Pterodactyl hovorí, ako nainštalovať a spustiť konkrétnu aplikáciu.

VorqulBOT ho dodáva. Importujete ho, nahráte súbory cez SFTP, vložíte Discord token do Startup premenných a stlačíte štart. Prvý štart sám nainštaluje závislosti a skompiluje kód. Ak už prevádzkujete panel na game hosting, je to najkratšia cesta, ako bota rozbehnúť.

VorqulBOTDirect answers

Súvisiace Self-hostedPrivileged intents

Limit na úrovni servera vo VorqulBOT (free, premium alebo pro), ktorý zvyšuje stropy pri niekoľkých funkciách.

Stropy sa týkajú pripnutých správ, reaction rolí, automatických odpovedí, plánovaných správ a odchádzajúcich webhookov. Free dovoľuje 3 pripnuté správy, 5 reaction rolí, 10 automatických odpovedí, 5 plánovaných správ a žiadne webhooky. Pro dovoľuje 100, 100, 500, 200 a 5. Bot je self-hosted, takže úroveň nastavujete svojim serverom sami a nikdy ju nekupujete odo mňa.

Direct answers

Hash HMAC-SHA256 tela požiadavky poslaný v hlavičke, aby príjemca mohol dokázať, že požiadavka prišla od bota.

VorqulBOT posiela na vami zvolenú adresu štyri udalosti o členoch: pripojenie, odchod, ban a unban. Ak nastavíte zdieľané tajomstvo, každá požiadavka nesie hlavičku X-Vorqul-Signature vypočítanú z tela týmto tajomstvom a váš endpoint môže odmietnuť všetko, čo nesedí. Bez tajomstva udalosti stále chodia, len neoverené.

Plugins

Súvisiace Prihlásenie do dashboardu cez OAuth2

Minimálny čas medzi dvoma správami, ktoré obe získavajú XP. VorqulBOT predvolene používa 60 sekúnd.

Bez cooldownu levelovanie odmeňuje objem a vrch rebríčka patrí tomu, kto napíše najviac jednoslovných správ. S ním dvadsať rýchlych správ prinesie presne toľko ako jedna. Je to najdôležitejšie nastavenie levelovacieho systému a servery ho najčastejšie nechajú tak, ako prišlo s botom.

Leveling

Heuristické skóre, ktoré môže moderátor spustiť na jedného člena, vypočítané z veku účtu, avatara, dátumu pripojenia a rolí.

Účet mladší než 7 dní dostane 40, mladší než 30 dní 25 a mladší než 90 dní 10. Predvolený avatar pridá 20, pripojenie pred menej než dňom 15, žiadne roly 10 a boti dostanú nulu. Výsledok berte ako podklad pre ľudské rozhodnutie a automatický ban preskočte. Takéto heuristiky dávajú falošné poplachy a nesprávny ban stojí viac dôvery, než ušetrí času.

ModerationAnti-Raid

Súvisiace JailHistória prípadov

Konverzácia z tiketu podpory zapísaná do textového súboru a poslaná do kanála, ktorý určíte.

VorqulBOT exportuje posledných 100 správ kanála tiketu. Toľko vráti Discord jedným dotazom a zvyčajne to pokryje celý tiket. Súbor je schválne obyčajný: text, autori a časy, takže sa otvorí kdekoľvek a ľahko sa v ňom hľadá. Nič nejde do externej služby.

Tickets

Nastavenia Discordu, ktoré musí bot zapnúť, aby videl prítomnosť, členov servera a obsah správ.

VorqulBOT potrebuje zapnuté intenty prítomnosti, členov servera a obsahu správ v Discord developer portáli. Bez nich sa zdá, že príkazy nerobia nič.

Discord setup

Súvisiace Slash príkazPrihlásenie do dashboardu cez OAuth2

Discord príkaz písaný s lomkou na začiatku, ktorý bot zaregistruje v Discorde a ten ho ukáže vo výbere príkazov.

Registrácia vyžaduje scope applications.commands v pozvánke a krok deploy. Keď slash príkazy chýbajú, zopakujte deploy a skontrolujte scope pozvánky.

VorqulBOT

Súvisiace Privileged intentsPrefix bridge

Ako sa prihlásite do dashboardu VorqulBOTa: cez Discord, s redirect adresou, ktorá sa musí zhodovať s tou, ktorú ste zaregistrovali.

Nezhoda medzi redirect URI v Discord portáli a adresou dashboardu je najčastejšia príčina neúspešného prihlásenia. Ak necháte NEXTAUTH_URL prázdne, zistí sa automaticky.

First dashboard sign-in

Súvisiace Privileged intentsPodpis webhooku

Textový index v koreni webu, ktorý jazykovým modelom ukazuje jeho kanonický obsah.

Konvencia preberá tvar z robots.txt a funguje opačne: namiesto obmedzovania robotov im ponúka vybranú mapu. Je to vznikajúca konvencia, nie schválený štandard, a nikto nezávisle nepreukázal, nakoľko pomáha pri vyhľadávaní. vorqul.com ho zverejňuje na /llms.txt a plnú verziu na /llms-full.txt.

llms.txt

Súvisiace Entity homeVykresľovanie na serveri

Jediná kanonická stránka, ktorú značka vlastní a ktorá strojovo čitateľne uvádza, čo je zač.

Entity home uvádza jasné tvrdenia o kategórii, účele a publiku, podopiera ich štruktúrovanými dátami a potvrdzuje sa, keď sa rovnaký opis objaví na profiloch tretích strán. Ak sa tieto zdroje rozchádzajú, systém entite dôveruje menej. Pre Vorqul je to stránka /about prepojená s identifikátorom vo Wikidata.

About

Súvisiace llms.txt

Vytvorenie úplného HTML ešte pred tým, ako dorazí ku klientovi, namiesto skladania stránky JavaScriptom v prehliadači.

Vyhľadávacie roboty za odpoveďovými enginmi sťahujú HTML a JavaScript väčšinou preskočia, takže všetko, čo vznikne až po hydratácii na klientovi, je pre nich neviditeľné. vorqul.com je postavený staticky. Každá stránka príde ako úplné HTML a malé množstvo JavaScriptu rieši menu, jazykový tip a analytiku, s ktorou ste súhlasili.

Súvisiace llms.txt