İçeriğe geç
zefıly
← Tüm yazılar

Vaultwarden'ı kendi sunucunuzda çalıştırmak: kendi parola yöneticiniz

5 dk okuma

Vaultwarden, yaklaşık 10 MB bellekle çalışan, Bitwarden uyumlu küçük bir sunucudur. Docker ile nasıl başlatılır, HTTPS neden şarttır, kayıtlar nasıl kapatılır, ne yedeklenir ve nasıl güncellenir. Vaultwarden 1.37 ile denendi.

Vaultwarden, Bitwarden uygulamaları için bir sunucudur: tarayıcı eklentileri, masaüstü uygulamaları ve telefon uygulamaları onunla çalışır. Rust ile yazılmıştır ve çok küçüktür. Parola yöneticisi aynı zamanda bir hatanın en çok can yaktığı hizmettir; bu yüzden bu rehber kurulumu kısa, sonrasını uzun anlatır.

Buradaki komutları 12 Kasım 2026'da resmi imajla denedik: Vaultwarden 1.37.5, web kasası 2026.10.1.

Kısaca

  • Tek kapsayıcı, tek birim (/data), veritabanı sunucusu yok.
  • Çok küçüktür: boşta duran kapsayıcımız yaklaşık 8 MB bellek kullandı.
  • HTTPS şarttır. Web kasası düz HTTP üzerinde çalışmaz.
  • Hesabınızı oluşturduktan sonra SIGNUPS_ALLOWED=false yapın.
  • Yönetim sayfası, ADMIN_TOKEN vermedikçe kapalıdır. Gerekmiyorsa kapalı bırakın.
  • /data birimini yedekleyin ve geri yüklemeyi deneyin. Parolalarınız oradadır.

1. Kapsayıcıyı başlatın

docker volume create vw_data

docker run -d --name vaultwarden --restart unless-stopped \
  -p 127.0.0.1:8080:80 \
  -e DOMAIN=https://vault.example.com \
  -e SIGNUPS_ALLOWED=true \
  -v vw_data:/data \
  docker.io/vaultwarden/server:1.37.5
  • 127.0.0.1:8080: yalnızca sunucunun kendisinden erişilir. HTTPS'i öndeki web sunucusu ekler.
  • DOMAIN: https:// ile birlikte genel adres. Vaultwarden bunu bağlantılarda ve eklerde kullanır.
  • :latest yerine sabit sürüm etiketi; böylece güncellemeler siz karar verince olur.

Çalıştığını kontrol edin:

curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/alive
200

2. HTTPS isteğe bağlı değil

Bitwarden web kasası şifrelemeyi tarayıcıda yapar ve tarayıcılar buna yalnızca güvenli sayfalarda izin verir. Düz HTTP üzerinde sayfayı açabilirsiniz ama hesap oluşturamazsınız.

Önüne nginx koyun:

server {
    server_name vault.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

ve başka her şeyden önce sertifika alın.

3. Hesabınızı oluşturun, sonra kapıyı kapatın

Siteyi açıp hesabınızı oluşturun. Uzun bir ana parola seçin: her şeyin anahtarı odur ve kimse sizin yerinize sıfırlayamaz. Vaultwarden onu hiç görmez.

Sonra yeni kayıtları durdurun. Kapsayıcıyı şu ayarla yeniden oluşturun:

-e SIGNUPS_ALLOWED=false

Bunu yapana kadar adresi bulan herkes sunucunuzda hesap açabilir. Sonradan aile ya da ekip üyesi eklemek için onları bir kuruluştan davet edin ya da kayıtları kısa süreliğine açın.

Web kasası ayarlarından hesabınız için iki adımlı girişi açın.

4. Yönetim sayfası

/admin, bütün sunucunun ayar sayfasıdır. Denememizde şu yanıtı verdi:

The admin panel is disabled, please configure the 'ADMIN_TOKEN' variable to enable it

Güvenli varsayılan budur. Gerekiyorsa (kullanıcı davet etmek ya da ayarları görmek için) ADMIN_TOKEN değerini uzun, rastgele bir değere ayarlayın ve /admin yoluna yalnızca kendi IP adresinizden izin vermeyi düşünün.

5. Birimde neler var

db.sqlite3  rsa_key.pem  tmp  ...
  • db.sqlite3: bütün kullanıcılar ve şifreli kasaları.
  • rsa_key.pem: giriş belirteçlerini imzalayan anahtar.
  • attachments/ ve sends/, bu özellikler kullanıldığında oluşur.

Kasa kayıtları sunucuya ulaşmadan önce her kullanıcının ana parolasıyla şifrelenir. Veritabanını çalan biri yine de o parolayı kırmak zorundadır; parolanın uzun olması bu yüzden önemlidir.

6. Yedekler

En önemli bölüm budur. Kaybolan kasa, içindeki bütün parolaların kaybı demektir.

docker stop vaultwarden
docker run --rm -v vw_data:/data -v "$PWD":/backup alpine \
  tar czf /backup/vaultwarden-$(date +%F).tar.gz -C /data .
docker start vaultwarden
  • Her gün çalıştırın ve arşivi sunucunun dışındaki bir depolamaya kopyalayın.
  • Yalnızca en yenisini değil, birkaç günün kopyasını tutun.
  • Bir tanesini deneme kapsayıcısına geri yükleyin ve giriş yapın. Hiç geri yüklenmemiş yedek henüz yedek değildir.
  • Ara sıra uygulamadan kasanızı dışa aktarın ve şifreli dışa aktarımı güvenli bir yerde saklayın.

Bitwarden uygulamaları kasanın yerel bir kopyasını tutar; sunucunun kısa süre kapanması sizi dışarıda bırakmaz. Yedeği olmayan kayıp bir sunucu ise bırakır.

7. Güncellemeler

docker pull docker.io/vaultwarden/server:<yeni sürüm>
docker stop vaultwarden && docker rm vaultwarden
# aynı docker run komutunu yeni etiketle çalıştırın

Önce yedek alın. Projenin sürümlerini izleyin: parola yöneticisinde güvenlik düzeltmeleri bekletilmez.

8. Açıkta olanı azaltın

  • Sunucunun kendisini güncel tutun; güvenlik duvarı yalnızca 80 ve 443'ü açsın.
  • Kasayı yalnızca siz kullanıyorsanız siteyi kendi IP adreslerinizle ya da bir VPN ile sınırlayın.
  • Web sunucusu günlüğünde tekrarlayan başarısız girişleri izleyin.

Zefily ile

Vaultwarden, Zefily'de tek tıkla kurulan bir uygulamadır: sitenin kendi Linux kullanıcısı altında yetkisiz (rootless) bir kapsayıcı, 127.0.0.1 üzerinde, HTTPS'li web sunucusunun arkasında; verisi güncellemelerden etkilenmeyen bir birimde. DOMAIN sizin için ayarlanır. Sonrasında hesabınızı oluşturur, sitenin .env dosyasında SIGNUPS_ALLOWED=false yapar ve Şimdi deploy et'a basarsınız. Kendi depolamanıza yedekler ve IP adresine göre erişim kuralları panelin parçasıdır. Konteyner uygulamaları ve Yedekler belgelerine bakın.

Sık sorulan sorular

Vaultwarden, Bitwarden uygulamalarıyla uyumlu mu?

Evet. Resmi Bitwarden tarayıcı eklentileri, masaüstü ve mobil uygulamaları Vaultwarden sunucusuyla çalışır; giriş yaparken kendi sunucu adresinizi girersiniz.

Vaultwarden ne kadar bellek ister?

Çok az. Boşta duran Vaultwarden 1.37.5 kapsayıcımız yaklaşık 8 MB bellek kullandı.

Vaultwarden HTTPS olmadan çalışır mı?

Hayır. Web kasası şifrelemeyi tarayıcıda yapmak için güvenli bir sayfa ister. Kapsayıcıyı sertifikalı bir web sunucusunun arkasına koyun.

Yabancıların Vaultwarden'ıma kaydolmasını nasıl engellerim?

Kendi hesabınızı oluşturduktan sonra SIGNUPS_ALLOWED=false yapın ve kapsayıcıyı yeniden başlatın.

Vaultwarden için neyi yedeklemeliyim?

Bütün /data birimini: db.sqlite3, rsa_key.pem ve ekler. Her gün sunucu dışına kopyalayın ve geri yüklemeyi deneyin.

Zefily'de bir siteyi IP adresine göre kısıtlamak için Erişim, önbellek ve koruma belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →