Preskočiť na obsah
VORQUL
Dokumentácia / VorqulPanel / Inštalácia a administrácia

Nainštaluj VorqulPanel na Linux server

Väčšinu času zaberie čakanie na inštaláciu balíkov a šírenie DNS, nie samotný panel. Poradie nižšie je to, ktoré ťa nezamkne von.

Inštalácia VorqulPanel trvá zhruba 15 až 30 minút na čistom Linux serveri. Potrebuje Debian 12, Ubuntu 22.04 alebo novší, alebo AlmaLinux 9, s root prístupom a aspoň 2 GB RAM. Panel sa dodáva ako jeden JAR so scripts/install.sh, ktorý nainštaluje Java 25, ak chýba, vytvorí používateľa služby, zaregistruje systemd unit vorqul-panel a otvorí porty 8765 až 8767. Nie je tu žiadny build krok, žiadny runtime pre kontajnery ani externá databáza. Panel drží svoj stav predvolene v SQLite.

Čas
15 až 30 minút
Runtime
Java 25 alebo novšia, nainštaluje sa za teba
Distribúcie
Debian 12, Ubuntu 22.04+, AlmaLinux 9
Úložisko panela
SQLite, žiadna externá DB

Požiadavky

Minimálne požiadavky pred inštaláciou
RAM Minimum 2 GB
Prístup Root na čistom serveri
Java 25 alebo novšia, inštalátor ju pridá
Porty SSH, 8765 až 8767, 80 a 443
DNS A záznam smerujúci na server, kvôli certifikátom
Runtime pre kontajnery Nevyžaduje sa
Requirements for Inštalácia VorqulPanel: RAM Minimum 2 GB, Prístup Root na čistom serveri, Java 25 alebo novšia, inštalátor ju pridá, Porty SSH, 8765 až 8767, 80 a 443, DNS A záznam smerujúci na server, kvôli certifikátom, Runtime pre kontajnery Nevyžaduje sa.

Inštalácia

Čistý server je skutočná požiadavka, nielen odporúčanie. Panel spravuje nginx, Apache, BIND9, Postfix, Dovecot, MariaDB a nftables a je to oveľa jednoduchšie na stroji, kde ich nainštaloval sám.

  1. Step 01

    Debian 12, Ubuntu 22.04 alebo novší, alebo AlmaLinux 9, čerstvo pripravený, s root prístupom cez SSH.

    Inštalácia na server, ktorý už beží na cudzom webovom stacku, je možná. Inštalátor neponúka preinštalovanie webservera, PHP-FPM, MariaDB, certbotu, BIND, Postfixu ani fail2ban, ktoré tam už sú, a panel číta existujúce vhosty bez prepisovania, kým nepotvrdíš prevzatie. Stále to ale nie je inštalácia, ktorú robiť ako prvú.

  2. Step 02

    Panel je jeden JAR a potrebuje Java 25 alebo novšiu. Inštalátor ju nainštaluje, ak chýba, takže tu nemusíš nič robiť, pokiaľ si to nechceš najprv skontrolovať.

    bash
    java -version
  3. Step 03

    Vedz, na akom porte počúva tvoj SSH démon, a uisti sa, že sa vieš vrátiť. Firewall príde neskôr a bude na to potrebovať explicitné pravidlo.

    Neštandardný SSH port plus predvolená sada pravidiel firewallu je klasický spôsob, ako sa zamknúť mimo čerstvej inštalácie panela.

Inštalácia

