Przejdź do treści
VORQUL
Dokumentacja / VorqulPanel / Instalacja i administracja

Zainstaluj VorqulPanel na serwerze Linux

Większość czasu schodzi na czekaniu na instalację pakietów i propagację DNS, a nie na sam panel. Poniższa kolejność pozwala uniknąć zablokowania sobie dostępu.

Instalacja VorqulPanel zajmuje mniej więcej 15 do 30 minut na czystym serwerze Linux. Wymaga Debiana 12, Ubuntu 22.04 lub nowszego albo AlmaLinux 9, z dostępem root i co najmniej 2 GB RAM. Panel jest dostarczany jako pojedynczy JAR ze scripts/install.sh, który instaluje Javę 25, jeśli jej brakuje, tworzy użytkownika usługi, rejestruje unit systemd vorqul-panel i otwiera porty 8765 do 8767. Nie ma kroku budowania, środowiska kontenerów ani zewnętrznej bazy danych. Panel domyślnie trzyma własny stan w SQLite.

Czas
15 do 30 minut
Środowisko
Java 25 lub nowsza, instalowana za ciebie
Dystrybucje
Debian 12, Ubuntu 22.04+, AlmaLinux 9
Dane panelu
SQLite, bez zewnętrznej bazy

Wymagania

Minimalne wymagania przed instalacją
RAM Minimum 2 GB
Dostęp Root na czystym serwerze
Java 25 lub nowsza, instalator ją doda
Porty SSH, 8765 do 8767, 80 i 443
DNS Rekord A wskazujący na serwer, dla certyfikatów
Środowisko kontenerów Niewymagane
Requirements for Instalacja VorqulPanel: RAM Minimum 2 GB, Dostęp Root na czystym serwerze, Java 25 lub nowsza, instalator ją doda, Porty SSH, 8765 do 8767, 80 i 443, DNS Rekord A wskazujący na serwer, dla certyfikatów, Środowisko kontenerów Niewymagane.

Instalacja

Czysty serwer to prawdziwy wymóg, a nie tylko zalecenie. Panel zarządza nginx, Apache, BIND9, Postfix, Dovecot, MariaDB i nftables, a dużo łatwiej mu na maszynie, na której sam je zainstalował.

  1. Step 01

    Debian 12, Ubuntu 22.04 lub nowszy albo AlmaLinux 9, świeżo postawiony, z dostępem root przez SSH.

    Instalacja na serwerze, na którym już działa czyjś stos webowy, jest możliwa. Instalator nie proponuje ponownej instalacji serwera WWW, PHP-FPM, MariaDB, certbota, BIND, Postfix ani fail2ban, które już tam są, a panel czyta istniejące vhosty bez ich przepisywania, dopóki nie potwierdzisz przejęcia. To nadal nie jest instalacja, od której warto zaczynać.

  2. Step 02

    Panel to pojedynczy JAR i wymaga Javy 25 lub nowszej. Instalator instaluje ją, gdy jej brakuje, więc nic tu nie musisz robić, chyba że chcesz najpierw sprawdzić.

    bash
    java -version
  3. Step 03

    Wiedz, na którym porcie nasłuchuje twój demon SSH, i upewnij się, że możesz wrócić na serwer. Zapora pojawi się później i będzie potrzebować osobnej reguły dla tego portu.

    Niestandardowy port SSH plus domyślny zestaw reguł zapory to klasyczny sposób, żeby zablokować sobie dostęp do świeżo zainstalowanego panelu.

Instalacja

