Table of Contents

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.

Poznámka: Server v predvolenom stave používa certifikát SSL podpísaný samým sebou. Prehliadač zobrazí bezpečnostné varovanie – kliknite na „Advanced“ a pokračujte. Certifikát Let’s Encrypt môžete nainštalovať neskôr (krok 4).

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.

Dôležité: Hlavné heslo šifruje všetky vaše dáta. Vaultwarden ho nikdy neukladá – ak ho stratíte, dáta nemožno obnoviť. Zvoľte silné heslo, ktoré si zapamätáte.

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:

Pred prihlásením nasmerujte klienta na svoj server:

  1. Na prihlasovacej obrazovke kliknite na výber regiónu (alebo ikonu ozubeného kolesa) a zvoľte Self-hosted
  2. Zadajte URL servera: https://your.server.ip
  3. 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
SSH5 neúspešných prihlásení10 minút
Vaultwarden5 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
Ubuntu24.04 LTS
VaultwardenNajnovšia (databáza SQLite)
NginxReverzná proxy s SSL
CertbotLet’s Encrypt SSL
Fail2BanOchrana 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