Jeden skript urobí celú inštaláciu. Nič sa nekompiluje.

  1. Step 04

    Vydanie je jeden priečinok s JAR, adresárom scripts a šablónami systemd unit. Daj ho niekam natrvalo, napríklad do /root/vorqul-panel.

    Priečinok po inštalácii nemaž. Používajú ho vorqulctl fix-libs a neskoršie aktualizácie. Knižnice v lib/ inštalátor sťahuje z Maven Central s overením kontrolného súčtu, takže ich netreba kopírovať.

    VorqulPanel je v alfe a zatiaľ sa na testovanie nerozdáva e-mailom. Keď ti niekto build pošle, archív prichádza s presnými príkazmi pre danú verziu. Kroky tu popisujú, čo tie príkazy robia.

    • vorqul-panel.jar je samotný panel
    • scripts/install.sh je inštalátor a je povinný
    • scripts/vorqul-helper je root pomocník pre porty firewallu, limity zdrojov a služby
    • scripts/vorqulctl je nástroj príkazového riadka
    • scripts/vorqul-doctor.sh je voliteľný diagnostický skript
    • systemd/ obsahuje šablóny služieb, voliteľné, lebo inštalátor má vlastnú kópiu
  2. Step 05

    Opýta sa, ktoré časti chceš, nainštaluje, čo chýba, vytvorí používateľa služby a vypíše jednorazovú URL na nastavenie.

    • Pýta sa, ktoré moduly zapnúť: hosting hier, webhosting, mail
    • Pýta sa, ktoré balíky nainštalovať: nginx alebo Apache, PHP-FPM, MariaDB, certbot, BIND, Postfix s Dovecot, Rspamd, herné nástroje, fail2ban
    • Nainštaluje Java, ak chýba, a vytvorí systémového používateľa vorqul
    • Skopíruje JAR do /opt/vorqul-panel, zapíše konfiguráciu s náhodným secretom a nastaví systemd služby
    • Otvorí porty v ufw alebo firewalld a vypíše URL na nastavenie
    bash
    sudo bash scripts/install.sh

    Inštalátor hľadá JAR v target/, vedľa koreňa repozitára alebo vedľa skriptu, takže ho spusti z rozbaleného priečinka.

  3. Step 06

    Každá otázka má premennú prostredia. S YES=1 sa nič nepýta a použijú sa premenné alebo predvolené hodnoty.

    • INSTAL_DIR (predvolene /opt/vorqul-panel), DATA_DIR a LOG_DIR určujú, kde bude JAR, dáta a logy
    • SYSTEM_USER (predvolene vorqul) je používateľ, pod ktorým panel beží
    • PORT, SFTP_PORT a SFTP_DAEMON_PORT sú predvolene 8765, 8766 a 8767
    • MOD_GAMES, MOD_WEB a MOD_MAIL sú predvolene 1 a prepínajú tri časti panela
    • WEB_SERVER je nginx, apache alebo none a platí len s MOD_WEB=1
    • INSTALL_PHP, INSTALL_MARIADB, INSTALL_CERTBOT, INSTALL_BIND, INSTALL_MAIL, INSTALL_RSPAMD, INSTALL_FAIL2BAN a INSTALL_GAMETOOLS vyberajú balíky
    • DB_ENGINE je predvolene sqlite, s možnosťami mysql, postgres a mssql a DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS pre pripojenie
    • WEB_ADMIN=1 nainštaluje root pomocníka a úzky sudoers súbor, USE_EXISTING=0 dovolí inštalátoru siahnuť na už nainštalovaný softvér
    bash
    sudo YES=1 MOD_MAIL=0 WEB_SERVER=nginx INSTALL_PHP=1 INSTALL_MARIADB=1 INSTALL_CERTBOT=1 bash scripts/install.sh

    Podpora SQL Server je beta. SQLite, MySQL, MariaDB a PostgreSQL boli overené na reálnych serveroch. Neskoršia zmena db.engine žiadne dáta nepresunie.

  4. Step 07

    Panel beží ako zabezpečená systemd služba vorqul-panel. Skontroluj, či sa spustil, a ak nie, prečítaj si žurnál.

    bash
    sudo systemctl status vorqul-panel
    sudo vorqulctl status
    sudo vorqulctl logs err

    Ak inštalácia balíkov počas nastavenia zlyhá, obvyklou príčinou je RestrictSUIDSGID=yes v unit súbore, ktoré rozbíja post-install skripty.

  5. Step 08

    Inštalátor otvorí 8765, 8766 a 8767 v ufw alebo firewalld. Pri čistom nftables sa najprv opýta a vloží jedno pravidlo, ktoré neprežije reštart.

    Pri čistom nftables pridaj aj tcp dport { 8765, 8766, 8767 } accept do /etc/nftables.conf. Za reverzným proxy musia byť verejné len 80 a 443 a 8765 má zostať zatvorený pre internet.

    • Panel 8765, vstavané SFTP 8766, SFTP démon 8767, všetko tcp
    • Weby 80 a 443, mail 25, 587, 465, 143, 993 a 4190, DNS 53 na tcp a udp
    • Každý herný server otvorí svoj port pri vytvorení a Hytale používa UDP 5520

