Instalacja
Zainstaluj komputer stacjonarny QubKey na macOS, Windows i Linux — wymagany do rozszerzenia i synchronizacji.
QubKey to natywna aplikacja komputerowa, która stanowi rdzeń ekosystemu. Pobierz instalator dla swojego systemu operacyjnego i wykonaj poniższe czynności.
Ekosystem QubKey obejmuje aplikację komputerową (wymaganą — skarbiec, kryptografię, zarządzanie) i rozszerzenie przeglądarki (opcjonalnie — automatyczne uzupełnianie poprzez Native Messaging). Opcjonalna synchronizacja na Twoich własnych urządzeniach może stanowić uzupełnienie modelu lokalnego (folder w chmurze, ręczna kopia pliku .rkvey). Najpierw należy zainstalować aplikację komputerową — od niej zależy rozszerzenie.
Kolejność instalacji
Aplikacja komputerowa QubKey
Aplikacja natywna: zarządzająca skarbcem .rkvey, cała kryptografią (Argon2id, AEAD) i zarządzaniem sekretami. Bez tego rozwiązania nie będzie środka.
Rozszerzenie zabezpieczeń (opcjonalne)
Po zainstalowaniu aplikacji komputerowej i utworzeniu skarbca pobierz Chrome lub Firefox ze strony rozszerzenia oprogramowania (pakiet macOS lub Windows pasujący do oprogramowania komputerowego), skonfiguruj Wiadomości natywne, a następnie podłącz urządzenie.
Opcjonalna synchronizacja (opcjonalna)
Wbudowana synchronizacja wielu urządzeń (chmura QubKey lub serwer własny, wliczony w ustawieniach) lub ręczne kopiowanie/synchronizacja zaszyfrowanego pliku .rkvey (folder w chmurze, dysk USB).
Wymagania systemowe
Operating system
macOS (Apple Silicon) i Windows 10/11 (NSIS/MSI) dostępne do pobrania. Linux w fazie aktywnego rozwoju — zobacz informacje o wydaniu i stronę pobierania.
RAM
minimum 4 GB — zalecane 8 GB. Argon2id zużywa 64 MB na odblokowanie; niewystarczająca ilość pamięci RAM może spowolnić otwieranie skarbca.
Disk space
200 MB na aplikację
WebView
WebView2 (Windows) lub WebKit — w pakiecie dla systemu macOS/Linux za pośrednictwem Tauri
Pobierać
macOS
Apple Silicon (arm64) .dmg — poza sklepem Mac App Store. Sprawdź skrót SHA-256 na stronie pobierania.
Okna
Instalatory NSIS/MSI dla Windows 10/11 (x64 lub x86) — zobacz dedykowaną stronę, aby zapoznać się z dostępnymi pakietami.
Linuksa
W fazie aktywnego rozwoju — nie opublikowano jeszcze żadnego pliku do pobrania dla systemu Linux.
Instalacja platformy
Pobierz Apple Silicon (ramię64) .dmg ze strony macOS
Sprawdź połączenie odcisku palca SHA-256, otwórz .dmg i przeciągnij QubKey do /Applications
Przy pierwszym uruchomieniu: kliknij uruchamiające aplikacje → otwórz, jeśli Gatekeeper wyświetli ostrzeżenie (aplikacja poza Mac App Store)
Dostęp do dysku i folderu dokumentów, jeśli system macOS wyświetla monit
Sprawdź stronę Windows pod okiem instalatorów NSIS/MSI (x64 lub x86)
Kliknij dwukrotnie instalator i uchwyt z kreatora (wybierz folder instalacyjny)
Zaakceptuj instalację WebView2, jeśli zostaniesz o to poproszony (wymagane dla interfejsu Tauri)
Uruchom QubKey z menu Start — zezwól na dostęp do plików, jeśli system Windows wyświetla monit
Linuksa
Wersja Linux jest pierwszym etapem rozwoju. W witrynie nie jest jeszcze dostępny niepożądany pakiet AppImage, .deb ani .rpm — wydanie pobranie, aby uzyskać efekt końcowy.
Weryfikacja integralności
Integralność binarna
Przed instalacją zawsze sprawdzaj podpis lub skrót SHA256 — że plik binarny nie został naruszony pomiędzy Twoją maszyną (łańcuch dostaw).
shasum -a 256 QubKey_2.0.0_aarch64.dmgPorównaj z hashem na stronie pobrania lub w Informacje o wersji (tabela poszczególnych wyników).
Po instalacji
First vault
Utwórz skarbiec .rkvey i ustaw hasło główne
Rozszerzenie przeglądarki
Zainstaluj rozszerzenie do automatycznego uzupełniania
Sync
Eksportuj lub synchronizuj plik .rkvey (opcjonalnie)
Rozwiązywanie problemów
Missing WebView2 (Windows)
Tauri wymaga WebView2 do wyświetlenia interfejsu użytkownika. Pobierz go z microsoft.com/edge/webview2, jeśli instalator tego nie oferował.
Gatekeeper blocks (macOS)
W przypadku kompilacji nienotarialnych: kliknij prawym przyciskiem myszy → Otwórz. Alternatywnie: xattr -cr /Applications/QubKey.app, aby usunąć kwarantannę.
Missing dependencies (Linux)
Tauri wymaga webkit2gtk. Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1