SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor

Je, Vaultwarden ni salama? Mwongozo wa ulinzi

Vaultwarden husimba data kwenye kifaa chako, lakini metadata ya akaunti hubaki wazi. Jifunze kulinda admin token na faili za backup ili kuzuia uvamizi wa seva yako.

Je, Vaultwarden ni salama? Jibu fupi

Vaultwarden ni salama katika kipengele kimoja muhimu zaidi, kwa sababu kila kitu kilichomo kwenye vault husimbwa kwa njia ya fiche (encrypted) kwenye kifaa chako kabla hakijafika kwenye seva. Seva huhifadhi yaliyomo kwenye vault yakiwa yamesimbwa, pamoja na metadata ya akaunti iliyo wazi (plaintext). Mtu yeyote anayenakili database nzima bado atahitaji funguo za usimbaji (encryption keys) za vault ili kusoma yaliyomo, lakini atapata anwani za barua pepe za akaunti na vidokezo vya nenosiri (password hints) mara moja.

Jibu hilo linabeba uzito mkubwa, na sehemu zinazoweza kufeli ni zile unazozisanidi wewe mwenyewe. Jopo la usimamizi (admin panel) lililolindwa na token inayoweza kubahatishwa. Port ya container iliyofunguliwa kwa Internet nzima. Faili ya config.json iliyo wazi. Faili ya backup iliyohifadhiwa kwenye home directory ya seva hiyo hiyo. Hakuna kati ya hayo yanayohusu matatizo ya kriptografia. Yote hayo ndiyo sababu vault zinazojiendesha (self-hosted) huweza kuibiwa.

Kila kitu hapa chini kinachukulia kuwa una usakinishaji unaofanya kazi. Ikiwa bado huna, isanidi kwanza kwa kutumia mwongozo wa usakinishaji wa Vaultwarden kwenye VPS, kisha urudi na ufuate orodha hii kwa mpangilio.

Yale ambayo seva huhifadhi kihalisi

Vaultwarden hutumia mfumo wa data wa Bitwarden. Jina la kipengee cha vault, jina la mtumiaji, nenosiri, madokezo na URI husimbwa kwa njia fiche (encrypted) kwenye kifaa cha mtumiaji kwa kutumia ufunguo wa kipengee uliotengenezwa nasibu kabla ya ombi lolote kutumwa. Ufunguo huo hulindwa na ufunguo wa ulinganifu (symmetric key) wa mtumiaji au shirika; ufunguo uliotokana na nenosiri hulinda ufunguo wa ulinganifu wa mtumiaji. Maudhui ya faili zilizounganishwa hutumia ufunguo tofauti wa kiambatisho unaolindwa na ufunguo wa kipengee. Seva hupokea data isiyoweza kusomeka ikiwa na UUID (universally unique identifier) iliyoambatishwa.

Baadhi ya vitu si ciphertext, na unapaswa kujua ni vipi hasa:

  • Anwani ya barua pepe ya akaunti yako na dokezo la nenosiri kuu, katika mfumo wa maandishi wazi (plaintext).
  • Mipangilio yako ya KDF (key derivation function) na salt, kwa sababu kifaa cha mtumiaji huhitaji hivi ili kuunda upya ufunguo wakati wa kuingia (login) kijacho.
  • Hash ya upande wa seva ya hash ya nenosiri kuu inayotumwa na kifaa cha mtumiaji, inayotumika kuthibitisha utambulisho wa kuingia.
  • Metadata: uanachama wa shirika, majina ya vifaa, nyakati za mwisho za kuingia.
  • Siri ya TOTP kwa ajili ya uthibitishaji wa hatua mbili (two-factor login) kupitia authenticator. Hii hukaa kwenye jedwali la twofactor bila kusimbwa, kwa sababu seva lazima ihesabu msimbo unaotarajiwa ili kuulinganisha na wako. Hii si sawa na siri ya TOTP (time-based one-time password) unayohifadhi ndani ya kipengee cha vault, ambayo husimbwa kama sehemu nyingine yoyote.