Inštalácia

Odtiaľto sa všetko robí v prehliadači.

  1. Step 09

    Choď na http://your-server:8765/. Kým neexistuje admin, otvorí sa formulár nastavenia. Celý odkaz dostaneš od inštalátora alebo z príkazu nižšie.

    bash
    sudo vorqulctl setup-url

    Admina môže vytvoriť ten, kto sa na port dostane prvý. Toto okno sa zatvorí hodinu po spustení panelu a potom už potrebuješ odkaz na nastavenie.

  2. Step 10

    Prvý účet vytvor hneď a potom zapni dvojfaktorové overenie v Nastavenia, Účet. Dvojfaktorové overenie môžeš pre adminov urobiť povinným.

    Ak admin účet niekedy stratíš, spusti sudo vorqulctl reset-admin a potom sudo vorqulctl start. Vypíše nový odkaz na nastavenie, kde vytvoríš nového admina.

  3. Step 11

    Kým sa neoverí platný kľúč, panel zostane zamknutý a presmeruje ťa na stránku Licencia. Otvor /license, zadaj kľúč a doménu, pre ktorú bol vydaný, a stlač Activate.

    Ak webová stránka nie je dostupná, dosaď tie isté dve hodnoty do /opt/vorqul-panel/vorqul-panel.conf ako license.key a license.domain a reštartuj službu. Server potrebuje odchádzajúce HTTPS, aby sa dostal k licenčnému serveru.

    license.domain musí byť doména, pre ktorú bol kľúč vydaný. Licenčný súbor netreba vytvárať ručne, lebo data/license.json len ukladá do cache podpísanú odpoveď servera.

  4. Step 12

    V Nastaveniach nájdeš záložky Game hosting, Web hosting a Mail. Vypni to, čo tento stroj nerobí. Vypnutý prepínač skryje stránku a jej API potom odpovedá 404.

    Vypnutím časti sa nič neodinštaluje a nezmažú sa žiadne dáta. Služby, Manual setup ukazuje, čo je nainštalované a čo chýba, a pri každej položke je tlačidlo Install.

  5. Step 13

    Najprv nasmeruj A záznam na server, potom pridaj doménu v paneli, stlač Apply na zapísanie vhostu a stlač HTTPS, keď sa DNS začne preklápať sem.

    Certifikáty prichádzajú z acme.sh alebo certbotu a obidva potrebujú fungujúci DNS záznam, než ich vydajú. Ak sa záznam zmenil len nedávno, počkaj na propagáciu a nepokúšaj sa v slučke.

    Ak je certifikát vydaný, ale stránka stále beží na čistom HTTP, zvyčajne ide o prevzatý vhost, ktorému ešte nebolo potvrdené prevzatie.

  6. Step 14

    Každý Apply spustí test konfigurácie webservera s automatickým návratom späť. Spusti ho raz zámerne, aby si videl, ako vyzerá úspešný výsledok.

    Vďaka tomuto návratu späť zlý vhost nezhodí celý server. Panel otestuje novú konfiguráciu pred reloadom a ak test zlyhá, vráti starú.

Príkazy

