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
- Instalace serveru
- První přihlášení a první správce
- Certifikát, kterému prohlížeče důvěřují
- Pozvěte tým
- Hlavní heslo a obnovovací klíč
- Instalace rozšíření prohlížeče
- Import hesel z jiného programu
- Jak funguje šifrování
- Zálohy serveru
- Aktualizace
- Omezení, která je dobré znát
- Další kroky
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ůsob | Nejvhodně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 appliance | Nový VM nebo fyzický server; bezobslužná instalace smaže první disk |
| Instalační skript | Existují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
- Otevřete
https://<server>:8443. Nový server používá certifikát podepsaný sám sebou; prohlížeč jednou varuje — přijměte jej. - 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.
- 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.
- 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.
- 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. - Otevře se webový trezor; přihlaste se v něm, pokud ještě nejste přihlášeni.
- 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.
| Z | Export tam |
|---|---|
| Chrome, Edge, Brave, Opera, Vivaldi | Password manager → Settings → Export passwords (CSV) |
| Firefox | about:logins → … → Export passwords (CSV) |
| Safari | File → Export → Passwords (CSV) |
| Bitwarden | Tools → Export vault → .json nebo .csv, ne šifrovaná varianta |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV nebo XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced 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ě).