Folda ya data ni ndogo. Katika usakinishaji wa Docker, hii ni folda yoyote uliyoiweka (mount) kwenye /data.

sudo ls -l /vw-data/

db.sqlite3 huhifadhi karibu hali (state) yote. attachments/ huhifadhi faili zilizopakiwa chini ya saraka za UUID, nje ya majedwali ya hifadhidata. sends/ huhifadhi viambatisho vya Send na imekusudiwa kuwa ya muda mfupi. icon_cache/ ni ya kutupwa. rsa_key.pem na faili zake shirikishi husaini JWTs (JSON web tokens) za watumiaji walioingia, kwa hivyo nakala ya ufunguo huo wa faragha inaweza kutumika kughushi kikao cha kuingia kwenye vault. config.json huhifadhi mipangilio iliyohifadhiwa kupitia ukurasa wa admin, ikijumuisha vitambulisho vya SMTP katika mfumo wa maandishi wazi na thamani ya token ya admin iliyosanidiwa. Kufuata maelekezo ya Argon2 hapa chini huhifadhi hash ya token ya admin badala ya nenosiri la maandishi wazi.

Kwa hivyo, mfano wa vitisho (threat model) wa kivitendo ni ufikiaji wa mfumo wa faili, si kriptografia ya mtandao. Ufikiaji wa kusoma (read access) kwenye saraka hiyo moja hutoa anwani ya barua pepe ya kila mtumiaji, siri zao za 2FA za kuingia, ufunguo unaoweza kughushi vikao, na nakala ya nje ya mtandao ya kila vault ili kushambuliwa kwa utulivu. Kila hatua hapa chini ipo ili kuwazuia watu wasiingie kwenye saraka hiyo.

Rekebisha token ya admin kwanza

/admin ni jopo kamili la udhibiti: orodha ya watumiaji, mialiko, ufutaji, na kila mpangilio wa runtime. Inalindwa na siri moja iliyoshirikiwa na hakuna kingine. Hakuna jina la mtumiaji. Hakuna uthibitishaji wa hatua mbili (2FA) kwa kila mtumiaji.

Miongozo ya zamani inakuambia utengeneze ADMIN_TOKEN kwa kutumia openssl rand -base64 48. Hiyo inafanya kazi, lakini inaacha siri hiyo ikiwa wazi (plaintext) popote unapoisanidi. Vaultwarden pia inakubali kamba ya Argon2 PHC (password hashing competition), kwa hivyo thamani iliyohifadhiwa ni hash badala yake. Tengeneza moja dhidi ya container inayofanya kazi:

docker exec -it vaultwarden /vaultwarden hash

Au bila kugusa container inayofanya kazi hata kidogo:

docker run --rm -it vaultwarden/server /vaultwarden hash

Itakuuliza nenosiri mara mbili, kisha itachapisha mstari unaoanza na $argon2id$. Kwenye usakinishaji wa bare-metal, endesha ./vaultwarden hash. Ikiwa ungependa kutumia argon2 CLI moja kwa moja, mradi huu unaandika vigezo vya chini vya OWASP:

echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1

Sasa mtego unaowagharimu watu saa moja. Kamba ya PHC imejaa herufi za $, na Docker Compose inachukulia $ kama interpolation ya variable. Ikiwa utaipaste bila kuiepusha (unescaped) kwenye block ya environment:, thamani inayofika kwenye container itaharibika, kwa hivyo /admin itakataa token unayojua ni sahihi. Kuna njia mbili salama. Katika docker-compose.yml, rudufu kila $:

environment:
  ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UI

Katika faili ya .env, hakuna haja ya kuiepusha, lakini tumia alama za kunukuu moja (single quotes):

ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'

Kisha weka kikomo cha kasi (rate limit) kwenye jopo hilo na ufupishe session yake:

ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20