Všetko, čo píšeš na serveri. Spúšťaj vorqulctl ako root alebo cez sudo.

  1. Step 15

    Panel je služba vorqul-panel a samostatný SFTP démon je vorqul-sftp.

    bash
    sudo systemctl status vorqul-panel
    sudo systemctl restart vorqul-panel
    sudo systemctl stop vorqul-panel
    sudo systemctl enable vorqul-panel
    sudo journalctl -u vorqul-panel -n 100 --no-pager
  2. Step 16

    Krátke príkazy, ktoré použiješ najčastejšie.

    • vorqulctl status ukáže stav služby, port a verziu
    • vorqulctl start, stop a restart ovládajú službu
    • vorqulctl enable a disable určujú, či sa spustí pri štarte systému
    • vorqulctl logs [tail|follow|err|all] číta log panelu, predvolene posledných 100 riadkov
    • vorqulctl info vypíše cesty, porty a dátový adresár
    • vorqulctl version vypíše verziu panelu
  3. Step 17

    Na prvé prihlásenie, stratený admin účet alebo rýchlu kópiu konfigurácie.

    • vorqulctl setup-url znova vypíše odkaz na prvotné nastavenie
    • vorqulctl reset-admin vytvorí nové setup URL pre nový admin účet a znova zapne prihlasovanie heslom
    • vorqulctl config otvorí konfiguračný súbor v editore
    • vorqulctl backup zapíše do /tmp tar.gz s konfiguráciou a dátovým adresárom
  4. Step 18

    Moduly, runtime, knižnice, aktualizácie a odstránenie.

    • vorqulctl modules [games|web|mail on|off] ukáže alebo prepne modul spolu s jeho právami na hostiteľovi
    • vorqulctl deps <runtime> nainštaluje runtime ako node20, java25 alebo steamcmd
    • vorqulctl fix-libs znova stiahne knižnice v lib/
    • vorqulctl fix-priv znova nainštaluje súbor sudoers, root helper a systemd override
    • vorqulctl update <jar> nainštaluje nový JAR so zálohou, atómovou výmenou, reštartom, kontrolou zdravia a automatickým návratom späť
    • vorqulctl uninstall [--purge-data] odstráni panel a dáta ponechá, kým ich nevymažeš cez purge
    bash
    sudo vorqulctl modules mail on
    sudo vorqulctl update /path/to/vorqul-panel.jar
  5. Step 19

    Panel beží ako neprivilegovaný používateľ. Všetko, čo vyžaduje root, ide cez vorqul-helper, ktorý prijíma pevný zoznam akcií a nič iné.

    Helper číta /etc/vorqul-helper.conf, ktorý vlastní root a zapisuje ho inštalátor. Je zúžený na moduly, ktoré si vybral, takže samotné zapnutie modulu v Nastaveniach panelu tieto práva nedá. Panel zobrazí banner s príkazom a týmto príkazom je sudo vorqulctl modules <name> on.

    Nech sú moduly akékoľvek, panel nikdy nezastaví SSH, nftables, ufw, firewalld ani cron, nikdy nevyprázdni firewall ani nezmení jeho predvolenú politiku, len pridáva a odstraňuje vlastné označené pravidlá a sám nikdy nič nezablokuje vo fail2ban.

  6. Step 20

    Keď sa server nespustí a log je prázdny, spusti doktora. S ničím nekomunikuje, nič nemení a každý príkaz herného servera spustí ručne, aby si videl skutočnú chybu.

    /healthz vráti JSON s verziou, uptime, stavom databázy a počtom bežiacich serverov, takže je dobrým cieľom pre tvoj vlastný monitoring.

    bash
    ./scripts/vorqul-doctor.sh /opt/vorqul-panel
    curl -s http://127.0.0.1:8765/healthz

Referencia

Kde čo nájdeš po predvolenej inštalácii.

  1. Step 21

    Všetko, čo panel vlastní, leží pod /opt/vorqul-panel, pokiaľ si nezmenil INSTAL_DIR alebo DATA_DIR.

    • /opt/vorqul-panel obsahuje JAR, lib/ a vorqul-panel.conf
    • /opt/vorqul-panel/data obsahuje databázu, herné servery a zálohy
    • /opt/vorqul-panel/logs obsahuje vorqul-panel.log
    • /etc/systemd/system/vorqul-panel.service a vorqul-sftp.service sú jednotky
    • /usr/local/bin/vorqulctl je nástroj príkazového riadka
    • /usr/local/sbin/vorqul-helper a /etc/vorqul-helper.conf sú root helper a jeho politika
    • /etc/sudoers.d/vorqul-panel je úzky súbor sudoers
  2. Step 22

    Prvé tri patria panelu. Ostatné závisia od toho, ktoré časti používaš.

    • 8765 tcp je webové rozhranie a API
    • 8766 tcp je vstavaný SFTP a 8767 tcp je samostatný SFTP démon
    • 80 a 443 tcp pre weby a certifikáty
    • 25, 587, 465, 143, 993 a 4190 tcp pre poštu
    • 53 tcp a udp pre DNS
    • Každý herný server používa vlastný port

Referencia

