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ě.
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.
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:
- Rozšíření prohlížeče: Chrome, Firefox, Edge, Safari
- Desktopová aplikace: Windows, macOS, Linux
- Mobilní aplikace: iOS, Android
Před přihlášením nasměrujte klienta na svůj server:
- Na přihlašovací obrazovce klikněte na výběr regionu (nebo ikonu ozubeného kola) a zvolte Self-hosted
- Zadejte URL serveru:
https://your.server.ip - 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 |
|---|---|---|
| SSH | 5 neúspěšných přihlášení | 10 minut |
| Vaultwarden | 5 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Vaultwarden | Nejnovější (databáze SQLite) |
| Nginx | Reverzní proxy s SSL |
| Certbot | Let’s Encrypt SSL |
| Fail2Ban | Ochrana 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 |