PassZit

Instalace self-hosted správce hesel pro váš tým

Návod krok za krokem od prázdného virtuálního stroje k týmu, který vyplňuje přihlášení z prohlížeče: instalace PassZit, první správce, pozvání kolegů, připojení rozšíření prohlížeče, převzetí starých hesel a server se zálohami a aktualizacemi.

Co tento návod pokrývá

PassZit je bezplatný open-source správce hesel (AGPLv3), který běží na vašem vlastním serveru. Každý uživatel má trezor šifrovaný end-to-end pro přihlášení, jednorázové kódy, zabezpečené poznámky, karty, klíče SSH a soubory; týmy sdílejí trezory s právy pro každou osobu. Server ukládá jen šifrovaná data. Pokud porovnáváte nástroje, protože jste hledali self-hosted alternativu k Bitwardenu, tento návod ukazuje, jak v praxi vypadá instalace a zavedení PassZit.

Co budete potřebovat

  • Virtuální stroj na VMware, VirtualBoxu, Proxmox VE/KVM nebo Hyper-V, případně fyzický server, se 2 vCPU, 2 GB RAM a diskem 16 GB — nebo existující 64bitový server s Debianem 12+, Ubuntu 22.04+, AlmaLinuxem nebo Rocky Linuxem 9+ (x86-64 nebo ARM64).
  • Prohlížeče se k serveru připojují přes TCP 8443. PostgreSQL nastaví instalační skript i obrazy.
  • Pro rozšíření prohlížeče: DNS jméno serveru a certifikát, kterému prohlížeče důvěřují (viz níže).
  • Volitelně SMTP server, aby PassZit mohl posílat pozvánky a upozornění e-mailem.

Instalace serveru

Existují čtyři způsoby; všechny jsou na stránce ke stažení a každé vydání je podepsané.

ZpůsobNejvhodnější pro
Obraz VM: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V generace 1)Importovat, spustit, přihlásit se — Debian, PostgreSQL a PassZit jsou připravené
ISO applianceNový VM nebo fyzický server; bezobslužná instalace smaže první disk
Instalační skriptExistující server s Debianem, Ubuntu, AlmaLinuxem nebo Rocky Linuxem
Balíčky (deb, rpm; amd64, arm64)Vlastní PostgreSQL a správa konfigurace

Obraz VM nebo ISO: spusťte VM. Na jeho obrazovce je adresa konzole a token nastavení. Na konzoli VM se můžete přihlásit jako pzadmin (první heslo passzit, mění se při prvním přihlášení): nabídka nastaví síť, jméno serveru a časové pásmo, znovu ukáže token a obnoví zálohy. Otevřené jsou jen porty 22 (SSH) a 8443.

Instalační skript: jako root na serveru:

curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh

Skript nainstaluje PostgreSQL, stáhne nejnovější vydání, ověří jeho podpis, vytvoří databázi s náhodným heslem, spustí službu a vypíše adresu a token nastavení. Volby jako --version, --db (existující databáze PostgreSQL) nebo --no-auto-updates se předávají přes sh -s --.

Balíčky: nainstalujte deb nebo rpm, nastavte PASSZIT_DB v /etc/passzit/server.env a spusťte systemctl start passzit-server. Token nastavení je v /var/lib/passzit/setup-token.txt.

První přihlášení a první správce

  1. Otevřete https://<server>:8443. Nový server používá certifikát podepsaný sám sebou; prohlížeč jednou varuje — přijměte jej.
  2. Zadejte Token nastavení, svou e-mailovou adresu a hlavní heslo. Prohlížeč teď vytvoří vaše klíče; trvá to vteřinu. Tento první účet je správce.
  3. Naskenujte QR kód ověřovací aplikací (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). Dvoufázové přihlášení je povinné pro každý účet. Uschovejte deset záložních kódů; každý jednou nahradí aplikaci.
  4. Vytvořte obnovovací klíč (viz níže) a přidejte první přihlášení tlačítkem Nová položka.

Později můžete v Můj účet přidat bezpečnostní klíče (YubiKey a další) nebo passkey svého zařízení jako druhý faktor.

Certifikát, kterému prohlížeče důvěřují

Rozšíření prohlížeče odmítají certifikáty podepsané sebou samými, proto dejte serveru skutečný certifikát dřív, než rozšíření nasadíte. V Nastavení → Certifikát nahrajte certifikát (od firemní CA nebo zakoupený; PEM s mezilehlými certifikáty a soukromým klíčem) nebo zvolte Let's Encrypt. Let’s Encrypt potřebuje veřejné DNS jméno a ověřuje ho přes port 80 serveru nebo přes DNS záznam u Cloudflare — druhá možnost funguje i pro server dostupný jen ve vaší síti. Certifikát platí ihned, bez restartu; DNS vaší sítě musí jméno směrovat na server.

Pozvěte tým

Účty vznikají jen na pozvánku. V Uživatelé → Pozvat uživatele zadejte e-mailovou adresu a roli (Uživatel nebo Správce). PassZit ukáže odkaz pozvánky jen jednou; pošlete ho dané osobě. Odkaz funguje jednou a ve výchozím stavu 7 dní. Pokud jste v Nastavení → E-mail nastavili SMTP server, zaškrtněte Poslat pozvánku také e-mailem a PassZit ji odešle za vás.

Pozvaná osoba si zvolí hlavní heslo a nastaví dvoufázové přihlášení, stejně jako vy. Správci mohou uživatele zakázat, resetovat ztracený druhý faktor a stáhnout otevřené pozvánky. Pro sdílení hesel vytvořte sdílený trezor a dejte do něj přístup osobám nebo skupinám.

Firemní účty se připojují v Nastavení → Firemní přihlášení: jednotné přihlášení přes OpenID Connect nebo SAML 2.0 a Active Directory / LDAP. Hlavní heslo zůstává vždy, protože je klíčem k trezoru.

Hlavní heslo a obnovovací klíč

Hlavní heslo nikdy neopustí prohlížeč uživatele. To je smysl šifrování end-to-end a má to důsledek: nikdo — ani správce, ani MaxZit — neotevře trezor bez hlavního hesla nebo obnovovacího klíče. Správci nemohou hlavní hesla vidět ani resetovat.

  • Fráze ze čtyř až šesti náhodných slov se snadno pamatuje a těžko hádá. Zásady trezoru určují minimální délku (výchozí 12 znaků).
  • V Můj účet tlačítko Vytvořit obnovovací klíč ukáže klíč z 32 písmen a číslic, jen jednou. Vytiskněte ho nebo si ho zapište a uložte offline — ne v trezoru a ne vedle telefonu.
  • S obnovovacím klíčem a kódem z ověřovací aplikace si uživatel, který zapomněl hlavní heslo, nastaví nové na přihlašovací stránce. Bez obnovovacího klíče je trezor ztracen; správce může jen smazat účet a pozvat osobu znovu s prázdným trezorem. Seznam uživatelů ukazuje, kdo si obnovovací klíč vytvořil.

Požádejte všechny, aby si obnovovací klíč vytvořili hned první den.

Instalace rozšíření prohlížeče

Rozšíření vyplňuje přihlášení a jednorázové kódy jen na webu, ke kterému patří, nabízí uložení nových a změněných přihlášení, vyplňuje karty a adresy do platebních a doručovacích formulářů a vytváří hesla. Nainstalujte ho z obchodu svého prohlížeče, který ho udržuje aktuální:

  • Chrome Web Store — Chrome, Brave, Opera a Vivaldi
  • Firefox Add-ons — Firefox 128 nebo novější
  • Microsoft Edge Add-ons — Microsoft Edge

