Pojmy, definované jednou

Software, který běží na hardwaru, který provozovatel vlastní nebo si přímo pronajímá, bez čehokoli na straně výrobce.

Self-hosted produkt si nainstalujete na vlastní stroj a běží tam. Žádná databáze výrobce nedrží vaše záznamy, neexistuje účet za uživatele a žádná služba vám nemůže zrušit přístup k datům, která už máte na disku. Takhle fungují oba produkty Vorqul: VorqulBOT běží jako proces Node a VorqulPanel jako Java JAR.

VorqulPanelDirect answers

Související Ovládací panel serveruTelemetrieJednorázová licence

Jedno administrační rozhraní pro služby, které běží na linuxovém serveru.

Ovládací panel dává webhosting, DNS, mail, databáze, přístup k souborům, pravidla firewallu a monitoring pod jedno rozhraní. Běžné změny už neznamenají samostatný konfigurační soubor pro každý podsystém. VorqulPanel pokrývá tyto oblasti na jednom serveru a vlastní data drží v SQLite, případně v MySQL, MariaDB nebo PostgreSQL.

VorqulPanel

Související Self-hostedPřepínač moduluDatabáze panelu

Jediný nákup, který pokrývá jedno nasazení, místo opakovaného předplatného.

VorqulPanel se licencuje takto. Platíte jednou za nasazení, cena závisí na počtu serverů, na kterých běží, a verzi, kterou jste koupili, můžete používat dál bez obnovy. Redistribuce, přeprodej, sublicencování a hosting pro třetí strany jsou vyloučeny.

License

Související Self-hostedTelemetrie

Údaje o používání, které nainstalovaný software posílá zpět svému výrobci.

Telemetrie se objevuje v open source i komerčním softwaru a výrobci jí obvykle říkají anonymní. Produkty Vorqul neposílají žádnou. To znamená i žádnou kontrolu licence za běhu a nic, co by přestalo fungovat, kdyby přestal fungovat výrobce.

Direct answers

Související Self-hostedAudit log

Záznam administračních akcí, do kterého se jen přidává, aby se daly změny připsat konkrétní osobě i později.

Vědět, že se nastavení změnilo, je jedna věc. Vědět, kdo ho změnil, kdy a odkud, je to, co dává audit log. VorqulBOT ho vede pro každý server a VorqulPanel pro každý stroj a oba zůstávají na infrastruktuře, kterou provozovatel ovládá.

Moderation

Související Dvoufaktorové ověření (TOTP)Historie případů

Kde VorqulPanel drží vlastní stav: výchozně SQLite, s MySQL, MariaDB a PostgreSQL jako možnostmi a SQL Server v beta.

Je oddělená od databází, které panel vytváří pro vaše weby. Změna enginu později data nepřenese, proto ho vyberte při instalaci přes DB_ENGINE.

Database managementUnattended install

Související Ovládací panel serveruOffsite záloha

Nastavení, které zapne nebo vypne celou část VorqulPanelu: game hosting, webhosting, mail nebo některou z jejich podfunkcí.

Vypnutý přepínač skryje položku menu a zároveň způsobí, že API odpoví 404, takže se funkce nedá dosáhnout ani přes URL. Nic se neodinstaluje a nemažou se žádná data a po opětovném zapnutí je všechno zpět.

Feature switches

Související Root helper (vorqul-helper)vorqulctl

Druhý krok přihlášení s časovým kódem z aplikace, který VorqulPanel umí vyžadovat od adminů.

Zapněte ho v Settings, Account hned po vytvoření admina. Pokud ztratíte přístup, vorqulctl reset-admin vydá nový odkaz pro nastavení.

First login

Související Setup URLAudit log

Nástroj příkazové řádky, který se instaluje s VorqulPanelem pro spouštění, aktualizaci, obnovu a kontrolu panelu.

Obaluje službu systemd a úlohy kolem ní: status, logs, setup-url, reset-admin, modules, update s automatickým návratem, fix-libs a uninstall. Spouští se jako root nebo přes sudo.

Command reference

Související Setup URLRoot helper (vorqul-helper)Přepínač modulu

Malý skript ve vlastnictví roota, který dělá několik privilegovaných akcí, které VorqulPanel potřebuje, takže samotný panel může běžet jako neprivilegovaný uživatel.

Přijímá pevný seznam akcí a všechno ostatní odmítne. Jeho politika je v /etc/vorqul-helper.conf a je zúžená na moduly, které jste zapnuli, a proto zapnutí modulu jen v Settings panelu tato práva nedá.

The root helper

Související vorqulctlLimity cgroup v2Přepínač modulu

Jednorázový odkaz, který vypíše instalátor a který otevře formulář pro vytvoření prvního admin účtu.

Dokud neexistuje admin, vytvořit ho může ten, kdo se první dostane na port panelu, proto se okno zavře hodinu po startu panelu. vorqulctl setup-url vypíše nový odkaz a vorqulctl reset-admin vydá odkaz pro nového admina.

First login

Související vorqulctlDvoufaktorové ověření (TOTP)

Bezpečnostní krok, který VorqulPanel spustí před použitím změny webserveru: otestuje novou konfiguraci a pokud test selže, vrátí starou.

Proto špatný vhost neshodí celý server. Stejná myšlenka platí pro DNS zóny, které se před reloadem BIND ověří přes named-checkzone.

Web hostingDNS

Související Virtuální host (vhost)Převzetí vhostuDNS zóna

Blok konfigurace webserveru, který nginxu nebo Apache říká, jaký web servírovat pro dané doménové jméno.

VorqulPanel zapisuje jen vlastní soubory vhostů s předponou vorqul- a všechno ostatní v konfiguraci webserveru nechá na pokoji.

Web hosting

Související Převzetí vhostuTest konfigurace s návratemRežim reverse proxy

Výslovné potvrzení, které je potřeba, než smí VorqulPanel spravovat web, který našel už nastavený na serveru.

Adoptované weby se čtou bez přepisování. Po potvrzení se nejdřív udělá záloha a převzetí jen odstraní odkaz v sites-enabled, původní soubor nikdy nemaže.

Installing on a used server

Související Virtuální host (vhost)Test konfigurace s návratem

Nastavení domény, které předsadí vhost webserveru před aplikaci běžící na lokálním portu.

Panel zapíše vhost a umí vydat certifikát, takže libovolná aplikace, i služba v Node.js nebo Pythonu, běží na běžné doméně s HTTPS.

Web hosting

Související Virtuální host (vhost)ACME a Let's Encrypt

Mechanismus jádra Linuxu, kterým VorqulPanel omezuje paměť, CPU a počet procesů každého game serveru.

Nahrazuje nice, cpulimit a ulimit, které buď neomezují skutečné využití, nebo proces zmrazí. Server nad stropem se zabije ve vlastní skupině a panel zaznamená, že to udělalo jádro, takže rozpoznáte zabití pro nedostatek paměti od pádu.

Game hosting

Související Analýza pádůRoot helper (vorqul-helper)

Funkce VorqulPanelu, která přečte poslední řádky spadlého game serveru a pojmenuje pravděpodobnou příčinu a řešení.

Typické příčiny jsou špatná verze Javy, už obsazený port, nedostatek paměti, chybějící EULA, rozbitý plugin nebo plný disk. Automatický restart se přeskočí, když restart nemůže pomoci.

Game hosting

Související Limity cgroup v2

Kopie zálohy odeslaná na úložiště mimo server, aby ztráta stroje neznamenala ztrátu záloh.

VorqulPanel kopii zašifruje přes AES-256-GCM ještě před odesláním ze serveru. Cíle se nastavují v panelu a do cloudu jako Google Drive se dá dostat přes rclone.

Backups guide

Související Restore drillDatabáze panelu

Plánovaná kontrola, při které panel rozbalí vlastní nejnovější zálohu a otevře v ní databázi.

Dokazuje, že se archiv dá opravdu obnovit, což je něco jiného než to, že archiv existuje.

Backups guide

Související Offsite záloha

Účet pro přenos souborů omezený na jeden adresář, takže nemůže procházet zbytek serveru.

Každý game server ve VorqulPanelu dostane vlastní SFTP účet v chrootu a weby ho mohou mít omezený na svou složku. Ochrana proti hádání hesel je zabudovaná.

SFTP

Související Audit lognftables

Linuxový paketový filtr, který VorqulPanel ovládá vedle ufw a firewalld pro otevírání a zavírání portů.

Panel jen přidává a odstraňuje vlastní označená pravidla ve vlastních tabulkách. Nikdy nevyprázdní sadu pravidel, nezmění výchozí politiku ani se nedotkne pravidel SSH.