Hii inaruhusu mlipuko wa maombi matatu ya kuingia kwa admin kwa kila IP ya mteja, kisha inajaza posho hiyo kwa ombi moja kila dakika tano. Nenosiri sahihi na lisilo sahihi yote yanahesabiwa, kwa sababu kizuizi kinafanya kazi kabla ya ukaguzi wa nenosiri. Maombi yanayozidi kikomo hupokea HTTP 429 na Too many requests, try again later.. Session ya admin inaisha dakika 20 baada ya kuingia, iwe unatumia jopo hilo au la, kwa sababu shughuli haiongezi muda wake.

Ni bora kuliko yote haya: zima ukurasa huo. Instance nyingi zinauhitaji mara moja tu, ili kusanidi SMTP na kualika watumiaji wa kwanza, na si tena. Ili kuuzima, usiweke ADMIN_TOKEN wala DISABLE_ADMIN_TOKEN, ondoa ufunguo wowote wa "admin_token" kutoka config.json, kisha uunde upya container. Kufuta ufunguo kutoka kwenye faili ni muhimu kwa sababu ukurasa wa admin huandika mipangilio hapo, na kile kilicho kwenye config.json kinashinda mazingira (environment). Kuondoa variable pekee kutaacha ukurasa ukiwa wazi.

Funga usajili kabla mtu yeyote hajapata domain yako

SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=false

SIGNUPS_ALLOWED kwa kawaida huwa true. Ikiachwa hivyo, mtu yeyote anayefika kwenye domain yako anaweza kutengeneza akaunti, na data zao zitahifadhiwa kwenye db.sqlite3 sawa na yako. Iweke kuwa false na uwaongeze watu kupitia mialiko kutoka kwenye ukurasa wa admin; SMTP hutuma barua pepe ya mwaliko, na bila SMTP, seva hurekodi mwaliko kwa anwani hiyo. INVITATIONS_ALLOWED pia huwa true kwa kawaida na inaruhusu admin wa shirika kuwaalika wengine. Hii ni sawa unapowaamini watumiaji wako, na inapaswa kuwa false kwenye instance ya mtumiaji mmoja. Ikiwa ni domain fulani pekee zinazopaswa kusajili, SIGNUPS_DOMAINS_WHITELIST=example.com ni finyu zaidi kuliko usajili wa wazi na ni dhaifu zaidi kuliko mialiko.

SHOW_PASSWORD_HINT huwa false kwa kawaida na inapaswa kubaki hivyo. Ikiwa imewashwa na SMTP haijasanidiwa, kuandika anwani halali ya barua pepe kwenye fomu ya kuingia kutarejesha dokezo la nenosiri kuu la akaunti hiyo, jambo ambalo hufichua dokezo hilo na kuthibitisha kuwa anwani hiyo ipo.

Ikiwa instance yako iliendeshwa huku usajili ukiwa wazi kwa muda wowote, fungua ukurasa wa admin na usome orodha ya watumiaji kabla ya kudhani kuwa wewe ndiye mtumiaji pekee aliyepo.

Porti ambayo hukusudia kuichapisha

Docker image husikiliza kwenye port 80 ndani ya container. Ufungaji wa bare-metal hutumia ROCKET_PORT=8000 kama chaguo-msingi. Amri ya run iliyoandikwa kwenye nyaraka huichapisha hivi:

--publish 127.0.0.1:8000:80

Kiambishi 127.0.0.1: ndicho kiini cha jambo hili. Andika -p 8000:80 badala yake na Docker itafunga 0.0.0.0, na inafanya hivyo kwa kuandika sheria za DNAT (destination network address translation) kwenye table ya nat. Sheria hizo hupitiwa kabla ya chains za filter ambazo ufw huzisimamia, kwa hivyo ufw status huripoti port hiyo kama imekataliwa wakati port hiyo inajibu Internet bila shida. Utaratibu mzima unastahili kusomwa katika mwongozo wa Docker ports zinazokwepa ufw.

Thibitisha kile kinachosikiliza kweli:

sudo ss -tlnp | grep 8000