Odkazy jsou na stránce ke stažení. Server PassZit nabízí totéž: Rozšíření prohlížeče v nabídce webového trezoru ukazuje Nainstalovat jedním kliknutím s obchodem prohlížeče, který používáte, a balíčky své verze pro ruční instalaci.

  1. Klikněte na ikonu PassZit, zadejte jen adresu svého serveru (například https://vault.example.com) a klikněte na Připojit přes webový trezor. Povolte prohlížeči, aby PassZit s tímto serverem komunikoval. Port v adrese, například :8443, funguje v každém prohlížeči, i ve Firefoxu.
  2. Otevře se webový trezor; přihlaste se v něm, pokud ještě nejste přihlášeni.
  3. Trezor se zeptá, zda připojit rozšíření v tomto prohlížeči — klikněte na Připojit. Do rozšíření se nezadává žádné heslo ani kód.

Webový trezor a rozšíření sdílejí jedno odemknutí: odemknete jedno a otevře se i druhé, zamknete jedno a zamknou se obě.

Import hesel z jiného programu

Každý uživatel importuje do svého trezoru. Nejprve exportujte data ze starého programu, pak v trezoru zvolte Nástroje → Import a soubor. PassZit rozpozná formát, ukáže, kolik položek a složek našel a kolik jich už v trezoru je, a umožní ponechat složky ze souboru a přeskočit duplicity.

ZExport tam
Chrome, Edge, Brave, Opera, VivaldiPassword manager → Settings → Export passwords (CSV)
Firefoxabout:logins → … → Export passwords (CSV)
SafariFile → Export → Passwords (CSV)
BitwardenTools → Export vault → .json nebo .csv, ne šifrovaná varianta
KeePass 2 / KeePassXCKeePass XML (2.x) / CSV nebo XML
1PasswordFile → Export → CSV
LastPassAdvanced options → Export (CSV)

Soubor se čte v prohlížeči; server dostává položky jen zašifrované. Převezmou se přihlášení, poznámky, weby, vlastní pole, složky, oblíbené a tajemství TOTP (z Bitwardenu i karty, identity a klíče SSH). Přiložené soubory nejsou součástí těchto exportů. Exportní soubor potom smažte — obsahuje hesla nešifrovaně.

Jak funguje šifrování

Prohlížeč odvodí z hlavního hesla hlavní klíč pomocí Argon2id (64 MiB, 3 průchody). Z něj vznikají dva klíče: přihlašovací klíč, který se posílá při přihlášení — server ukládá jen jeho hash argon2id — a obalovací klíč, který odemyká náhodný klíč účtu uživatele. Každá položka, včetně názvu, uživatelského jména, webů a poznámek, je šifrována AES-256-GCM klíčem svého trezoru; sdílené trezory mají vlastní klíč zapečetěný pro klíč X25519 každého člena. Server vidí šifrovaná data, identifikátory, velikosti a časy, nikdy hlavní heslo ani klíč, který by mohl použít. Podrobnosti jsou na stránce o bezpečnosti a v docs/ARCHITECTURE.md v repozitáři.

Zálohy serveru

Nastavení → Záloha konzole každý den (a na požádání tlačítkem Zálohovat nyní) zapíše zálohu do /var/lib/passzit/backups: databázi se všemi trezory, tajný klíč serveru a certifikát konzole — vše, co nový server potřebuje. Záloha je vždy šifrovaná heslovou frází, kterou nastavíte; uložte ji jinde. Každou zálohu lze také kopírovat do složky SFTP na jiném serveru. K obnově slouží nabídka appliance, nebo zastavte službu a spusťte passzit-server -restore, jak popisuje příručka v konzoli.

Aktualizace

Nastavení → Aktualizace a server ukazuje běžící a nejnovější verzi. Instalace znovu ověří podpis, zazálohuje databázi a program, nainstaluje aktualizaci a zkontroluje, že se server vrátil — pokud ne, sama vrátí starou verzi i databázi. Tam se také zapíná automatická instalace ve zvolenou hodinu. Kanál Stabilní dostává vydání; Testing nabízí i kandidáty na vydání, pro testovací server. U instalace skriptem PassZit aktualizuje i opětovné spuštění instalačního skriptu a všechna data zůstanou.

Omezení, která je dobré znát

  • PassZit je v aktivním vývoji: první veřejné vydání bylo 0.9.0 v listopadu 2026 a nové verze vycházejí často.
  • Neexistuje nativní mobilní aplikace. Na telefonu lze webový trezor přidat na plochu a otevírá se ve vlastním okně, ale nic se neukládá pro práci offline — bez serveru uvidíte stránku „offline“.
  • Zapomenuté hlavní heslo bez obnovovacího klíče nikdo neobnoví.
  • Rozšíření prohlížeče potřebují důvěryhodný certifikát a přihlašují se hlavním heslem a kódem z ověřovací aplikace — ne jednotným přihlášením.
  • Jako u každého webového trezoru přichází jeho JavaScript ze serveru, takže zcela kompromitovaný server by mohl poslat změněný kód; rozšíření má vlastní kód.
  • Neexistuje obraz pro Docker; instalujte z obrazu, skriptem nebo z balíčků. Příručka v konzoli je v angličtině a srbštině.

Další kroky

Stáhněte si PassZit, prohlédněte si všechny funkce — sdílené trezory, tajné odkazy, nouzový přístup, vzdálená připojení, příkazový řádek — nebo si přečtěte příručku zabudovanou v konzoli (dokumentace). Jak nastavit sdílené trezory pro tým, popisuje návod Sdílení hesel v týmu. Dotazy jsou vítány v GitHub Discussions. Firmy mohou získat komerční podporu od MaxZit (pouze v angličtině).