Czy Vaultwarden jest bezpieczny? Poradnik hardeningu
Vaultwarden szyfruje dane po stronie klienta, lecz metadane pozostają jawne. Dowiedz się, jak zabezpieczyć token administratora oraz pliki kopii zapasowych przed wyciekiem.
Czy Vaultwarden jest bezpieczny? Krótka odpowiedź
Vaultwarden jest bezpieczny w najważniejszym aspekcie, ponieważ każdy element sejfu jest szyfrowany na urządzeniu użytkownika, zanim trafi na serwer. Serwer przechowuje zaszyfrowaną zawartość sejfów wraz z metadanymi konta w postaci jawnej. Osoba, która skopiuje całą bazę danych, nadal potrzebuje kluczy szyfrujących sejfu, aby odczytać jego zawartość, ale natychmiast uzyskuje dostęp do adresów e-mail kont oraz podpowiedzi do haseł.
Ta krótka odpowiedź niesie ze sobą duży ciężar, a elementy, które zawodzą, to te, które podlegają konfiguracji użytkownika. Panel administratora zabezpieczony łatwym do odgadnięcia tokenem. Port kontenera wystawiony na cały Internet. Plik config.json w postaci jawnej. Archiwum kopii zapasowej pozostawione w katalogu domowym na tym samym serwerze. Żaden z tych problemów nie dotyczy kryptografii. Wszystkie one są powodem, dla którego samodzielnie hostowane sejfy są opróżniane.
Wszystkie poniższe punkty zakładają działającą instalację. Jeśli jeszcze jej nie posiadasz, skonfiguruj ją zgodnie z przewodnikiem instalacji Vaultwarden na VPS, a następnie wróć i wykonaj czynności z tej listy w podanej kolejności.
Co faktycznie przechowuje serwer
Vaultwarden implementuje model danych Bitwarden. Nazwa elementu sejfu, nazwa użytkownika, hasło, notatki oraz identyfikatory URI są szyfrowane po stronie klienta za pomocą losowo wygenerowanego klucza elementu, zanim jakiekolwiek żądanie zostanie wysłane. Ten klucz jest chroniony przez klucz symetryczny użytkownika lub organizacji; klucz wyprowadzony z hasła chroni klucz symetryczny użytkownika. Zawartość plików załączników wykorzystuje oddzielny klucz załącznika, chroniony przez klucz elementu. Serwer otrzymuje nieprzejrzyste dane z przypisanym do nich identyfikatorem UUID (universally unique identifier).
Niektóre elementy nie są szyfrogramami i należy dokładnie wiedzieć, które z nich:
- Adres e-mail konta oraz podpowiedź do hasła głównego, przechowywane jako tekst jawny.
- Ustawienia KDF (key derivation function) oraz sól, ponieważ klient potrzebuje ich do odtworzenia klucza przy kolejnym logowaniu.
- Skrót po stronie serwera z hasła głównego przesyłanego przez klienta, używany do uwierzytelnienia samego logowania.
- Metadane: przynależność do organizacji, nazwy urządzeń, czasy ostatniego logowania.
- Klucz TOTP dla dwuetapowego logowania opartego na aplikacjach uwierzytelniających. Znajduje się on w tabeli
twofactorw postaci niezaszyfrowanej, ponieważ serwer musi obliczyć oczekiwany kod, aby porównać go z kodem użytkownika. Nie jest to tożsame z kluczem TOTP (time-based one-time password) przechowywanym wewnątrz elementu sejfu, który jest szyfrowany tak samo jak każde inne pole.
Folder danych jest niewielki. W instalacji Docker jest to katalog zamontowany w /data.
sudo ls -l /vw-data/db.sqlite3 przechowuje niemal cały stan aplikacji. attachments/ przechowuje przesłane pliki w katalogach o nazwach UUID, poza tabelami bazy danych. sends/ przechowuje załączniki funkcji Send i jest przeznaczony do danych tymczasowych. icon_cache/ zawiera dane tymczasowe. rsa_key.pem wraz z plikami towarzyszącymi służy do podpisywania tokenów JWT (JSON web tokens) zalogowanych użytkowników, więc kopia tego klucza prywatnego może zostać użyta do sfałszowania sesji logowania do sejfu. config.json przechowuje ustawienia zapisane przez stronę administracyjną, w tym dane uwierzytelniające SMTP w postaci tekstu jawnego oraz skonfigurowaną wartość tokena administratora. Postępowanie zgodnie z poniższymi instrukcjami dotyczącymi Argon2 powoduje przechowywanie skrótu tokena administratora zamiast hasła w postaci tekstu jawnego.
Praktyczny model zagrożeń dotyczy zatem dostępu do systemu plików, a nie kryptografii sieciowej. Dostęp do odczytu tego jednego katalogu pozwala na przejęcie adresu e-mail każdego użytkownika, ich kluczy 2FA, klucza umożliwiającego fałszowanie sesji oraz kopii offline każdego sejfu w celu przeprowadzenia ataku w dowolnym czasie. Każdy poniższy krok ma na celu uniemożliwienie dostępu osób niepowołanych do tego katalogu.
Najpierw napraw token administratora
/admin to pełny panel sterowania: lista użytkowników, zaproszenia, usuwanie, każde ustawienie środowiska uruchomieniowego. Jest chroniony jednym współdzielonym kluczem (secret) i niczym więcej. Brak nazwy użytkownika. Brak uwierzytelniania dwuskładnikowego dla poszczególnych użytkowników.
Starsze poradniki zalecają wygenerowanie ADMIN_TOKEN za pomocą openssl rand -base64 48. Działa to, ale pozostawia klucz w postaci jawnej w każdym miejscu konfiguracji. Vaultwarden akceptuje również ciąg Argon2 PHC (password hashing competition), dzięki czemu przechowywana wartość jest skrótem. Wygeneruj go przy użyciu działającego kontenera:
docker exec -it vaultwarden /vaultwarden hashLub bez ingerencji w działający kontener:
docker run --rm -it vaultwarden/server /vaultwarden hashNarzędzie poprosi o dwukrotne podanie hasła, a następnie wyświetli linię zaczynającą się od $argon2id$. W przypadku instalacji bare-metal uruchom ./vaultwarden hash. Jeśli wolisz użyć bezpośrednio CLI argon2, projekt dokumentuje minimalne parametry OWASP:
echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1Teraz pułapka, która kosztuje użytkowników godzinę pracy. Ciąg PHC zawiera znaki $, a Docker Compose traktuje $ jako interpolację zmiennych. Wklejenie go bez znaków ucieczki do bloku environment: powoduje, że wartość docierająca do kontenera jest uszkodzona, przez co /admin odrzuca poprawny token. Istnieją dwie bezpieczne metody. W docker-compose.yml należy podwoić każdy znak $:
environment:
ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UIW pliku .env znaki ucieczki nie są wymagane, ale należy użyć pojedynczego cudzysłowu:
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'Następnie ogranicz częstotliwość zapytań do panelu i skróć czas trwania sesji:
ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20Pozwala to na serię trzech żądań logowania administratora na adres IP klienta, a następnie uzupełnia limit o jedno żądanie co pięć minut. Zarówno poprawne, jak i błędne hasła wliczają się do limitu, ponieważ ogranicznik działa przed weryfikacją hasła. Żądania przekraczające limit otrzymują kod HTTP 429 z Too many requests, try again later.. Sesja administratora wygasa 20 minut po zalogowaniu, niezależnie od tego, czy panel jest nadal używany, ponieważ aktywność nie przedłuża sesji.
Lepszym rozwiązaniem jest wyłączenie tej strony. Większość instancji potrzebuje jej tylko raz, aby skonfigurować SMTP i zaprosić pierwszych użytkowników, a później nigdy więcej. Aby ją wyłączyć, nie ustawiaj ani ADMIN_TOKEN, ani DISABLE_ADMIN_TOKEN, usuń klucz "admin_token" z config.json, a następnie utwórz kontener ponownie. Usunięcie klucza z pliku jest istotne, ponieważ panel administratora zapisuje tam ustawienia, a zawartość config.json ma pierwszeństwo przed zmiennymi środowiskowymi. Samo usunięcie zmiennej pozostawia stronę otwartą.
Zamknięcie rejestracji przed odnalezieniem domeny
SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=falseSIGNUPS_ALLOWED domyślnie przyjmuje wartość true. Pozostawienie tego ustawienia sprawia, że każda osoba odwiedzająca domenę może założyć konto, a jej dane będą przechowywane w tej samej bazie db.sqlite3 co dane administratora. Należy zmienić tę wartość na false i dodawać użytkowników poprzez zaproszenia z poziomu panelu administracyjnego; protokół SMTP dostarcza wiadomość z zaproszeniem, natomiast w przypadku jego braku serwer rejestruje zaproszenie dla danego adresu. Opcja INVITATIONS_ALLOWED jest również domyślnie true i pozwala administratorom organizacji zapraszać inne osoby. Jest to dopuszczalne w przypadku zaufanych użytkowników, jednak na instancjach jednoosobowych ustawienie to powinno być false. Jeśli rejestracja ma być ograniczona tylko do określonych domen, SIGNUPS_DOMAINS_WHITELIST=example.com stanowi węższe rozwiązanie niż otwarta rejestracja, lecz jest znacznie mniej bezpieczne niż system zaproszeń.
SHOW_PASSWORD_HINT jest domyślnie false i powinno pozostać w tym stanie. Gdy opcja ta jest włączona, a serwer SMTP nie został skonfigurowany, wpisanie poprawnego adresu e-mail w formularzu logowania powoduje wyświetlenie podpowiedzi do hasła głównego danego konta. Ujawnia to treść podpowiedzi oraz potwierdza istnienie adresu w bazie.
Jeśli instancja działała z otwartą rejestracją przez jakikolwiek czas, należy otworzyć panel administracyjny i przejrzeć listę użytkowników przed założeniem, że jest to konto jedyne.
Port, którego nie zamierzano udostępniać
Obraz Docker nasłuchuje na porcie 80 wewnątrz kontenera. Instalacja typu bare-metal domyślnie korzysta z ROCKET_PORT=8000. Udokumentowane polecenie uruchomienia publikuje go w następujący sposób:
--publish 127.0.0.1:8000:80Prefiks 127.0.0.1: stanowi istotę problemu. Należy wpisać -p 8000:80, aby Docker powiązał port z 0.0.0.0, co realizowane jest poprzez zapisanie reguł DNAT (destination network address translation) w tablicy nat. Reguły te są sprawdzane przed łańcuchami filter zarządzanymi przez ufw, dlatego ufw status zgłasza port jako zablokowany, podczas gdy port w rzeczywistości odpowiada na zapytania z Internetu. Pełny mechanizm został opisany w przewodniku dotyczącym omijania ufw przez porty Dockera.
Należy sprawdzić, co faktycznie nasłuchuje:
sudo ss -tlnp | grep 8000Prawidłowy wynik to pojedyncza linia powiązana z 127.0.0.1:8000. Linia powiązana z 0.0.0.0:8000 oznacza, że vault jest wystawiony bezpośrednio. Należy poprawić mapowanie, a następnie odtworzyć kontener, ponieważ powiązanie portu jest ustalane w momencie tworzenia kontenera i docker compose restart nie zmieni tego ustawienia:
docker compose up -d --force-recreateW starych poradnikach występuje jeszcze jeden port: 3012, czyli oddzielny port WebSocket. Obsługa tego portu została usunięta w Vaultwarden 1.31.0, ponieważ ruch powiadomień został przeniesiony na główny port HTTP. Zmienne WEBSOCKET_ENABLED oraz WEBSOCKET_PORT są przestarzałe od wersji 1.29.0 i są ignorowane. Obecnym przełącznikiem jest ENABLE_WEBSOCKET, którego domyślną wartością jest true. Jeśli zapora sieciowa lub plik compose nadal otwierają port 3012, należy go zamknąć.
Terminacja TLS na reverse proxy, a nie w Rocket
Vaultwarden może obsługiwać TLS (transport layer security) samodzielnie za pośrednictwem Rocket, swojego frameworka webowego, jednak projekt odradza takie rozwiązanie w środowisku produkcyjnym. Wbudowana obsługa TLS w Rocket nie posiada ścisłego wsparcia dla SNI (server name indication), co stanowi również powód, dla którego zaleca się dostęp do instancji wyłącznie przez nazwę hosta, a nigdy przez bezpośredni adres IP. Publiczne zakresy adresów IP są stale skanowane, a vault odpowiadający na adresie IP to vault, który zostanie wykryty.
Kluczowe elementy bloku serwera nginx:
client_max_body_size 525M;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}Domyślnie nginx ustawia client_max_body_size na 1m, więc bez nadpisania tego parametru każde żądanie o rozmiarze większym niż ten limit zakończy się niepowodzeniem. Nginx zwraca klientowi kod HTTP 413 i loguje client intended to send too large body: ... bytes; odrzucony przesył nie dociera do Vaultwarden. Nagłówki Upgrade oraz Connection przenoszą handshake WebSocket do /notifications/hub. Ich usunięcie sprawi, że vault nadal będzie działał, ale powiadomienia WebSocket przestaną docierać do klientów przeglądarkowych i desktopowych; klienci mobilni korzystają z osobno konfigurowanych powiadomień push. Jak je włączyć i jak podać adres serwera w aplikacjach na Androida i iOS jeszcze przed logowaniem, wyjaśnia poradnik podłączania aplikacji Bitwarden do własnego Vaultwarden.
Caddy jest bardziej zwięzły i samodzielnie uzyskuje certyfikat:
vw.example.com {
reverse_proxy 127.0.0.1:8000 {
header_up X-Real-IP {remote_host}
}
}Następnie należy poinformować o tym Vaultwarden:
DOMAIN=https://vw.example.com
IP_HEADER=X-Real-IPIP_HEADER ma już domyślnie ustawione X-Real-IP, więc zadanie polega na upewnieniu się, że proxy faktycznie ustawia ten nagłówek. Vaultwarden akceptuje ten nagłówek tylko z adresów wymienionych w IP_HEADER_TRUSTED_PROXIES, co domyślnie wynosi local: dowolny adres niebędący adresem globalnym, co obejmuje proxy na tym samym hoście lub w tej samej sieci kontenerów. Proxy łączące się z adresu publicznego musi zostać tam dodane. Jeśli nagłówek jest nieobecny lub pochodzi z niezaufanego adresu, każda linia logu i każdy limit szybkości logowania będą widziały adres samego proxy, co oznacza, że nieudane próby jednego atakującego będą przypisywane wszystkim użytkownikom instancji. W przypadku użycia IP_HEADER=X-Forwarded-For, wersja 1.37.4 przyjmuje najbardziej wysunięty w prawo adres, który nie jest zaufanym proxy, dlatego należy wymienić każde proxy w łańcuchu, wliczając w to CDN przed nginx. Należy również ustawić DOMAIN na właściwy adres URL https, ponieważ Vaultwarden buduje na jego podstawie linki do zaproszeń i odzyskiwania konta, a klucze bezpieczeństwa WebAuthn są powiązane z tym źródłem (origin).
Jeden szczegół, który jest często pomijany: połączenie WebSocket przekazuje token sesji w ciągu zapytania jako /notifications/hub?access_token=[JWT]. Trafia on w postaci jawnej do logów dostępu proxy. Należy zredagować parametr access_token w formacie logów lub upewnić się, że logi te nie są przesyłane w miejsca, nad którymi nie sprawuje się kontroli.
Blokowanie ataków brute force na punkcie końcowym logowania
Limity szybkości (rate limits) są domyślnie włączone (LOGIN_RATELIMIT_SECONDS=60, LOGIN_RATELIMIT_MAX_BURST=10). Spowalniają one atakującego, ale go nie zatrzymują. Robi to fail2ban, jednak wymaga on dostępu do informacji o nieudanych próbach logowania do Vaultwarden. W środowisku Docker najprostszym rozwiązaniem jest plik dziennika, a Vaultwarden nie tworzy go w konfiguracji domyślnej:
LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=trueNieudane logowanie hasłem generuje wiersz o poniższym formacie; jest to ciąg znaków, który musi dopasować filtr:
[2026-08-07 09:14:22.000][vaultwarden::api::identity][ERROR] Username or password is incorrect. Try again. IP: 203.0.113.10. Username: user@example.com.Utwórz filtr w /etc/fail2ban/filter.d/vaultwarden.local:
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =Oraz jail w /etc/fail2ban/jail.d/vaultwarden.local:
[vaultwarden]
enabled = true
backend = pyinotify
port = 80,443
filter = vaultwarden
banaction = %(banaction_allports)s
logpath = /vw-data/vaultwarden.log
maxretry = 3
bantime = 14400
findtime = 14400Jeśli Vaultwarden działa jako usługa systemd, a nie w kontenerze, można pominąć LOG_FILE: wiki projektu fail2ban zaleca odczyt dziennika za pomocą backend = systemd oraz journalmatch dla jednostki Vaultwarden zamiast logpath.
Jeśli pozostawiono aktywną stronę administratora, należy dodać drugi jail, którego failregex to ^.*Invalid admin token\. IP: <ADDR>.*$, ponieważ błędy logowania administratora są rejestrowane z innym komunikatem i filtr logowania ich nie wykryje. Następnie sprawdź poprawność konfiguracji:
sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwardenPoprawnie działający jail wyświetla plik dziennika w sekcji File list i raportuje Currently failed: 0. Wprowadź błędne hasło trzy razy z innej sieci; licznik powinien wzrosnąć, a adres IP pojawi się w sekcji Banned IP list. Jeśli licznik pozostaje bez zmian, najczęstszą przyczyną jest logpath: musi to być ścieżka do pliku na hoście, a nie ścieżka /data/... wewnątrz kontenera. Drugą częstą przyczyną jest brakujący lub nieprawidłowo skonfigurowany X-Real-IP, co powoduje, że każde zablokowanie dotyczy własnego proxy. Pozostała część konfiguracji, w tym jail dla SSH, który powinien być już aktywny, znajduje się w przewodniku fail2ban dla Ubuntu 24.04.
Hasło główne nadal stanowi fundament całego systemu
Szyfrowanie po stronie klienta oznacza, że hasło główne chroni klucz symetryczny użytkownika. Krótkie hasło główne w instancji, której bazę danych skopiował atakujący, nie jest w żaden sposób chronione w tym scenariuszu, ponieważ atak na kopię odbywa się offline z dowolną szybkością, na jaką pozwala sprzęt atakującego. Żadne ustawienie serwera nie wpływa na maszynę atakującego.
PASSWORD_ITERATIONS=600000 łatwo błędnie zinterpretować. Ustawia ono liczbę iteracji dla hasha po stronie serwera, tworzonego z hasha logowania przesyłanego przez klienta, a szablon konfiguracji projektu wskazuje, że zmieniona wartość jest stosowana do istniejących użytkowników przy ich kolejnym logowaniu. Nie wpływa to na KDF po stronie klienta, czyli ustawienie decydujące o koszcie ataku offline na sejf. To ustawienie jest przypisane do każdego konta i zmienia się je w sekcji Settings, Security, Keys w sejfie internetowym, co powoduje ponowne zaszyfrowanie klucza. Dokumentacja Bitwarden podaje, że klienci od wersji 2026.2.1 automatycznie zwiększają ustawienie PBKDF2 poniżej 600,000 iteracji, gdy użytkownik loguje się lub odblokowuje sejf hasłem głównym. Na dzień 10 października 2026 zachowanie to nie jest potwierdzone w przypadku serwera Vaultwarden i nigdy nie zmienia ustawień Argon2id. Dlatego użytkownik, który zarejestrował się lata temu, może nadal korzystać ze starszego, niższego ustawienia KDF. Należy to sprawdzić i poinformować użytkownika, ponieważ serwer nie może zrobić tego za niego.
Następnie należy włączyć uwierzytelnianie dwuskładnikowe dla każdego konta. Nie chroni ono tekstu zaszyfrowanego, ponieważ nie bierze udziału w szyfrowaniu sejfu. Zapobiega jednak sytuacji, w której skradzione hasło wystarczy do zalogowania się i zsynchronizowania kopii. Jak skonfigurować poszczególne metody, od e-maila i Duo po YubiKey OTP i klucze FIDO2, oraz gdzie zapisać kod odzyskiwania na wypadek utraty drugiego składnika, wyjaśnia poradnik logowania dwuetapowego w Vaultwarden. Przy skonfigurowanej poczcie e-mail, REQUIRE_DEVICE_EMAIL=true sprawia, że e-mail o logowaniu z nowego urządzenia staje się obowiązkowy: jeśli wysyłka się nie powiedzie, logowanie zostanie przerwane. Jeśli usługa pocztowa jest całkowicie wyłączona, to ustawienie nie blokuje logowań z nowych urządzeń.
Kopie zapasowe to punkt, w którym zawodzi bezpieczeństwo własnych instancji
tar czf folderu z danymi, pozostawiony w katalogu domowym na tym samym serwerze VPS, niweluje wszystkie powyższe kroki. Archiwum to zawiera db.sqlite3 z szyfrogramem każdego użytkownika, rsa_key.pem, które pozwala na sfałszowanie sesji logowania, oraz config.json z zapisaną wartością tokena administratora i hasłem SMTP. Zgodnie z instrukcjami Argon2, przechowywany jest skrót hasła administratora; hasło SMTP pozostaje jednak tekstem jawnym. Dostęp do odczytu tego jednego pliku ujawnia metadane kont, sekrety serwera oraz zaszyfrowane dane sejfów.
Obowiązują dwie zasady. Przenieś archiwum poza serwer. Zaszyfruj je przed wysłaniem.
Istnieje również problem poprawności danych. Kopiowanie db.sqlite3 za pomocą cp podczas działania usługi może wygenerować plik w trakcie zapisu, którego nie da się otworzyć, o czym użytkownik dowie się dopiero podczas przywracania. Należy użyć wbudowanego mechanizmu migawek SQLite:
sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"Proces przywracania, czyli etap, którego nikt nie testuje, został opisany w przewodniku tworzenia i przywracania kopii zapasowych Vaultwarden.
Z czego rezygnujesz przy własnym hostingu Bitwarden
Uczciwa ocena. Usługa hostowana Bitwarden jest obsługiwana przez zespół, którego pełnoetatowym zadaniem jest jej utrzymanie, a całość podlega publikowanym audytom zewnętrznym. Samodzielny hosting zamienia to na własny harmonogram aktualizacji.
Vaultwarden udostępnia poprawki bezpieczeństwa jako zwykłe wydania, które pojawiają się często. Stan na 2 listopada 2026, sprawdzony na podstawie kanału wydań projektu, wskazuje na wersję 1.37.5, opublikowaną 1 listopada 2026. Informacje o wydaniu obejmują dwa ostrzeżenia o poziomie bezpieczeństwa Medium i zalecają niezwłoczną aktualizację. Jest ona również wymagana dla web vault w wersji 2026.7.1 i nowszych, aby móc włączać lub wyłączać metody logowania dwuetapowego, oraz dla wersji 2026.9.0 i nowszych, aby przejąć konto poprzez dostęp awaryjny. Poprzednie wydanie, 1.37.4, opublikowane 5 października 2026, obejmowało siedem ostrzeżeń o bezpieczeństwie, z których najpoważniejsze oceniono jako High. Było to czwarte wydanie od czasu 1.37.0 z 24 lipca 2026: 1.37.1 pojawiło się 29 lipca, 1.37.2 22 sierpnia (wymagane dla klientów w wersji 2026.8.0 i nowszych), a 1.37.3 13 września, które unieważnia tokeny pamięci 2FA przy zmianie poświadczeń lub 2FA oraz wprowadza limity zapytań dla punktów końcowych prelogin i auth. Jeśli zarządzasz organizacjami z administratorami, do których nie masz pełnego zaufania, notatki do wersji 1.37.4 sugerują również rotację klucza API każdej organizacji po aktualizacji. Wersja 1.37.4 zmienia również adres odczytywany z X-Forwarded-For, co opisano w sekcji dotyczącej reverse proxy powyżej. Instancja skonfigurowana rok temu i zapomniana działa na rocznym kodzie. Znacznik latest sam w sobie nie pomaga: uruchomiony kontener zachowuje obraz, z którego wystartował, dopóki nie wykonasz docker compose pull i nie utworzysz go ponownie. Skonfiguruj automatyczne aktualizacje na Ubuntu dla pakietów hosta, a aktualizację kontenera ustaw w kalendarzu jako przypomnienie, które faktycznie przeczytasz.
Wniosek, jaki powinien wyciągnąć uczciwy czytelnik: zastosowana kryptografia to projekt Bitwarden i jest ona solidna, natomiast ryzyko operacyjne przechodzi w całości na Ciebie. Jeśli instalujesz poprawki i wykonujesz kopie zapasowe w innej lokalizacji, instancja Vaultwarden na kontrolowanym przez Ciebie VPS jest rozsądnym miejscem na przechowywanie haseł. Jeśli te dwa nawyki nie zostaną wdrożone, opłać usługę hostowaną i poświęć uwagę innym kwestiom. Porównanie funkcji znajduje się w Vaultwarden w porównaniu z samodzielnie hostowanym Bitwarden.
Zabezpieczanie hosta pod kontenerem
Vaultwarden jest pojedynczym procesem w systemie Linux, a użytkownik root na tym hoście może odczytać /vw-data niezależnie od konfiguracji samej aplikacji. Uruchom kontener jako użytkownik bez uprawnień przy użyciu user: "1000:1000" w pliku compose, ustawiając odpowiedniego właściciela dla folderu z danymi, oraz montuj elementy, do których kontener nie zapisuje, w trybie tylko do odczytu za pomocą :ro. Następnie zabezpiecz dostęp: Zabezpieczanie SSH na serwerze VPS opisuje logowanie wyłącznie przy użyciu kluczy oraz wyłączenie uwierzytelniania hasłem, co skutecznie blokuje ataki typu brute-force, które mogłyby ominąć powyższe zabezpieczenia.
FAQ
Czy ktoś może odczytać moje hasła, jeśli ukradnie bazę danych Vaultwarden?
Nie bezpośrednio. Każdy element sejfu jest szyfrowany w kliencie za pomocą losowo wygenerowanego klucza, chronionego przez symetryczny klucz użytkownika lub organizacji; klucz pochodzący z hasła chroni klucz symetryczny użytkownika. db.sqlite3 zawiera zaszyfrowaną zawartość sejfu wraz z metadanymi konta w postaci jawnej. To, co atakujący uzyskuje natychmiast, to adres e-mail każdego konta, podpowiedź do hasła, ustawienia KDF, metadane logowania i urządzeń oraz sekrety TOTP w tabeli twofactor, które są przechowywane bez szyfrowania, ponieważ serwer musi obliczyć oczekiwany kod. Atakujący może również przeprowadzać ataki offline na szyfrogram sejfu przez dowolnie długi czas, dlatego długość hasła głównego jest czynnikiem decydującym o bezpieczeństwie.
Czy powinienem użyć ADMIN_TOKEN, czy całkowicie wyłączyć stronę administracyjną?
Wyłącz ją, jeśli możesz, ponieważ większość instancji potrzebuje jej tylko raz do skonfigurowania SMTP i zaproszenia użytkowników, a później już nigdy. Aby ją wyłączyć, nie ustawiaj ani ADMIN_TOKEN, ani DISABLE_ADMIN_TOKEN, usuń klucz "admin_token" z config.json, a następnie odtwórz kontener. Usunięcie samej zmiennej środowiskowej nie wystarczy, ponieważ ustawienia zapisane przez stronę administracyjną znajdują się w config.json i mają pierwszeństwo. Jeśli zachowujesz dostęp do strony, przechowuj token jako skrót Argon2 wygenerowany przez vaultwarden hash, zamiast jako jawny ciąg znaków, i ustaw ADMIN_RATELIMIT_MAX_BURST=3.
Mój ADMIN_TOKEN jest poprawny, ale /admin go odrzuca. Co jest nie tak?
Prawie zawsze jest to interpolacja $. Ciąg Argon2 PHC zawiera kilka znaków $, a Docker Compose rozwija je jako zmienne wewnątrz bloku docker-compose.yml environment:, przez co kontener otrzymuje zniekształconą wartość, mimo że w pliku wygląda ona poprawnie. Podwój każdy znak $ na $$ w pliku compose lub przenieś wartość do pliku .env ujętego w pojedyncze cudzysłowy, gdzie nie jest wymagane żadne znakowanie ucieczki. Po wykonaniu tych czynności odtwórz kontener, ponieważ zmiany w środowisku nie są uwzględniane przy zwykłym restarcie.
Czy nadal muszę otwierać port 3012 dla powiadomień?
Nie. Obsługa ruchu WebSocket na porcie 3012 została usunięta w Vaultwarden 1.31.0, ponieważ powiadomienia zostały przeniesione na główny port HTTP, a WEBSOCKET_ENABLED i WEBSOCKET_PORT są uznawane za przestarzałe od wersji 1.29.0 i są ignorowane. Obecne ustawienie to ENABLE_WEBSOCKET, które domyślnie jest true. Zamknij port 3012 w zaporze sieciowej i usuń go z pliku compose, a następnie upewnij się, że Twój reverse proxy przekazuje nagłówki Upgrade oraz Connection, ponieważ powiadomienia WebSocket w przeglądarce i aplikacji desktopowej są od nich zależne. Klienci mobilni korzystają z osobno konfigurowanych powiadomień push.