Matokeo mazuri ni mstari mmoja uliounganishwa kwenye 127.0.0.1:8000. Mstari uliounganishwa kwenye 0.0.0.0:8000 inamaanisha kuwa vault imefichuliwa moja kwa moja. Rekebisha mapping, kisha unda upya container, kwa sababu port binding huwekwa wakati container inaundwa na docker compose restart haitaibadilisha:

docker compose up -d --force-recreate

Port moja zaidi imesalia katika miongozo ya zamani: 3012, port tofauti ya WebSocket. Usaidizi wake uliondolewa katika Vaultwarden 1.31.0, kwa sababu trafiki ya notification ilihamia kwenye port kuu ya HTTP. WEBSOCKET_ENABLED na WEBSOCKET_PORT zimepitwa na wakati tangu 1.29.0 na hupuuzwa. Swichi ya sasa ni ENABLE_WEBSOCKET, ambayo chaguo-msingi lake ni true. Ikiwa firewall yako au faili ya compose bado inafungua 3012, ifunge.

Sitisha TLS kwenye reverse proxy, siyo ndani ya Rocket

Vaultwarden inaweza kutoa TLS (transport layer security) yenyewe kupitia Rocket, mfumo wake wa web, lakini mradi huu unakushauri usifanye hivyo katika mazingira ya production. TLS iliyojengwa ndani ya Rocket haina usaidizi kamili wa SNI (server name indication), ndiyo maana ushauri wa kiusalama ni kufikia instance yako kwa kutumia hostname na siyo kwa anwani ya IP pekee. Masafa ya IP za umma huchunguzwa kila mara, na vault inayojibu kupitia anwani ya IP ni vault inayoweza kupatikana kwa urahisi.

Sehemu muhimu za server block ya 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;
}

nginx ina default ya client_max_body_size hadi 1m, kwa hivyo bila kubadilisha mpangilio huu, maombi ya body kubwa kuliko kikomo hicho yatafeli. nginx hurejesha HTTP 413 kwa mteja na kuingiza client intended to send too large body: ... bytes kwenye log; upload iliyokataliwa haifiki Vaultwarden. Headers za Upgrade na Connection hubeba WebSocket handshake kwenda /notifications/hub. Ukiziondoa, vault itaendelea kufanya kazi, lakini taarifa za WebSocket hazitawafikia wateja wa browser na desktop; wateja wa simu hutumia push notifications zilizosanidiwa kando.

Caddy ni fupi zaidi na hupata cheti chenyewe:

vw.example.com {
  reverse_proxy 127.0.0.1:8000 {
    header_up X-Real-IP {remote_host}
  }
}

Kisha iambie Vaultwarden kuhusu hilo:

DOMAIN=https://vw.example.com
IP_HEADER=X-Real-IP

IP_HEADER tayari ina default ya X-Real-IP, kwa hivyo kazi ni kuhakikisha kuwa proxy inaweka header hiyo. Vaultwarden pia hukubali header hiyo kutoka kwa anwani zilizoorodheshwa kwenye IP_HEADER_TRUSTED_PROXIES pekee, ambayo default yake ni local: anwani yoyote isiyo ya umma (non-global), inayojumuisha proxy iliyo kwenye host moja au kwenye mtandao wa container moja. Proxy inayounganisha kutoka kwa anwani ya umma lazima iongezwe hapo. Ikiwa header haipo au inatoka kwa anwani isiyoaminika, kila mstari wa log na kila kikomo cha login (rate limit) kitaona anwani ya proxy yenyewe, jambo linalomaanisha kuwa makosa ya mshambuliaji mmoja yatahesabiwa dhidi ya kila mtumiaji kwenye instance hiyo. Ikiwa unatumia IP_HEADER=X-Forwarded-For badala yake, 1.37.4 huchukua anwani ya kulia kabisa ambayo si proxy inayoaminika, kwa hivyo orodhesha kila proxy iliyo kwenye mnyororo, ikijumuisha CDN iliyo mbele ya nginx. Weka DOMAIN kwenye URL halisi ya https pia, kwa sababu Vaultwarden hujenga viungo vya mwaliko na urejeshaji wa akaunti kutoka hapo, na funguo za usalama za WebAuthn hufungwa kwenye asili (origin) hiyo.