Firewall

Související SFTP v chrootuRoot helper (vorqul-helper)

Sada DNS záznamů pro doménu, kterou umí VorqulPanel servírovat sám přes BIND9.

Panel zapisuje a ověřuje soubor zóny a umí kopírovat záznamy do Cloudflare a z něj, aniž by tam cokoli smazal.

DNS

Související Test konfigurace s návratemDKIMPTR záznam

Protokol a bezplatná certifikační autorita, které VorqulPanel přes acme.sh nebo certbot používá k vydávání HTTPS certifikátů.

Vydání vyžaduje, aby se DNS záznam nejdřív přeložil na server, nebo token Cloudflare DNS, kterým se jméno dokáže i bez portu 80. Let's Encrypt dovoluje jen pět neúspěšných ověření na hostname za hodinu, a proto panel před kontaktem s autoritou zkontroluje DNS, port 80 a pokrytí vhostem.

Web hosting

Související Režim reverse proxyDNS zóna

Kryptografický podpis odchozí pošty, zveřejněný jako DNS záznam, podle kterého příjemci ověří, že zpráva přišla z vaší domény.

Ve VorqulPanelu se klíč vytvoří přes Rspamd při přidání mailové domény a panel ukáže záznam ke zveřejnění. Patří pod doménu v hlavičce From, nikdy pod mailový hostname.

Mail

Související SPF a DMARCPTR záznamDoručitelnost

Dva DNS záznamy, které určují, které servery smějí posílat poštu za doménu a co mají příjemci dělat s poštou, která kontrolou neprojde.

Fungují spolu s DKIM. VorqulPanel záznamy generuje a jeho kontrola doručitelnosti nahlásí, když jeden chybí nebo je špatný.

Mail

Související DKIMDoručitelnostMTA-STS a TLS-RPT

Reverzní DNS záznam, který přiřazuje IP adrese serveru hostname a který příjemci pošty kontrolují.

Nastavuje se tam, kde se IP pronajímá, takže ho za vás žádný panel nezmění. Mailový hostname, který nesedí s PTR, škodí doručitelnosti víc než chybějící certifikát.

Mail

Související DKIMDoručitelnost

Politiky zveřejněné v DNS, které odesílajícím serverům říkají, že musí na váš mailový server použít TLS, a kam hlásit selhání.

Bez MTA-STS může ten, kdo umí spojení zachytit, odstranit nabídku STARTTLS a odesílatel potichu přejde na nešifrovaný přenos. Samotný soubor politiky musí být dostupný na https://mta-sts.vase-domena/.well-known/mta-sts.txt.

Mail

Související SPF a DMARCDoručitelnost

Zda pošta, kterou posíláte, opravdu dorazí do schránky a není odmítnuta nebo odložena jako spam.

Závisí na PTR, SPF, DKIM, DMARC a na reputaci IP adresy. VorqulPanel kontroluje záznamy, mailovou frontu a hlavní veřejné blocklisty a řekne vám, který z nich je problém.

Mail

Související DKIMSPF a DMARCPTR záznamMTA-STS a TLS-RPT

Souhrnné skóre, které VorqulBOT počítá ze signálů aktivity, udržení členů, růstu a zapojování nováčků na Discord serveru.

Skóre sloučí čtyři samostatné trendy do jednoho čísla, které můžete sledovat v čase. Hodnotí server vůči jeho vlastní historii, nikoho neporovnává s nikým jiným a nevynáší žádný verdikt o moderaci.

Server Health ScoreLeveling

Číslovaný záznam každé moderátorské akce na Discord serveru, ve kterém se dá vyhledávat.

Každý ban, kick, varování nebo timeout vytvoří případ s cílem, moderátorem, důvodem, délkou a časem. I po měsících pořád víte říct, proč se rozhodlo tak a kdo to rozhodl, a právě kvůli tomu se případy uchovávají.

ModerationAutoMod

Související Audit logEskalační žebříkPřepis ticketu

Jediný seznam 44 modulů, který čte VorqulBOT i jeho dashboard, takže přepínač nemůže existovat v jednom a v druhém se ignorovat.