Jeden skrypt robi całą instalację. Nie ma niczego do kompilowania.

  1. Step 04

    Wydanie to jeden folder z JAR-em, katalogiem scripts i szablonami unitów systemd. Umieść go w stałym miejscu, np. /root/vorqul-panel.

    Zachowaj folder po instalacji. Używają go vorqulctl fix-libs i późniejsze aktualizacje. Biblioteki w lib/ instalator pobiera z Maven Central z weryfikacją sum kontrolnych, więc nie trzeba ich kopiować.

    VorqulPanel jest w alfie i nie jest jeszcze udostępniany do testów mailowo. Gdy build zostanie ci udostępniony, archiwum zawiera dokładne komendy dla tej wersji. Kroki tutaj opisują, co te komendy robią.

    • vorqul-panel.jar to sam panel
    • scripts/install.sh to instalator i jest wymagany
    • scripts/vorqul-helper to pomocnik roota do portów zapory, limitów zasobów i usług
    • scripts/vorqulctl to narzędzie wiersza poleceń
    • scripts/vorqul-doctor.sh to opcjonalny skrypt diagnostyczny
    • systemd/ zawiera szablony usług, opcjonalne, bo instalator ma własną kopię
  2. Step 05

    Pyta, które części chcesz, instaluje to, czego brakuje, tworzy użytkownika usługi i wypisuje jednorazowy adres konfiguracji.

    • Pyta, które moduły włączyć: hosting gier, hosting WWW, poczta
    • Pyta, które pakiety zainstalować: nginx lub Apache, PHP-FPM, MariaDB, certbot, BIND, Postfix z Dovecot, Rspamd, narzędzia do gier, fail2ban
    • Instaluje Javę, jeśli jej brakuje, i tworzy użytkownika systemowego vorqul
    • Kopiuje JAR do /opt/vorqul-panel, zapisuje konfigurację z losowym sekretem i ustawia usługi systemd
    • Otwiera porty w ufw lub firewalld i wypisuje adres konfiguracji
    bash
    sudo bash scripts/install.sh

    Instalator szuka JAR-a w target/, obok katalogu głównego repozytorium albo obok skryptu, więc uruchom go z rozpakowanego folderu.

  3. Step 06

    Każde pytanie ma zmienną środowiskową. Z YES=1 o nic nie pyta i używa zmiennych albo wartości domyślnych.

    • INSTAL_DIR (domyślnie /opt/vorqul-panel), DATA_DIR i LOG_DIR ustawiają, gdzie leżą JAR, dane i logi
    • SYSTEM_USER (domyślnie vorqul) to użytkownik, jako który działa panel
    • PORT, SFTP_PORT i SFTP_DAEMON_PORT mają domyślnie 8765, 8766 i 8767
    • MOD_GAMES, MOD_WEB i MOD_MAIL mają domyślnie 1 i przełączają trzy części panelu
    • WEB_SERVER to nginx, apache lub none i dotyczy tylko MOD_WEB=1
    • INSTALL_PHP, INSTALL_MARIADB, INSTALL_CERTBOT, INSTALL_BIND, INSTALL_MAIL, INSTALL_RSPAMD, INSTALL_FAIL2BAN i INSTALL_GAMETOOLS wybierają pakiety
    • DB_ENGINE to domyślnie sqlite, z opcjami mysql, postgres i mssql oraz DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS dla połączenia
    • WEB_ADMIN=1 instaluje pomocnika roota i wąski plik sudoers, USE_EXISTING=0 pozwala instalatorowi ruszać oprogramowanie, które już jest zainstalowane
    bash
    sudo YES=1 MOD_MAIL=0 WEB_SERVER=nginx INSTALL_PHP=1 INSTALL_MARIADB=1 INSTALL_CERTBOT=1 bash scripts/install.sh

    Obsługa SQL Server jest w becie. SQLite, MySQL, MariaDB i PostgreSQL sprawdzono na prawdziwych serwerach. Późniejsza zmiana db.engine nie przenosi żadnych danych.

  4. Step 07

    Panel działa jako utwardzona usługa systemd o nazwie vorqul-panel. Sprawdź, czy wystartowała, a jeśli nie, przeczytaj journal.

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

    Jeśli instalacje pakietów zawodzą podczas konfiguracji, zwykłą przyczyną jest RestrictSUIDSGID=yes w unicie, które psuje skrypty po instalacji.

  5. Step 08

    Instalator otwiera 8765, 8766 i 8767 w ufw lub firewalld. Przy czystym nftables najpierw pyta i wstawia jedną regułę, która nie przetrwa restartu.

    Przy czystym nftables dodaj też tcp dport { 8765, 8766, 8767 } accept do /etc/nftables.conf. Za reverse proxy tylko 80 i 443 muszą być publiczne, a 8765 powinien zostać zamknięty dla internetu.

    • Panel 8765, wbudowany SFTP 8766, demon SFTP 8767, wszystkie tcp
    • Strony WWW 80 i 443, poczta 25, 587, 465, 143, 993 i 4190, DNS 53 na tcp i udp
    • Każdy serwer gier otwiera własny port przy tworzeniu, a Hytale używa UDP 5520

Instalacja