Súbor je /opt/vorqul-panel/vorqul-panel.conf a na každom riadku je jedno key = value. Takmer všetko je aj prepínač v Nastaveniach, takže ho len zriedka musíš upravovať ručne. Po zmene reštartuj službu.

  1. Step 23

    Kľúče, ktoré určujú, ako panel počúva a kde drží dáta.

    • server.host a server.port nastavujú adresu a port, na ktorých počúva
    • server.public.url je adresa, ktorú ľudia otvárajú, potrebná na prihlásenie cez Google alebo Discord
    • server.tls.keystore ukazuje na PKCS12 keystore pre priame HTTPS
    • data.dir je dátový adresár
    • db.engine je sqlite, mysql, postgres alebo mssql, s blokom db.<engine>.host, port, database, user a password pre ten, ktorý používaš
    • security.secret podpisuje relácie a generuje ho inštalátor, preto ho nemeň len tak
    • panel.trust.proxies uvádza jediné uzly, ktoré smú nastavovať forwarding hlavičky
    • cloudflare.mode spôsobí, že panel dôveruje CF-Connecting-IP len z rozsahov Cloudflare
  2. Step 24

    feature.games, feature.webhosting a feature.mail sú hlavné prepínače. Každý má podriadené prepínače a podriadený je zapnutý, len kým je zapnutý jeho rodič.

    • Web: feature.domains, ssl, dns, databases, cache, webconfigs, webfiles, subdomains, websftp, webapps, webstats
    • Mail: feature.mail.dkim, antispam, tls, rules, catchall, autoconfig, delivery, webmail, dnsrecipe
    • Nástroje pre weby: webcron, webbackup, webgit, webruntime
    • terminal.enabled zapne terminál v prehliadači, predvolene vypnutý a len pre adminov s 2FA
  3. Step 25

    Ako panel zaobchádza s bežiacimi servermi.

    • servers.keepRunning, servers.nice a servers.oomAdjust ladia, ako servery prežijú a ako sa plánujú
    • limits.cgroups zapne limity cgroup v2, pričom limits.memory.headroomPercent má predvolene 125 a limits.pids.max je predvolene vypnutý
    • limits.servers.maxRunning obmedzuje, koľko serverov beží naraz
    • process.stop.timeout je počet sekúnd, ktoré server dostane na uloženie pri zastavení, predvolene 30 a najviac 150
  4. Step 26

    Plány a uchovávanie pre panel, offsite kópie a zálohy webov.

    • backup.panel.cron a backup.panel.retention plánujú zálohu panelu a určujú, koľko ich ostane
    • backup.offsite.* opisuje, kam sa posielajú šifrované kópie
    • web.backup.keep je počet uchovávaných záloh webov, predvolene 7
    • log.level určuje, koľko toho panel píše do logu

    Keď sa zdá, že sa zmena neprejavila, spusti doktora alebo si prečítaj vorqulctl logs err. Zvyčajne je na vine preklep v súbore.

Funkcie