Registr pojmenovává každý modul, skupinu, do které patří, a zda je výchozně zapnutý. Devět je zapnutých od začátku: moderace, levelování, afk, ankety, ekonomika, hry, giveaway, připomínky a prefixové příkazy. Ostatních 35 je vypnutých. Proces bota a webový dashboard čtou stejný soubor, takže se obě poloviny nemohou rozejít, což je typická chyba botů s odděleným webovým rozhraním.

PluginsVorqulBOT

Jedna z 15 kontrol zpráv, které VorqulBOT spustí dřív, než zprávu uvidí moderátor, každá s vlastním prahem, akcí a délkou.

Filtry pokrývají spam, opakovaný text, odkazy, pozvánky, velká písmena, zmínky, hromadné zmínky, ghost pingy, záplavy emoji, záplavy spoilerů, zalgo, phishing, falešný nitro, krypto podvody a vlastní regulární výrazy. Výchozně jsou zapnuté jen phishing a falešný nitro. Každý filtr funguje samostatně, takže jeden může mazat, další dát timeout a třetí ban.

AutoMod

Související Eskalační žebříkShadow-mute

Pravidlo, které z určitého počtu přestupků v časovém okně udělá přísnější akci, aniž by se moderátor rozhodoval pokaždé.

VorqulBOT má dvě. Eskalace AutoModu se spustí při opakovaných zásazích filtru v okně, výchozně jedna hodina. Akce při varováních fungují stejně, ale ručně: počet, okno ve dnech a akce, takže tři varování za sedm dní mohou znamenat mute. Víc pravidel se dá kombinovat a opakovaní provinilci eskalují sami.

ModerationAutoMod

Související Historie případůFiltr AutoModJail

Mute, při kterém člen pořád vidí své zprávy a nikdo jiný ne.

Odstraní zpětnou vazbu. Když členovi řeknete, že je umlčený, hádá se o tom nebo se vrátí z jiného účtu. Když vidí své zprávy zveřejněné jako obvykle, většinou ztratí zájem. VorqulBOT ho nabízí jako shadowmute a unshadowmute vedle běžného mute, timeoutu a jailu.

Moderation

Moderační stav, který členovi odebere role a zúží jeho přístup na omezenou skupinu kanálů.

Jail je mezi timeoutem a banem. Člen zůstává na serveru a pořád se s ním dá mluvit, což pomáhá, dokud řešíte incident, ale ztratí přístup ke všemu, k čemu se předtím dostal. Role se vrátí při unjail.

Moderation

Související Kontrola alternativních účtůEskalační žebřík

Modul, který nechá staré textové příkazy jako !daily fungovat vedle slash příkazů.

Slash příkazy vyhrávají skoro ve všem, ale server, který tři roky píše !daily, bude psát dál. Most namapuje textovou formu na stejný handler. Nikdo se nemusí přeučovat a nic se neudržuje dvakrát. Je to jeden z devíti modulů zapnutých výchozně.

VorqulBOTEconomy

Související Slash příkaz

Konfigurační soubor, který panelu Pterodactyl říká, jak nainstalovat a spustit konkrétní aplikaci.

VorqulBOT ho dodává. Importujete ho, nahrajete soubory přes SFTP, vložíte Discord token do Startup proměnných a stisknete start. První start sám nainstaluje závislosti a zkompiluje kód. Pokud už provozujete panel na game hosting, je to nejkratší cesta, jak bota rozjet.

VorqulBOTDirect answers

Související Self-hostedPrivileged intents

Limit na úrovni serveru ve VorqulBOT (free, premium nebo pro), který zvyšuje stropy u několika funkcí.

Stropy se týkají připnutých zpráv, reaction rolí, automatických odpovědí, plánovaných zpráv a odchozích webhooků. Free dovoluje 3 připnuté zprávy, 5 reaction rolí, 10 automatických odpovědí, 5 plánovaných zpráv a žádné webhooky. Pro dovoluje 100, 100, 500, 200 a 5. Bot je self-hosted, takže úroveň nastavujete svým serverům sami a nikdy ji nekupujete ode mě.

Direct answers

Hash HMAC-SHA256 těla požadavku poslaný v hlavičce, aby příjemce mohl dokázat, že požadavek přišel od bota.

VorqulBOT posílá na vámi zvolenou adresu čtyři události o členech: připojení, odchod, ban a unban. Pokud nastavíte sdílené tajemství, každý požadavek nese hlavičku X-Vorqul-Signature vypočtenou z těla tímto tajemstvím a váš endpoint může odmítnout všechno, co nesedí. Bez tajemství události dál chodí, jen neověřené.