Od tego momentu wszystko dzieje się w przeglądarce.

  1. Step 09

    Wejdź na http://your-server:8765/. Dopóki nie ma admina, otworzy się formularz konfiguracji. Pełny link dostaniesz od instalatora albo z polecenia poniżej.

    bash
    sudo vorqulctl setup-url

    Konto admina może założyć każdy, kto pierwszy trafi na port. To okno zamyka się godzinę po starcie panelu, a potem potrzebny jest link konfiguracyjny.

  2. Step 10

    Załóż pierwsze konto od razu, a potem włącz uwierzytelnianie dwuskładnikowe w Settings, Account. Dla adminów możesz je uczynić obowiązkowym.

    Jeśli kiedyś stracisz konto admina, uruchom sudo vorqulctl reset-admin, a potem sudo vorqulctl start. Wypisze nowy link konfiguracyjny, w którym założysz nowego admina.

  3. Step 11

    Dopóki nie zostanie zweryfikowany poprawny klucz, panel pozostaje zablokowany i przekierowuje na stronę License. Otwórz /license, wpisz klucz oraz domenę, dla której został wydany, i kliknij Activate.

    Jeśli strona nie jest dostępna, wpisz te same dwie wartości do /opt/vorqul-panel/vorqul-panel.conf jako license.key i license.domain, a potem zrestartuj usługę. Serwer potrzebuje wychodzącego HTTPS, żeby połączyć się z serwerem licencji.

    license.domain musi być domeną, dla której wydano klucz. Nie tworzysz ręcznie żadnego pliku licencji, bo data/license.json tylko zapamiętuje podpisaną odpowiedź serwera.

  4. Step 12

    W Settings są zakładki Game hosting, Web hosting i Mail. Wyłącz to, czego ta maszyna nie robi. Wyłączony przełącznik ukrywa stronę, a jej API odpowiada wtedy 404.

    Wyłączenie części niczego nie odinstalowuje i nie usuwa żadnych danych. Services, Manual setup pokazuje, co jest zainstalowane, a czego brakuje, z przyciskiem Install przy każdej pozycji.

  5. Step 13

    Najpierw skieruj rekord A na serwer, potem dodaj domenę w panelu, kliknij Apply, żeby zapisać vhost, i kliknij HTTPS, gdy DNS już wskazuje na ten serwer.

    Certyfikaty pochodzą z acme.sh lub certbota. Oba potrzebują działającego rekordu DNS, zanim je wystawią. Jeśli rekord dopiero zmieniłeś, poczekaj na propagację zamiast próbować w pętli.

    Jeśli certyfikat został wystawiony, a strona nadal działa po zwykłym HTTP, zwykle chodzi o przejęty vhost, którego przejęcie nie zostało jeszcze potwierdzone.

  6. Step 14

    Każdy Apply uruchamia test konfiguracji serwera WWW z automatycznym wycofaniem zmian. Uruchom go raz celowo, żeby zobaczyć, jak wygląda pozytywny wynik.

    Dzięki temu wycofaniu zły vhost nie wyłączy całego serwera. Panel testuje nową konfigurację przed przeładowaniem i przywraca starą, jeśli test się nie powiedzie.

Polecenia