Stručná mapa rozhrania, aby si vedel, kde hľadať.

  1. Step 27

    Menu je zoskupené podľa toho, čo spravuje. Skupiny Web hosting, Mail a Game hosting sa dajú vypnúť v Nastaveniach.

    • Overview je dashboard so štatistikami systému
    • Web hosting: Websites overview, Domains and sites, DNS zones, Databases, Cache, SSL certificates, Web server configs
    • Mail: Mail a Mail delivery
    • Game hosting: Game overview, Game servers, Scheduler, Backups
    • System, len pre adminov: Services, Nginx, Logs, Cron, Monitoring, Firewall, Security, Fail2ban, Tools, Webhooks, Users, Audit log a Terminal (predvolene vypnutý)
    • Account: Settings a Licence pre adminov
    • Používatelia, ktorí nie sú admini, dostanú aj My websites, ak majú prístup k nejakému webu
  2. Step 28

    Viac ako 240 šablón s inštaláciou na jeden klik, živá konzola, súbory, zálohy, plány a SFTP pre každý server.

    • Minecraft, Hytale, rodina Source, Rust, Valheim, ARK, Palworld, FiveM, Discord boty, hlasové servery a sekcia pre lokálne AI nástroje
    • Analýza pádov pomenuje príčinu a riešenie, napríklad zlú verziu Javy alebo zabitie pre nedostatok pamäte
    • Limity zdrojov pre každý server cez cgroup v2 namiesto nice alebo cpulimit
    • Oprávnenia pre každého používateľa od View až po Custom zoznam, napríklad konzola, ovládanie, súbory a zálohy
    • Inštalácia a aktualizácia na jeden klik, živá konzola so zadávaním príkazov a správca súborov s úpravami, nahrávaním, rozbaľovaním zip a tar a chmod
    • Ručné a plánované zálohy, plánovač reštartov, záloh a príkazov a SFTP účet v chroot pre každý server
  3. Step 29

    Vhosty pre nginx alebo Apache, Let's Encrypt, DNS, databázy a nástroje pre každý web.

    • Domény pre nginx alebo Apache s bezplatným HTTPS cez Let's Encrypt, subdomény so zobrazeným pokrytím certifikátom, režim reverzného proxy a import existujúcich webov
    • Zóny BIND9 overené pred reloadom a synchronizácia s Cloudflare
    • Databázy a používatelia MariaDB s importom, exportom a Adminerom, plus tipy, ako databázu zrýchliť
    • Verzie PHP, pooly a moduly
    • Nástroje pre každý web: nastavenia PHP, ochrana heslom, blokovanie IP, cron, zálohy, git deploy a aplikácie v Node.js alebo Pythone
    • Nastavenia Nginx pre celý server aj pre každý web
    • Súbory, FTP a SFTP účty pre každý web a inštalátory Roundcube a phpMyAdmin na jeden klik
    • Redis, Valkey a memcached z jednej stránky
  4. Step 30

    Postfix a Dovecot s DKIM, kontrola doručiteľnosti, fronta, log doručenia, kontroly blocklistov a Roundcube.

    Pridaj doménu, vygeneruj kľúč DKIM a publikuj DNS záznamy, ktoré panel ukáže. Skontroluj, či PTR záznam tvojej IP sedí s názvom poštového hostiteľa, lebo ten sa nastavuje tam, kde si IP prenajímaš, a žiadny panel ho nezmení.

    • Postfix, Dovecot a Rspamd nainštalované jedným tlačidlom
    • Schránky, aliasy, catch-all, presmerovanie a automatické odpovede pri neprítomnosti
    • DKIM, SPF a DMARC, kontrola doručiteľnosti, poštová fronta, log doručenia a kontrola blocklistov
    • TLS certifikát na jeden klik, export DNS záznamov a publikovanie do Cloudflare
    • Automatická konfigurácia pre Thunderbird, Outlook a zariadenia Apple
  5. Step 31

    Ovládanie služieb, watchery so samoopravou, verejná stavová stránka, upozornenia, firewall, skenovanie malvéru, roly a audit log.

    • Inštalácia, štart, zastavenie a čítanie logov nginx, Apache, MariaDB, PHP-FPM a fail2ban, plus prehliadač logov, čistenie logov a editor cronu
    • Monitory HTTP, TCP, ping, expirácie SSL, disku, pamäte, CPU a služieb so samoopravou, 30 dní histórie a verejnou stavovou stránkou na /status
    • Webhooky, Discord embedy a e-mailové upozornenia pri pádoch, zálohách, nízkom mieste na disku a končiacich certifikátoch
    • Firewall s ufw, firewalld alebo nftables, voliteľný základný firewall s automatickým návratom späť a sprievodca nastavením fail2ban
    • Aktualizácia skutočnej IP pre Cloudflare a terminál v prehliadači len pre adminov s 2FA
    • Tri roly, Admin, Operator a Viewer, s oprávneniami pre každý server View, Control, Manage alebo Custom
    • Dvojfaktorové overenie TOTP, prihlásenie cez Google alebo Discord, zámok prihlásenia, ochrana CSRF, správa aktívnych relácií a audit log s exportom do CSV
    • Skenovanie malvéru cez ClamAV, LMD, rkhunter a chkrootkit a balíky s kvótami pre používateľov

Zálohy

