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=falseyapın. - Yönetim sayfası,
ADMIN_TOKENvermedikçe kapalıdır. Gerekmiyorsa kapalı bırakın. /databirimini 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.:latestyerine 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/vesends/, 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.