Wszystko, co wpisujesz na serwerze. Uruchamiaj vorqulctl jako root albo przez sudo.

  1. Step 15

    Panel to usługa vorqul-panel, a samodzielny demon SFTP to 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ótkie polecenia, których użyjesz najczęściej.

    • vorqulctl status pokazuje stan usługi, port i wersję
    • vorqulctl start, stop i restart sterują usługą
    • vorqulctl enable i disable decydują, czy usługa startuje razem z systemem
    • vorqulctl logs [tail|follow|err|all] czyta log panelu, domyślnie ostatnie 100 linii
    • vorqulctl info wypisuje ścieżki, porty i katalog danych
    • vorqulctl version wypisuje wersję panelu
  3. Step 17

    Na pierwsze logowanie, utratę konta admina albo szybką kopię konfiguracji.

    • vorqulctl setup-url ponownie wypisuje link do pierwszej konfiguracji
    • vorqulctl reset-admin tworzy nowy adres konfiguracji dla świeżego konta admina i ponownie włącza logowanie hasłem
    • vorqulctl config otwiera plik konfiguracyjny w edytorze
    • vorqulctl backup zapisuje do /tmp archiwum tar.gz z konfiguracją i katalogiem danych
  4. Step 18

    Moduły, środowiska uruchomieniowe, biblioteki, aktualizacje i usuwanie.

    • vorqulctl modules [games|web|mail on|off] pokazuje lub przełącza moduł razem z jego uprawnieniami na hoście
    • vorqulctl deps <runtime> instaluje środowiska takie jak node20, java25 czy steamcmd
    • vorqulctl fix-libs pobiera ponownie biblioteki z lib/
    • vorqulctl fix-priv instaluje ponownie plik sudoers, pomocnika roota i nadpisanie systemd
    • vorqulctl update <jar> instaluje nowy JAR z kopią zapasową, atomową podmianą, restartem, kontrolą stanu i automatycznym wycofaniem
    • vorqulctl uninstall [--purge-data] usuwa panel i zostawia dane, chyba że użyjesz purge
    bash
    sudo vorqulctl modules mail on
    sudo vorqulctl update /path/to/vorqul-panel.jar
  5. Step 19

    Panel działa jako nieuprzywilejowany użytkownik. Wszystko, co wymaga roota, przechodzi przez vorqul-helper, który przyjmuje stałą listę akcji i nic więcej.

    Pomocnik czyta /etc/vorqul-helper.conf, plik należący do roota i zapisywany przez instalator. Jest przycięty do wybranych przez ciebie modułów, więc samo włączenie modułu w Settings nie daje panelowi tych uprawnień. Panel pokazuje baner z poleceniem, a tym poleceniem jest sudo vorqulctl modules <name> on.

    Niezależnie od modułów panel nigdy nie zatrzymuje SSH, nftables, ufw, firewalld ani crona, nigdy nie czyści zapory ani nie zmienia jej domyślnej polityki, tylko dodaje i usuwa własne oznaczone reguły i nigdy sam niczego nie banuje w fail2ban.

  6. Step 20

    Gdy serwer nie chce wystartować, a log jest pusty, uruchom doctora. Z niczym się nie łączy, niczego nie zmienia i ręcznie uruchamia polecenie każdego serwera gier, żebyś zobaczył prawdziwy błąd.

    /healthz zwraca JSON z wersją, czasem działania, stanem bazy danych i liczbą uruchomionych serwerów, więc dobrze nadaje się jako cel dla własnego monitoringu.

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

Dokumentacja

Gdzie co leży po domyślnej instalacji.

  1. Step 21

    Wszystko, co należy do panelu, jest w /opt/vorqul-panel, chyba że zmienisz INSTAL_DIR lub DATA_DIR.

    • /opt/vorqul-panel zawiera JAR, lib/ i vorqul-panel.conf
    • /opt/vorqul-panel/data zawiera bazę danych, serwery gier i kopie zapasowe
    • /opt/vorqul-panel/logs zawiera vorqul-panel.log
    • /etc/systemd/system/vorqul-panel.service i vorqul-sftp.service to jednostki usług
    • /usr/local/bin/vorqulctl to narzędzie wiersza poleceń
    • /usr/local/sbin/vorqul-helper i /etc/vorqul-helper.conf to pomocnik roota i jego polityka
    • /etc/sudoers.d/vorqul-panel to wąski plik sudoers
  2. Step 22

    Pierwsze trzy należą do panelu. Pozostałe zależą od tego, których części używasz.

    • 8765 tcp to interfejs webowy i API
    • 8766 tcp to wbudowany SFTP, a 8767 tcp to samodzielny demon SFTP
    • 80 i 443 tcp dla stron i certyfikatów
    • 25, 587, 465, 143, 993 i 4190 tcp dla poczty
    • 53 tcp i udp dla DNS
    • Każdy serwer gier używa własnego portu

Dokumentacja

