Table of Contents

Vaultwarden - průvodce pro začátečníky

Vaultwarden je odlehčený self-hosted správce hesel kompatibilní se všemi klienty Bitwarden – rozšířeními prohlížečů, mobilními i desktopovými aplikacemi. Server je plně nakonfigurovaný s Vaultwarden, reverzní proxy Nginx a SSL. Stačí otevřít webový trezor, vytvořit účet a začít ukládat hesla.


Krok 1 – Ověřte, že Vaultwarden funguje

IP adresa a heslo root vašeho serveru jsou uvedeny na stránce Server Details v klientském panelu. Otevřete prohlížeč a přejděte na:

https://your.server.ip

Pokud se načte přihlašovací stránka, Vaultwarden funguje správně.

Poznámka: Server ve výchozím stavu používá certifikát SSL podepsaný sebou samým. Prohlížeč zobrazí bezpečnostní varování – klikněte na „Advanced“ a pokračujte. Certifikát Let’s Encrypt můžete nainstalovat později (krok 4).

Pokud jste server umístili za router VyOS v privátní síti, buď nastavte přesměrování portů (80 a 443), nebo se připojte přes VPN a k Vaultwarden přistupujte přes privátní IP serveru.


Krok 2 – Vytvoření účtu

Na přihlašovací stránce klikněte na Create account. Zadejte e-mailovou adresu, jméno a zvolte hlavní heslo.

Důležité: Hlavní heslo šifruje všechna vaše data. Vaultwarden ho nikdy neukládá – pokud ho ztratíte, data nelze obnovit. Zvolte silné heslo, které si zapamatujete.

Po registraci se přihlaste e-mailem a hlavním heslem. Toto je váš osobní trezor, kde můžete ukládat hesla, poznámky, karty a identity.


Krok 3 – Připojení klientů Bitwarden

Vaultwarden je kompatibilní se všemi oficiálními klienty Bitwarden:

Před přihlášením nasměrujte klienta na svůj server:

  1. Na přihlašovací obrazovce klikněte na výběr regionu (nebo ikonu ozubeného kola) a zvolte Self-hosted
  2. Zadejte URL serveru: https://your.server.ip
  3. Uložte a přihlaste se e-mailem a hlavním heslem

Po připojení se všechna hesla automaticky synchronizují napříč zařízeními.


Krok 4 – Nastavení domény a SSL (doporučeno)

Pro nejlepší práci s klienty Bitwarden nastavte doménu s řádným certifikátem SSL:

1. Vytvořte DNS A záznam směřující vaši doménu na IP serveru (např. vault.yourdomain.com → your.server.ip).

2. Připojte se k serveru přes SSH a spusťte:

ssh root@your.server.ip
/opt/setup/get-ssl.sh vault.yourdomain.com

3. Aktualizujte konfiguraci Vaultwarden:

sed -i "s|^DOMAIN=.*|DOMAIN=https://vault.yourdomain.com|" /opt/vaultwarden/.env
systemctl restart vaultwarden

4. Aktualizujte URL serveru v klientech Bitwarden na https://vault.yourdomain.com.


Krok 5 – Administrační panel (volitelné)

Vaultwarden obsahuje administrační panel pro správu uživatelů, organizací a nastavení serveru. Pro jeho zapnutí se připojte přes SSH a nastavte token administrátora:

echo 'ADMIN_TOKEN=your-secret-token-here' >> /opt/vaultwarden/.env
systemctl restart vaultwarden

Pak otevřete https://your.server.ip/admin a zadejte token. V administračním panelu můžete:

  • Zvát nebo mazat uživatele
  • Vypnout otevřenou registraci
  • Spravovat organizace
  • Zobrazit diagnostiku serveru

Po instalaci

Fail2Ban – ochrana proti útokům hrubou silou

Váš server obsahuje Fail2Ban předkonfigurovaný k ochraně SSH i webového rozhraní Vaultwarden proti útokům hrubou silou.

Pravidlo Max. počet pokusů Doba blokace
SSH5 neúspěšných přihlášení10 minut
Vaultwarden5 neúspěšných přihlášení1 hodina

Užitečné příkazy:

# Check banned IPs
fail2ban-client status sshd
fail2ban-client status vaultwarden

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Pokud se omylem zablokujete, připojte se přes konzoli VNC v klientském panelu a odblokujte svou IP.

Správa služeb

# Check status
systemctl status vaultwarden nginx

# Restart Vaultwarden
systemctl restart vaultwarden

# View logs
journalctl -u vaultwarden -f

# Edit config
nano /opt/vaultwarden/.env

# Backup database (SQLite)
cp /opt/vaultwarden/data/db.sqlite3 /root/vaultwarden-backup-$(date +%Y%m%d).sqlite3

Aktualizace

Vaultwarden je nainstalovaný jako samostatný binární soubor a neaktualizuje se automaticky. Pro aktualizaci nahraďte binární soubor novější verzí z oficiálního obrazu Docker:

# On a machine with Docker, extract the new binary:
docker pull vaultwarden/server:latest-alpine
CID=$(docker create vaultwarden/server:latest-alpine)
docker cp $CID:/vaultwarden /tmp/vaultwarden
docker rm $CID

# Copy to your server and replace:
scp /tmp/vaultwarden root@your.server.ip:/tmp/
ssh root@your.server.ip "systemctl stop vaultwarden && cp /tmp/vaultwarden /opt/vaultwarden/vaultwarden && chmod +x /opt/vaultwarden/vaultwarden && systemctl start vaultwarden"

Aktualizace OS:

apt update && apt upgrade -y

Zahrnutý software

Komponenta Podrobnosti
Ubuntu24.04 LTS
VaultwardenNejnovější (databáze SQLite)
NginxReverzní proxy s SSL
CertbotLet’s Encrypt SSL
Fail2BanOchrana SSH a Vaultwarden proti útokům hrubou silou

Řešení problémů

Problém Řešení
Prohlížeč zobrazuje varování SSL U výchozího certifikátu podepsaného sebou samým je to očekávané. Nastavte doménu a spusťte /opt/setup/get-ssl.sh vault.yourdomain.com pro důvěryhodný certifikát
Nelze se dostat do webového trezoru Kontrola služeb: systemctl status vaultwarden nginx. Ujistěte se, že používáte https:// (ne http)
Klient Bitwarden se nemůže připojit Ujistěte se, že jste v nastavení klienta zvolili „Self-hosted“ a zadali správnou URL serveru s https://
Zapomenuté hlavní heslo Hlavní heslo nelze obnovit – je to záměr (šifrování s nulovou znalostí). Pokud jste zapnuli administrační panel, můžete účet smazat a vytvořit nový
Blokováno službou Fail2Ban Odblokujte svou IP přes konzoli VNC v klientském panelu: fail2ban-client set sshd unbanip 1.2.3.4
Zapomenuté heslo root Obnovte jej přes konzoli VNC v klientském panelu