Wybierz sposób instalacji serwera
| Sposób | Najlepszy do | Wymaga |
|---|---|---|
| 1. Gotowy obraz VM | Import, uruchomienie, logowanie — Debian, PostgreSQL i PassZit gotowe | VMware, VirtualBox, Proxmox/KVM lub Hyper-V |
| 2. ISO appliance | Nowa maszyna wirtualna lub serwer fizyczny, bez nadzoru | Dostęp do internetu podczas instalacji |
| 3. Skrypt instalacyjny | Istniejący serwer Debian, Ubuntu, AlmaLinux lub Rocky Linux | Uprawnienia root i dostęp do internetu |
| 4. Pakiety ręcznie | Własny PostgreSQL, zarządzanie konfiguracją | Pakiet deb lub rpm wydania |
Serwer potrzebuje 2 vCPU, 2 GB RAM i dysku 16 GB. Przeglądarki łączą się z nim przez TCP 8443. Dla rozszerzeń przeglądarki potrzebuje nazwy i certyfikatu, któremu ufają przeglądarki — PassZit pobiera go z Let's Encrypt lub używa Twojego (Ustawienia → Certyfikat).
1. Gotowy obraz VM
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.
Proxmox VE i KVM
Utwórz maszynę bez dysku (2 vCPU, 2 GB RAM, sieć VirtIO), zaimportuj dysk i podłącz go jako dysk rozruchowy SCSI.
Hyper-V (generacja 1)
Rozpakuj, utwórz maszynę generacji 1 z 2 GB RAM i wybierz VHDX jako jej dysk.
Na Proxmox VE, po skopiowaniu obrazu na węzeł:
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Uruchom maszynę: na jej ekranie widać adres konsoli i token konfiguracji. Otwórz https://<adres>:8443, raz zaakceptuj certyfikat z podpisem własnym, wpisz token i utwórz pierwszego administratora z logowaniem dwuskładnikowym. Na ekranie maszyny zaloguj się jako pzadmin (pierwsze hasło passzit, zmieniane przy pierwszym logowaniu): menu ustawia sieć, nazwę serwera i strefę czasową, pokazuje token konfiguracji i przywraca kopie zapasowe. Otwarte są tylko porty 22 (SSH) i 8443.
2. ISO appliance
passzit-appliance.iso — uruchom z niego maszynę wirtualną lub serwer. Po 5 sekundach zaczyna się instalacja bez nadzoru: kasuje pierwszy dysk, instaluje z sieci Debiana, PostgreSQL i PassZit, a potem pokazuje adres konsoli i token konfiguracji.
3. Skrypt instalacyjny
Na Debianie 12+, Ubuntu 22.04+, AlmaLinux lub Rocky Linux 9+ (x86-64 lub ARM64), jako root:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Skrypt instaluje PostgreSQL, pobiera najnowsze wydanie, sprawdza jego podpis, tworzy bazę danych z losowym hasłem, uruchamia usługę i wypisuje adres oraz token konfiguracji. Uruchom go ponownie, aby zaktualizować. Opcje (z sh -s -- przy potoku): --version X, --db postgres://…, --no-auto-updates (automatyczne aktualizacje bezpieczeństwa systemu pozostają wyłączone), --source URL. Aby najpierw go przeczytać:
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Pakiety i inne pliki
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Ustaw PASSZIT_DB w /etc/passzit/server.env, a następnie systemctl start passzit-server. Token konfiguracji jest w /var/lib/passzit/setup-token.txt. Te pliki mają wersję w nazwie i są wymienione na stronie wydania:
| Plik | Co to jest |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | Serwer do instalacji ręcznej (x86-64 i ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | Rozszerzenie przeglądarki do instalacji ręcznej (zob. niżej) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | Wiersz poleceń passzit dla Linuksa, Windows i macOS |
passzit-helper-X-linux-amd64, -arm64 | Otwiera połączenia zdalne z rozszerzenia na Linuksie; na Windows robi to MaxZit Launcher (pobierz go ze strony Launcher swojego serwera) |
| SHA256SUMS | Sumy kontrolne programów i pakietów |
| SHA256SUMS-appliance | Sumy kontrolne obrazów VM i ISO |
Rozszerzenie przeglądarki
Rozszerzenie wypełnia i zapisuje dane logowania w Chrome, Edge, Operze, Brave, Vivaldi i Firefox. Zainstaluj je ze sklepu swojej przeglądarki, który dba o aktualizacje:
Chrome Web Store
Chrome, Brave, Opera i Vivaldi.
Firefox Add-ons
Firefox 128 lub nowszy.
Microsoft Edge Add-ons
Microsoft Edge.
Twój serwer PassZit oferuje to samo: Rozszerzenia przeglądarki w menu sejfu webowego prowadzą do sklepu Twojej przeglądarki i oferują pakiety jego własnej wersji do instalacji ręcznej. Potem kliknij ikonę PassZit, wpisz adres serwera i wybierz Połącz z sejfem internetowym — w rozszerzeniu nie wpisuje się żadnego hasła.
Weryfikacja pobranych plików
sha256sum -c SHA256SUMS --ignore-missing # programy i pakiety
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, zip VHDX, ISO
Serwer i skrypt instalacyjny sprawdzają podpisany manifest wydania, zanim cokolwiek zainstalują; zob. Bezpieczeństwo.
Aktualizacje
Ustawienia → Aktualizacje i serwer pokazuje działającą i najnowszą wersję oraz instaluje aktualizacje, opcjonalnie automatycznie o wybranej godzinie. Instalowane są tylko wydania podpisane kluczem wydań PassZit; serwer najpierw tworzy kopię bazy danych i programu i przywraca je, jeśli nowa wersja się nie uruchomi. Kanał Testing oferuje kandydatów do wydania dla serwera testowego. Ustawienia → Kopia konsoli przechowuje szyfrowane codzienne kopie bazy danych, tajnego klucza serwera i certyfikatu do przywrócenia na nowej maszynie.