Plik to /opt/vorqul-panel/vorqul-panel.conf z jedną parą key = value w linii. Prawie wszystko jest też przełącznikiem w Settings, więc rzadko trzeba go edytować ręcznie. Po zmianie zrestartuj usługę.

  1. Step 23

    Klucze, które decydują, jak panel nasłuchuje i gdzie trzyma dane.

    • server.host i server.port ustawiają adres i port nasłuchu
    • server.public.url to adres, który ludzie otwierają, potrzebny do logowania przez Google lub Discord
    • server.tls.keystore wskazuje magazyn kluczy PKCS12 dla bezpośredniego HTTPS
    • data.dir to katalog danych
    • db.engine to sqlite, mysql, postgres lub mssql, z blokiem db.<engine>.host, port, database, user i password dla używanego silnika
    • security.secret podpisuje sesje i jest generowany przez instalator, więc nie zmieniaj go bez potrzeby
    • panel.trust.proxies wymienia jedyne hosty, którym wolno ustawiać nagłówki przekazywania
    • cloudflare.mode sprawia, że panel ufa CF-Connecting-IP tylko z zakresów Cloudflare
  2. Step 24

    feature.games, feature.webhosting i feature.mail to główne przełączniki. Każdy ma przełączniki podrzędne, które działają tylko wtedy, gdy włączony jest ich rodzic.

    • 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
    • Narzędzia stron: webcron, webbackup, webgit, webruntime
    • terminal.enabled włącza terminal w przeglądarce, domyślnie wyłączony i tylko dla adminów z 2FA
  3. Step 25

    Jak panel traktuje uruchomione serwery.

    • servers.keepRunning, servers.nice i servers.oomAdjust dostrajają to, jak serwery przetrwają i jak są szeregowane
    • limits.cgroups włącza limity cgroup v2, przy czym limits.memory.headroomPercent domyślnie wynosi 125, a limits.pids.max jest domyślnie wyłączone
    • limits.servers.maxRunning ogranicza, ile serwerów może działać jednocześnie
    • process.stop.timeout to liczba sekund, które serwer dostaje na zapis przy zatrzymaniu, domyślnie 30 i najwyżej 150
  4. Step 26

    Harmonogramy i retencja dla panelu, kopii zewnętrznych i kopii stron.

    • backup.panel.cron i backup.panel.retention planują kopię panelu i określają, ile ich zachować
    • backup.offsite.* opisuje, dokąd wysyłane są zaszyfrowane kopie
    • web.backup.keep to liczba przechowywanych kopii stron, domyślnie 7
    • log.level ustawia, ile panel zapisuje do swojego logu

    Gdy zmiana nie wydaje się działać, uruchom doctora albo przeczytaj vorqulctl logs err. Zwykle winna jest literówka w pliku.

Funkcje

