Vaultwarden - príručka pre začiatočníkov
Vaultwarden je odľahčený self-hosted správca hesiel kompatibilný so všetkými klientmi Bitwarden – rozšíreniami prehliadačov, mobilnými aj desktopovými aplikáciami. Server je plne nakonfigurovaný s Vaultwarden, reverznou proxy Nginx a SSL. Stačí otvoriť webový trezor, vytvoriť účet a začať ukladať heslá.
Krok 1 – Overte, že Vaultwarden funguje
IP adresa a heslo root vášho servera sú uvedené na stránke Server Details v klientskom paneli. Otvorte prehliadač a prejdite na:
https://your.server.ip
Ak sa načíta prihlasovacia stránka, Vaultwarden funguje správne.
Ak ste server umiestnili za router VyOS v privátnej sieti, buď nastavte presmerovanie portov (80 a 443), alebo sa pripojte cez VPN a k Vaultwarden pristupujte cez privátnu IP servera.
Krok 2 – Vytvorenie účtu
Na prihlasovacej stránke kliknite na Create account. Zadajte e-mailovú adresu, meno a zvoľte hlavné heslo.
Po registrácii sa prihláste e-mailom a hlavným heslom. Toto je váš osobný trezor, kde môžete ukladať heslá, poznámky, karty a identity.
Krok 3 – Pripojenie klientov Bitwarden
Vaultwarden je kompatibilný so všetkými oficiálnymi klientmi Bitwarden:
- Rozšírenie prehliadača: Chrome, Firefox, Edge, Safari
- Desktopová aplikácia: Windows, macOS, Linux
- Mobilná aplikácia: iOS, Android
Pred prihlásením nasmerujte klienta na svoj server:
- Na prihlasovacej obrazovke kliknite na výber regiónu (alebo ikonu ozubeného kolesa) a zvoľte Self-hosted
- Zadajte URL servera:
https://your.server.ip - Uložte a prihláste sa e-mailom a hlavným heslom
Po pripojení sa všetky heslá automaticky synchronizujú naprieč zariadeniami.
Krok 4 – Nastavenie domény a SSL (odporúčané)
Pre najlepšiu prácu s klientmi Bitwarden nastavte doménu s riadnym certifikátom SSL:
1. Vytvorte DNS A záznam smerujúci vašu doménu na IP servera (napr. vault.yourdomain.com → your.server.ip).
2. Pripojte sa k serveru cez SSH a spustite:
ssh root@your.server.ip
/opt/setup/get-ssl.sh vault.yourdomain.com
3. Aktualizujte konfiguráciu Vaultwarden:
sed -i "s|^DOMAIN=.*|DOMAIN=https://vault.yourdomain.com|" /opt/vaultwarden/.env
systemctl restart vaultwarden
4. Aktualizujte URL servera v klientoch Bitwarden na https://vault.yourdomain.com.
Krok 5 – Administračný panel (voliteľné)
Vaultwarden obsahuje administračný panel na správu používateľov, organizácií a nastavení servera. Na jeho zapnutie sa pripojte cez SSH a nastavte token administrátora:
echo 'ADMIN_TOKEN=your-secret-token-here' >> /opt/vaultwarden/.env
systemctl restart vaultwarden
Potom otvorte https://your.server.ip/admin a zadajte token. V administračnom paneli môžete:
- Pozývať alebo mazať používateľov
- Vypnúť otvorenú registráciu
- Spravovať organizácie
- Zobraziť diagnostiku servera
Po inštalácii
Fail2Ban – ochrana proti útokom hrubou silou
Váš server obsahuje Fail2Ban predkonfigurovaný na ochranu SSH aj webového rozhrania Vaultwarden proti útokom hrubou silou.
| Pravidlo | Max. počet pokusov | Doba blokovania |
|---|---|---|
| SSH | 5 neúspešných prihlásení | 10 minút |
| Vaultwarden | 5 neúspešných prihlásení | 1 hodina |
Užitočné príkazy:
# Check banned IPs
fail2ban-client status sshd
fail2ban-client status vaultwarden
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Ak sa omylom zablokujete, pripojte sa cez konzolu VNC v klientskom paneli a odblokujte svoju IP.
Správa služieb
# 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
Aktualizácie
Vaultwarden je nainštalovaný ako samostatný binárny súbor a neaktualizuje sa automaticky. Na aktualizáciu nahraďte binárny súbor novšou verziou z oficiálneho 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"
Aktualizácie OS:
apt update && apt upgrade -y
Zahrnutý softvér
| Komponent | Podrobnosti |
|---|---|
| Ubuntu | 24.04 LTS |
| Vaultwarden | Najnovšia (databáza SQLite) |
| Nginx | Reverzná proxy s SSL |
| Certbot | Let’s Encrypt SSL |
| Fail2Ban | Ochrana SSH a Vaultwarden proti útokom hrubou silou |
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Prehliadač zobrazuje varovanie SSL | Pri predvolenom certifikáte podpísanom samým sebou je to očakávané. Nastavte doménu a spustite /opt/setup/get-ssl.sh vault.yourdomain.com pre dôveryhodný certifikát |
| Nedá sa dostať do webového trezoru | Kontrola služieb: systemctl status vaultwarden nginx. Uistite sa, že používate https:// (nie http) |
| Klient Bitwarden sa nemôže pripojiť | Uistite sa, že ste v nastaveniach klienta zvolili „Self-hosted“ a zadali správnu URL servera s https:// |
| Zabudnuté hlavné heslo | Hlavné heslo nemožno obnoviť – je to zámer (šifrovanie s nulovou znalosťou). Ak ste zapli administračný panel, môžete účet vymazať a vytvoriť nový |
| Zablokované službou Fail2Ban | Odblokujte svoju IP cez konzolu VNC v klientskom paneli: fail2ban-client set sshd unbanip 1.2.3.4 |
| Zabudnuté heslo root | Obnovte ho cez konzolu VNC v klientskom paneli |