Nastav ich hneď prvý deň. Existujú tri druhy a každý má v rozhraní svoje miesto.

  1. Step 32

    Zálohy panelu, herných serverov a webov sú oddelené.

    Podľa plánu panel tiež rozbalí svoju najnovšiu zálohu a otvorí databázu v nej, čo dokazuje, že archív sa dá obnoviť, nielen to, že existuje.

    • Záloha panelu pokrýva konfiguráciu, databázu a konfigurácie hostiteľa, ktoré spravuje, podľa cron plánu s uchovávaním
    • Zálohy herných serverov sú ručné alebo plánované, po zápise overené, s obnovou z rozhrania a ZIPmi na stiahnutie
    • Zálohy webov sú jeden ZIP so súbormi a voliteľne s databázou a dajú sa nahrať na iný server Vorqul, aby si web presunul
  2. Step 33

    Backups, Offsite targets. Kópie sa pred opustením servera šifrujú pomocou AES-256-GCM.

    Šifrovanú kópiu si prečítaš sám príkazom decrypt-backup z JAR.

    • Priame ciele: SSH, SFTP, FTP a S3
    • Google Drive, OneDrive a Dropbox cez rclone
    bash
    java -jar vorqul-panel.jar decrypt-backup backup.zip.enc backup.zip
  3. Step 34

    Nainštaluj rclone, raz vytvor remote a potom ho použi ako offsite cieľ.

    V rclone config vytvor remote s názvom gdrive typu drive. Na serveri bez prehliadača odpovedz nie na otázku o automatickej konfigurácii, na vlastnom počítači spusti rclone authorize "drive" a vlož token, ktorý vypíše. Riadok lsd by mal ukázať tvoje priečinky na Drive skôr, než na neho nasmeruješ panel.

    bash
    sudo apt install rclone
    rclone config
    rclone lsd gdrive:
  4. Step 35

    Herné servery a weby sa obnovujú z rozhrania. Databáza panelu sa obnovuje ručne so zastaveným panelom.

    Panel vypíše presný príkaz, namiesto toho aby prepísal databázu, ktorú má otvorenú. Obnova konfigurácií hostiteľa funguje po súboroch a ku všetkému, čo nahradí, ponechá kópiu .vorqul-pre-restore.

Údržba

Aktualizácia sa nikdy nedotkne konfigurácie, databázy ani herných serverov.

  1. Step 36

    Bezpečná cesta. Uloží aktuálny JAR a konfiguráciu, atómovo ich vymení, reštartuje, počká na /healthz a vráti späť, ak sa nová verzia nespustí.

    bash
    sudo vorqulctl update /path/to/vorqul-panel.jar
    sudo vorqulctl fix-libs

    fix-libs spusti potom, len ak nová verzia potrebuje nové knižnice.

  2. Step 37

    Keď inštalátor spustíš znova, rozpozná existujúcu inštaláciu, ponechá konfiguráciu a obnoví lib/, jednotky a helper.

    Nahradené súbory sa uložia v dátovom adresári do backups/_install/ a ostane posledných 10 behov.

    Bežiace herné servery dostanú vlastný príkaz na zastavenie a process.stop.timeout sekúnd na uloženie, potom SIGTERM a nakoniec SIGKILL. Po návrate panelu sa spustia znova a plánovaný reštart sa nehlási ako pád.

    bash
    sudo bash scripts/install.sh
  3. Step 38

    Prvý príkaz odstráni služby, helper a pravidlá sudoers a dáta ponechá. Druhý zmaže aj dátový adresár a používateľa vorqul po napísaní DELETE.

    bash
    sudo vorqulctl uninstall
    sudo vorqulctl uninstall --purge-data

    Balíky, ktoré panel nainštaloval, weby pod /var/www, schránky a pravidlá firewallu ostávajú tam, kde sú.

Riešenie problémov

The failures that actually happen, and what causes them.

Otázky k inštalácii

Zhrnutie

Inštalácia VorqulPanel trvá zhruba 15 až 30 minút na čistom Linux serveri. Potrebuje Debian 12, Ubuntu 22.04 alebo novší, alebo AlmaLinux 9, s root prístupom a aspoň 2 GB RAM. Panel sa dodáva ako jeden JAR so scripts/install.sh, ktorý nainštaluje Java 25, ak chýba, vytvorí používateľa služby, zaregistruje systemd unit vorqul-panel a otvorí porty 8765 až 8767. Nie je tu žiadny build krok, žiadny runtime pre kontajnery ani externá databáza. Panel drží svoj stav predvolene v SQLite.

  • Čas: 15 až 30 minút
  • Runtime: Java 25 alebo novšia, nainštaluje sa za teba
  • Distribúcie: Debian 12, Ubuntu 22.04+, AlmaLinux 9
  • Úložisko panela: SQLite, žiadna externá DB
Pojmy na tejto stránke

Panel na správu servera Self-hosted Jednorazová licencia Audit log vorqulctl Root helper Setup URL Databáza panelu Prepínač modulu Prevzatie vhostu Offsite záloha Dvojfaktorové overenie

Súvisiace

Reviewed