Krótka mapa interfejsu, żebyś wiedział, gdzie szukać.

  1. Step 27

    Menu jest pogrupowane według tego, czym zarządza. Grupy Web hosting, Mail i Game hosting można wyłączyć w Settings.

    • Overview to pulpit ze statystykami systemu
    • Web hosting: Websites overview, Domains and sites, DNS zones, Databases, Cache, SSL certificates, Web server configs
    • Mail: Mail i Mail delivery
    • Game hosting: Game overview, Game servers, Scheduler, Backups
    • System, tylko dla adminów: Services, Nginx, Logs, Cron, Monitoring, Firewall, Security, Fail2ban, Tools, Webhooks, Users, Audit log i Terminal (domyślnie wyłączony)
    • Account: Settings oraz Licence dla adminów
    • Użytkownicy niebędący adminami dostają też My websites, jeśli mają dostęp do jakiejkolwiek strony
  2. Step 28

    Ponad 240 szablonów z instalacją jednym kliknięciem, konsola na żywo, pliki, kopie zapasowe, harmonogramy i SFTP dla każdego serwera.

    • Minecraft, Hytale, rodzina Source, Rust, Valheim, ARK, Palworld, FiveM, boty Discorda, serwery głosowe i sekcja lokalnych narzędzi AI
    • Analiza awarii wskazuje przyczynę i poprawkę, na przykład zła wersja Javy albo zabicie procesu z powodu braku pamięci
    • Limity zasobów dla każdego serwera przez cgroup v2 zamiast nice czy cpulimit
    • Uprawnienia dla każdego użytkownika od View po listę Custom, na przykład konsola, zasilanie, pliki i kopie zapasowe
    • Instalacja i aktualizacja jednym kliknięciem, konsola na żywo z wpisywaniem poleceń oraz menedżer plików z edycją, wgrywaniem, rozpakowywaniem zip i tar oraz chmod
    • Ręczne i planowane kopie zapasowe, harmonogram restartów, kopii i poleceń oraz konto SFTP w chroocie dla każdego serwera
  3. Step 29

    Vhosty nginx lub Apache, Let's Encrypt, DNS, bazy danych i narzędzia dla każdej strony.

    • Domeny dla nginx lub Apache z darmowym HTTPS od Let's Encrypt, subdomeny z widocznym pokryciem certyfikatem, tryb reverse proxy i import istniejących stron
    • Strefy BIND9 sprawdzane przed przeładowaniem i synchronizacja z Cloudflare
    • Bazy danych i użytkownicy MariaDB z importem, eksportem i Adminerem oraz wskazówki, jak przyspieszyć bazę
    • Wersje PHP, pule i moduły
    • Narzędzia dla każdej strony: ustawienia PHP, ochrona hasłem, blokada IP, cron, kopie zapasowe, wdrażanie z gita oraz aplikacje Node.js lub Python
    • Ustawienia Nginx dla całego serwera i dla każdej strony
    • Pliki, konta FTP i SFTP dla każdej strony oraz instalatory Roundcube i phpMyAdmin jednym kliknięciem
    • Redis, Valkey i memcached z jednej strony
  4. Step 30

    Postfix i Dovecot z DKIM, narzędziem do sprawdzania dostarczalności, kolejką, logiem dostarczania, sprawdzaniem list blokad i Roundcube.

    Dodaj domenę, wygeneruj klucz DKIM i opublikuj rekordy DNS, które pokazuje panel. Sprawdź, czy rekord PTR twojego IP zgadza się z nazwą hosta poczty, bo ustawia się go tam, gdzie wynajmujesz IP, i żaden panel tego nie zmieni.

    • Postfix, Dovecot i Rspamd instalowane jednym przyciskiem
    • Skrzynki, aliasy, catch-all, przekierowania i autoodpowiedzi o nieobecności
    • DKIM, SPF i DMARC, narzędzie do sprawdzania dostarczalności, kolejka poczty, log dostarczania i sprawdzanie list blokad
    • Certyfikat TLS jednym kliknięciem, eksport rekordów DNS i publikowanie w Cloudflare
    • Automatyczna konfiguracja dla Thunderbirda, Outlooka i urządzeń Apple
  5. Step 31

    Sterowanie usługami, watchery z samonaprawianiem, publiczna strona statusu, alerty, zapora, skanowanie złośliwego oprogramowania, role i log audytu.

    • Instalowanie, uruchamianie, zatrzymywanie i czytanie logów nginx, Apache, MariaDB, PHP-FPM i fail2ban, a do tego przeglądarka logów, czyszczenie logów i edytor crona
    • Monitory HTTP, TCP, ping, wygasania SSL, dysku, pamięci, CPU i usług z samonaprawianiem, 30 dni historii i publiczna strona statusu pod /status
    • Webhooki, embedy Discorda i alerty e-mail przy awariach, kopiach zapasowych, małej ilości miejsca na dysku i wygasających certyfikatach
    • Zapora z ufw, firewalld lub nftables, opcjonalna zapora bazowa z automatycznym wycofaniem oraz kreator konfiguracji fail2ban
    • Aktualizacja prawdziwego IP z Cloudflare oraz terminal w przeglądarce tylko dla adminów z 2FA
    • Trzy role, Admin, Operator i Viewer, z uprawnieniami dla każdego serwera: View, Control, Manage lub Custom
    • Dwuskładnikowe TOTP, logowanie przez Google lub Discord, blokada logowania, ochrona CSRF, zarządzanie aktywnymi sesjami i log audytu z eksportem do CSV
    • Skanowanie złośliwego oprogramowania przez ClamAV, LMD, rkhunter i chkrootkit oraz pakiety z limitami dla użytkowników

Kopie zapasowe