Maelezo moja ambayo watu husahau: muunganisho wa WebSocket hupitisha session token kwenye query string, kama /notifications/hub?access_token=[JWT]. Hiyo huonekana kwenye log ya proxy yako ikiwa wazi (in the clear). Ficha (redact) parameter ya access_token kwenye format ya log, au hakikisha logs hizo hazitumwi mahali popote ambapo huna udhibiti.

Kuzuia mashambulizi ya brute force kwenye endpoint ya kuingia

Rate limits zimewashwa kwa chaguo-msingi (LOGIN_RATELIMIT_SECONDS=60, LOGIN_RATELIMIT_MAX_BURST=10). Hizi hupunguza kasi ya mshambuliaji. Hazimsimamishi kabisa. fail2ban hufanya hivyo, lakini inahitaji mahali pa kusoma majaribio yaliyoshindikana ya kuingia kwenye Vaultwarden. Katika Docker, njia rahisi ni kutumia faili ya log, na Vaultwarden haiandiki log nje ya boksi:

LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=true

Jaribio lililoshindikana la kuingia kwa nenosiri hutoa mstari katika umbo hili, na huu ndio mfuatano wa herufi ambao kichujio chako lazima kilingane nao:

[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.

Andika kichujio kwenye /etc/fail2ban/filter.d/vaultwarden.local:

[INCLUDES]
before = common.conf

[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =

Na jail kwenye /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 = 14400

Ikiwa Vaultwarden inaendeshwa kama huduma ya systemd badala ya kuwa ndani ya container, unaweza kuruka LOG_FILE: wiki ya fail2ban ya mradi huu inasoma journal kwa kutumia backend = systemd na journalmatch kwenye unit ya Vaultwarden badala ya logpath.

Ikiwa ulihifadhi ukurasa wa admin, ongeza jail ya pili ambayo failregex yake ni ^.*Invalid admin token\. IP: <ADDR>.*$, kwa sababu makosa ya admin hurekodiwa kwa ujumbe tofauti na kichujio cha kuingia hakitayaona kamwe. Kisha kagua kazi yako:

sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwarden

Jail inayofanya kazi huorodhesha faili yako ya log chini ya File list na kuripoti Currently failed: 0. Ingiza nenosiri lisilo sahihi mara tatu kutoka mtandao mwingine na kaunta hiyo itaongezeka, kisha anwani hiyo itaonekana chini ya Banned IP list. Ikiwa kaunta haiongezeki kamwe, sababu ya kawaida ni logpath: lazima iwe njia ya faili kwenye host, si njia ya /data/... iliyo ndani ya container. Sababu ya pili ya kawaida ni kukosekana au kutokuaminika kwa X-Real-IP, jambo linalofanya kila ban ilenge proxy yako mwenyewe. Usanidi mwingine, ikiwemo jail ya SSH ambayo unapaswa kuwa unaiendesha tayari, uko kwenye mwongozo wa fail2ban kwa Ubuntu 24.04.

Nenosiri kuu bado ndilo mfumo mzima

Ufumbaji wa data upande wa mteja (client-side encryption) unamaanisha kuwa nenosiri kuu hulinda ufunguo wa symmetric wa mtumiaji. Nenosiri kuu fupi kwenye mfumo ambao mshambuliaji amenakili hifadhidata yake halilindwi na chochote katika chapisho hili, kwa sababu wanashambulia nakala hiyo nje ya mtandao kwa kasi yoyote ile ambayo maunzi yao inaruhusu. Hakuna mpangilio wa seva unaoweza kufikia mashine ya mshambuliaji.

PASSWORD_ITERATIONS=600000 ni rahisi kueleweka vibaya. Inapanga idadi ya marudio (iterations) kwa ajili ya hash ya upande wa seva ya login hash inayotumwa na mteja, na kiolezo cha usanidi wa mradi kinasema kuwa thamani iliyobadilishwa hutumika kwa watumiaji waliopo wakati wa login yao inayofuata. Haigusi KDF ya upande wa mteja, ambayo ndiyo mpangilio unaoamua gharama ya shambulio la nje ya mtandao dhidi ya vault. Mpangilio huo ni wa kila akaunti, na hubadilishwa chini ya Settings, Security, Keys katika web vault, jambo ambalo hufanya ufumbaji upya wa ufunguo. Nyaraka za Bitwarden zinasema kuwa wateja wake tangu 2026.2.1 huongeza mpangilio wa PBKDF2 ulio chini ya 600,000 iterations kiotomatiki mtumiaji anapoingia au kufungua vault kwa nenosiri kuu. Kufikia tarehe 10 Oktoba 2026 tabia hiyo haijathibitishwa dhidi ya seva ya Vaultwarden, na haibadilishi kamwe mipangilio ya Argon2id. Kwa hivyo, mtu aliyesajiliwa miaka iliyopita anaweza bado kuwa kwenye mpangilio wa zamani na wa chini wa KDF. Kagua, na uwaambie, kwa sababu seva haiwezi kuwafanyia hivyo.

Kisha wezesha uthibitishaji wa hatua mbili (two-factor authentication) kwa kila akaunti. Hii hailindi ciphertext, kwa sababu haishiriki katika ufumbaji wa vault. Inazuia nenosiri lililoibwa kutosheleza kuingia na kusawazisha nakala. Ikiwa barua pepe imesanidiwa, REQUIRE_DEVICE_EMAIL=true hufanya barua pepe ya login ya kifaa kipya kuwa ya lazima: ikiwa utumaji utafeli, login itafeli. Ikiwa huduma ya barua pepe imezimwa kabisa, mpangilio huu hauzuii login za vifaa vipya.

Backup ndipo mahali ambapo vault zinazojiendesha (self-hosted) hukosea

tar czf ya folda ya data, ikihifadhiwa kwenye home directory ya VPS hiyo hiyo, inabatilisha kila hatua uliyochukua hapo juu. Kumbukumbu hiyo ina db.sqlite3 yenye ciphertext ya kila mtumiaji, rsa_key.pem inayoweza kughushi vikao vya kuingia (login sessions), na config.json yenye thamani ya token ya admin iliyosanidiwa na nenosiri la SMTP. Kufuata maelekezo ya Argon2 kunahifadhi hash ya nenosiri la admin; nenosiri la SMTP linabaki katika mfumo wa maandishi wazi (plaintext). Upatikanaji wa kusoma faili hiyo moja hufichua metadata ya akaunti, siri za seva, na data iliyosimbwa ya vault.

Kanuni mbili zinashughulikia hili. Ondoa kumbukumbu hiyo kwenye seva. Isimbe (encrypt) kabla haijatoka.

Pia kuna tatizo la usahihi. Kunakili db.sqlite3 kwa kutumia cp wakati huduma inaendelea kufanya kazi kunaweza kutoa faili ambayo iko katikati ya kuandikwa na haitafunguka, na hutajua hilo hadi utakapojaribu kuirejesha. Tumia snapshot ya SQLite yenyewe badala yake:

sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"

Upande wa urejeshaji, ambao ni nusu ambayo hakuna anayeijaribu, umeelezwa katika mwongozo wa backup na urejeshaji wa Vaultwarden.

Mambo unayopoteza kwa kutumia Bitwarden iliyohifadhiwa na wewe mwenyewe

Ukweli mtupu. Huduma ya Bitwarden inayohifadhiwa na wao inaendeshwa na watu ambao kazi yao ya muda wote ni hiyo, na wana ukaguzi wa watu wengine uliochapishwa. Kujihifadhia mwenyewe kunabadilisha hali hiyo na kukuweka kwenye ratiba yako mwenyewe ya kusakinisha viraka (patches).

Vaultwarden hutoa marekebisho ya usalama kama releases za kawaida, na hutokea mara kwa mara. Ikiangaliwa tarehe 2 Novemba 2026 dhidi ya feed ya release ya mradi huo, release ya sasa ni 1.37.5, iliyochapishwa tarehe 1 Novemba 2026. Maelezo yake yanashughulikia ushauri mbili za usalama za kiwango cha Medium na inashauri sana kusasisha haraka iwezekanavyo. Pia inahitajika kwa web vault 2026.7.1 na mpya zaidi ili kuwasha au kuzima mbinu za kuingia kwa hatua mbili, na kwa 2026.9.0 na mpya zaidi ili kuchukua udhibiti wa akaunti kupitia emergency access. Release iliyotangulia, 1.37.4, iliyochapishwa tarehe 5 Oktoba 2026, ilishughulikia ushauri saba za usalama, ambapo ile kali zaidi ilikadiriwa kuwa High. Hiyo ilikuwa release ya nne tangu 1.37.0 ya tarehe 24 Julai 2026: 1.37.1 ilifuata tarehe 29 Julai, 1.37.2 tarehe 22 Agosti (inahitajika kwa clients toleo 2026.8.0 na mpya zaidi), na 1.37.3 tarehe 13 Septemba, ambayo inafuta 2FA remember tokens wakati credentials au 2FA zinapobadilika na kuweka rate limits kwenye endpoints za prelogin na auth request. Ikiwa unaendesha mashirika yenye admins ambao huwaamini kikamilifu, maelezo ya 1.37.4 pia yanapendekeza kubadilisha API key ya kila shirika baada ya kusasisha. 1.37.4 pia inabadilisha anwani inayosomwa kutoka X-Forwarded-For, iliyojadiliwa katika sehemu ya reverse proxy hapo juu. Instance uliyoiweka mwaka mmoja uliopita na kuisahau inaendesha code ya mwaka mmoja uliopita. Tag ya latest haisaidii peke yake: container inayofanya kazi huendelea kutumia image iliyoanza nayo hadi utakapofanya docker compose pull na kuiumba upya. Weka unattended upgrades kwenye Ubuntu kwa ajili ya vifurushi vya host, na uweke sasisho la container kwenye kikumbusho cha kalenda ambacho utakisoma kweli.

Hitimisho ambalo msomaji mwaminifu anapaswa kulifikia: cryptography iliyopo hapa ni usanifu wa Bitwarden na inafanya kazi vizuri, wakati hatari ya uendeshaji inahamia kwako kikamilifu. Ikiwa utaisasisha na kuifanyia backup mahali pengine, instance ya Vaultwarden kwenye VPS unayoimiliki ni mahali pazuri pa kuhifadhi nywila zako. Ikiwa tabia hizo mbili hazitafanyika, lipia huduma iliyohifadhiwa na wao na uelekeze umakini wako kwingine. Ulinganisho wa kipengele kwa kipengele upo kwenye Vaultwarden ikilinganishwa na Bitwarden ya kujihifadhia.

Kuimarisha usalama wa seva inayohifadhi container

Vaultwarden ni mchakato mmoja kwenye seva ya Linux, na mtumiaji mwenye mamlaka ya root kwenye seva hiyo anaweza kusoma /vw-data bila kujali jinsi programu ilivyosanidiwa. Endesha container kama mtumiaji asiye na upendeleo (unprivileged user) kwa kutumia user: "1000:1000" kwenye faili yako ya compose, huku folda ya data ikiwa na umiliki unaolingana, na mount chochote ambacho container haiandiki kama read-only kwa kutumia :ro. Kisha funga mlango wa mbele: Kuimarisha usalama wa SSH kwenye VPS inaelezea jinsi ya kutumia login ya funguo pekee (key-only) na kuzima uthibitishaji wa nenosiri, jambo ambalo huzuia mashambulizi ya kawaida yanayoweza kupita hatua zote zilizotajwa hapo juu.

FAQ

Je, mtu anaweza kusoma nywila zangu akiiiba database ya Vaultwarden?

Hawawezi moja kwa moja. Kila kitu kilichomo kwenye vault husimbwa kwa njia ya fiche (encrypted) kwenye kifaa cha mtumiaji kwa kutumia ufunguo uliotengenezwa nasibu, ambao hulindwa kupitia ufunguo wa symmetric wa mtumiaji au shirika; ufunguo uliotokana na nywila hulinda ufunguo wa symmetric wa mtumiaji. db.sqlite3 ina yaliyomo kwenye vault yaliyosimbwa pamoja na metadata ya akaunti iliyo wazi (plaintext). Wanachokipata mara moja ni anwani ya barua pepe ya kila akaunti na dokezo la nywila, mipangilio ya KDF, metadata ya kuingia na ya kifaa, na siri za TOTP za kuingia kwenye jedwali la twofactor, ambazo huhifadhiwa bila kusimbwa kwa sababu seva lazima ihesabu msimbo unaotarajiwa. Wanaweza pia kushambulia maandishi fiche ya vault nje ya mtandao (offline) kwa muda wowote wanaotaka, ndiyo sababu urefu wa nywila kuu (master password) ndio namba inayoamua matokeo.

Je, nitumie ADMIN_TOKEN au nizime ukurasa wa admin kabisa?

Uuzime ikiwa unaweza, kwa sababu mifano (instances) mingi huhitaji ukurasa huo mara moja tu ili kusanidi SMTP na kualika watumiaji, na hauhitajiki tena. Ili kuuzima, usiweke ADMIN_TOKEN wala DISABLE_ADMIN_TOKEN, ondoa ufunguo wowote wa "admin_token" kutoka config.json, kisha uunde upya container. Kuondoa kigezo cha mazingira (environment variable) pekee hakutoshi, kwa sababu mipangilio iliyoandikwa na ukurasa wa admin hukaa kwenye config.json na ina kipaumbele zaidi. Ikiwa utauacha ukurasa huo, hifadhi token kama Argon2 hash iliyotengenezwa na vaultwarden hash badala ya kamba ya herufi nasibu iliyo wazi, na uweke ADMIN_RATELIMIT_MAX_BURST=3.

ADMIN_TOKEN yangu ni sahihi lakini /admin inaikataa. Nini tatizo?

Karibu kila mara ni tatizo la interpolation ya $. Kamba ya Argon2 PHC ina herufi kadhaa za $, na Docker Compose hupanua herufi hizo kama vigezo ndani ya kizuizi cha docker-compose.yml environment:, kwa hivyo container hupokea thamani iliyoharibika wakati faili lako linaonekana sawa. Marudisha kila $ kuwa $$ kwenye faili la compose, au hamisha thamani hiyo kwenye faili la .env lililofungwa kwenye alama za kunukuu (single quotes), ambapo hakuna haja ya kufanya escaping. Unda upya container baada ya hapo, kwa sababu mabadiliko ya mazingira hayachukuliwi kwa kuanzisha upya (restart) pekee.

Je, bado nahitaji kufungua port 3012 kwa ajili ya arifa?

Hapana. Usaidizi wa trafiki ya WebSocket kwenye port 3012 uliondolewa katika Vaultwarden 1.31.0 kwa sababu arifa zilihamishiwa kwenye port kuu ya HTTP, na WEBSOCKET_ENABLED pamoja na WEBSOCKET_PORT zimepitwa na wakati tangu 1.29.0 na hupuuzwa. Mpangilio wa sasa ni ENABLE_WEBSOCKET, ambao ni true kwa chaguo-msingi. Funga 3012 kwenye firewall na uifute kutoka kwenye faili lako la compose, kisha hakikisha reverse proxy yako inasambaza vichwa vya habari (headers) vya Upgrade na Connection, kwa sababu arifa za WebSocket za kivinjari na desktop hutegemea vichwa hivyo. Wateja wa simu hutumia arifa za push zilizosanidiwa kando.

Je, makala hii ilikusaidia?