Plugins

Související Přihlášení do dashboardu přes OAuth2

Minimální čas mezi dvěma zprávami, které obě získávají XP. VorqulBOT výchozně používá 60 sekund.

Bez cooldownu levelování odměňuje objem a vrch žebříčku patří tomu, kdo napíše nejvíc jednoslovných zpráv. S ním dvacet rychlých zpráv přinese přesně tolik jako jedna. Je to nejdůležitější nastavení levelovacího systému a servery ho nejčastěji nechají tak, jak přišlo s botem.

Leveling

Heuristické skóre, které může moderátor spustit na jednoho člena, vypočtené z věku účtu, avatara, data připojení a rolí.

Účet mladší než 7 dní dostane 40, mladší než 30 dní 25 a mladší než 90 dní 10. Výchozí avatar přidá 20, připojení před méně než dnem 15, žádné role 10 a boti dostanou nulu. Výsledek berte jako podklad pro lidské rozhodnutí a automatický ban přeskočte. Takové heuristiky dávají falešné poplachy a nesprávný ban stojí víc důvěry, než ušetří času.

ModerationAnti-Raid

Související JailHistorie případů

Konverzace z tiketu podpory zapsaná do textového souboru a poslaná do kanálu, který určíte.

VorqulBOT exportuje posledních 100 zpráv kanálu tiketu. Tolik vrátí Discord jedním dotazem a obvykle to pokryje celý tiket. Soubor je schválně obyčejný: text, autoři a časy, takže se otevře kdekoli a snadno se v něm hledá. Nic nejde do externí služby.

Tickets

Nastavení Discordu, která musí bot zapnout, aby viděl přítomnost, členy serveru a obsah zpráv.

VorqulBOT potřebuje zapnuté intenty přítomnosti, členů serveru a obsahu zpráv v Discord developer portálu. Bez nich to vypadá, že příkazy nedělají nic.

Discord setup

Související Slash příkazPřihlášení do dashboardu přes OAuth2

Discord příkaz psaný s lomítkem na začátku, který bot zaregistruje v Discordu a ten ho ukáže ve výběru příkazů.

Registrace vyžaduje scope applications.commands v pozvánce a krok deploy. Když slash příkazy chybí, zopakujte deploy a zkontrolujte scope pozvánky.

VorqulBOT

Související Privileged intentsPrefix bridge

Jak se přihlásíte do dashboardu VorqulBOTu: přes Discord, s redirect adresou, která se musí shodovat s tou, kterou jste zaregistrovali.

Neshoda mezi redirect URI v Discord portálu a adresou dashboardu je nejčastější příčina neúspěšného přihlášení. Když necháte NEXTAUTH_URL prázdné, zjistí se automaticky.

First dashboard sign-in

Související Privileged intentsPodpis webhooku

Textový index v kořeni webu, který jazykovým modelům ukazuje jeho kanonický obsah.

Konvence přebírá tvar z robots.txt a funguje opačně: místo omezování robotů jim nabízí vybranou mapu. Je to vznikající konvence, ne schválený standard, a nikdo nezávisle neprokázal, nakolik pomáhá při vyhledávání. vorqul.com ho zveřejňuje na /llms.txt a plnou verzi na /llms-full.txt.

llms.txt

Související Entity homeVykreslování na serveru

Jediná kanonická stránka, kterou značka vlastní a která strojově čitelně uvádí, co je zač.

Entity home uvádí jasná tvrzení o kategorii, účelu a publiku, podpírá je strukturovanými daty a potvrzuje se, když se stejný popis objeví na profilech třetích stran. Pokud se tyto zdroje rozcházejí, systém entitě důvěřuje méně. Pro Vorqul je to stránka /about propojená s identifikátorem ve Wikidata.

About

Související llms.txt

Vytvoření úplného HTML ještě před tím, než dorazí ke klientovi, místo skládání stránky JavaScriptem v prohlížeči.

Vyhledávací roboti za odpovědními enginy stahují HTML a JavaScript většinou přeskočí, takže všechno, co vznikne až po hydrataci na klientovi, je pro ně neviditelné. vorqul.com je postaven staticky. Každá stránka přijde jako úplné HTML a malé množství JavaScriptu řeší menu, jazykový tip a analytiku, se kterou jste souhlasili.

Související llms.txt