Skonfiguruj to pierwszego dnia. Istnieją trzy rodzaje, a każdy ma swoje miejsce w interfejsie.

  1. Step 32

    Kopie panelu, kopie serwerów gier i kopie stron są osobne.

    Według harmonogramu panel rozpakowuje też własną najnowszą kopię i otwiera zawartą w niej bazę. To dowodzi, że archiwum da się przywrócić, a nie tylko że istnieje.

    • Kopia panelu obejmuje konfigurację, bazę danych i konfiguracje hosta, którymi panel zarządza, według harmonogramu cron z retencją
    • Kopie serwerów gier są ręczne lub planowane, sprawdzane po zapisie, z przywracaniem z poziomu UI i plikami ZIP do pobrania
    • Kopie stron to jeden ZIP z plikami i opcjonalnie bazą danych, który można wysłać na inny serwer Vorqul, żeby przenieść stronę
  2. Step 33

    Backups, Offsite targets. Kopie są szyfrowane AES-256-GCM, zanim opuszczą serwer.

    Żeby samemu odczytać zaszyfrowaną kopię, użyj polecenia decrypt-backup z pliku JAR.

    • Cele bezpośrednie: SSH, SFTP, FTP i S3
    • Google Drive, OneDrive i Dropbox przez rclone
    bash
    java -jar vorqul-panel.jar decrypt-backup backup.zip.enc backup.zip
  3. Step 34

    Zainstaluj rclone, raz utwórz remote, a potem użyj tego remote'a jako celu zewnętrznego.

    W rclone config utwórz remote o nazwie gdrive typu drive. Na serwerze bez przeglądarki odpowiedz nie na pytanie o automatyczną konfigurację i uruchom rclone authorize "drive" na własnym komputerze, a potem wklej token, który wypisze. Linia lsd powinna pokazać twoje foldery Drive, zanim wskażesz go w panelu.

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

    Serwery gier i strony przywracasz z interfejsu. Bazę danych panelu przywracasz ręcznie, przy zatrzymanym panelu.

    Panel wypisuje dokładne polecenie zamiast podmieniać bazę, którą ma otwartą. Przywracanie konfiguracji hosta działa dla pojedynczych plików i zostawia kopię .vorqul-pre-restore wszystkiego, co zastępuje.

Utrzymanie

Aktualizacja nigdy nie dotyka konfiguracji, bazy danych ani serwerów gier.

  1. Step 36

    Bezpieczna droga. Zapisuje obecny JAR i konfigurację, podmienia atomowo, restartuje, czeka na /healthz i wycofuje zmiany, jeśli nowa wersja nie wstanie.

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

    Uruchom fix-libs potem tylko wtedy, gdy nowa wersja potrzebuje nowych bibliotek.

  2. Step 37

    Ponowne uruchomienie instalatora rozpoznaje istniejącą instalację, zachowuje konfigurację i odświeża lib/, jednostki usług i pomocnika.

    Zastąpione pliki są zapisywane w katalogu danych w backups/_install/, a ostatnie 10 uruchomień jest zachowywane.

    Działające serwery gier dostają własne polecenie zatrzymania i process.stop.timeout sekund na zapis, potem SIGTERM i na końcu SIGKILL. Startują ponownie, gdy panel wraca, a planowany restart nie jest zgłaszany jako awaria.

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

    Pierwsze polecenie usuwa usługi, pomocnika i reguły sudoers, a dane zostawia. Drugie usuwa też katalog danych i użytkownika vorqul po wpisaniu DELETE.

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

    Pakiety zainstalowane przez panel, strony w /var/www, skrzynki pocztowe i reguły zapory zostają tam, gdzie są.

Rozwiązywanie problemów

The failures that actually happen, and what causes them.

Pytania o instalację

Podsumowanie

Instalacja VorqulPanel zajmuje mniej więcej 15 do 30 minut na czystym serwerze Linux. Wymaga Debiana 12, Ubuntu 22.04 lub nowszego albo AlmaLinux 9, z dostępem root i co najmniej 2 GB RAM. Panel jest dostarczany jako pojedynczy JAR ze scripts/install.sh, który instaluje Javę 25, jeśli jej brakuje, tworzy użytkownika usługi, rejestruje unit systemd vorqul-panel i otwiera porty 8765 do 8767. Nie ma kroku budowania, środowiska kontenerów ani zewnętrznej bazy danych. Panel domyślnie trzyma własny stan w SQLite.

  • Czas: 15 do 30 minut
  • Środowisko: Java 25 lub nowsza, instalowana za ciebie
  • Dystrybucje: Debian 12, Ubuntu 22.04+, AlmaLinux 9
  • Dane panelu: SQLite, bez zewnętrznej bazy
Pojęcia na tej stronie

Panel do zarządzania serwerem Hostowane samodzielnie Licencja jednorazowa Log audytu vorqulctl Pomocnik roota Adres konfiguracji Baza danych panelu Przełącznik modułu Przejęcie vhosta Kopia zewnętrzna Uwierzytelnianie dwuskładnikowe

Powiązane

Reviewed