Vaultwarden hakkında
Vaultwarden, Bitwarden sunucu API'sinin Rust ile yazılmış alternatif bir uygulamasıdır. Resmi Bitwarden uygulamaları ve eklentileriyle (tarayıcı, mobil, masaüstü, komut satırı) çalışır, çok az kaynak tükettiği için küçük bir VPS'e uygundur. Kimlik bilgilerini kendi kontrolündeki bir sunucuda tutmak isteyen geliştiriciler, aileler ve küçük ekipler tarafından kullanılır.
Teslimatta kurulum betiği Docker'ı kurar, ardından /opt/vaultwarden dizininde Docker Compose ile iki konteyner başlatır. Vaultwarden yalnızca yerel adreste (127.0.0.1:8080) dinler, Caddy ise arayüzü 443 numaralı bağlantı noktasında HTTPS ile yayınlar. Veriler vw_data adlı bir Docker volume içinde saklanır.
Sertifika kendinden imzalıdır (Caddy'nin tls internal yönergesi) ve sunucunun genel IP adresine bağlıdır. Bir alan adı bağlayana kadar tarayıcınız uyarı gösterir. Kayıt başlangıçta açıktır (SIGNUPS_ALLOWED=true). Önce hesabınızı oluşturun, sonra kaydı kapatın.
Vaultwarden ile neler yapabilirsiniz
Bitwarden istemcileriyle uyumlu
Bitwarden uygulamaları ve eklentileri, yalnızca sunucunuzun URL'si girilerek bağlanır. Alıştığınız araçları üçüncü taraf bir hizmet olmadan kullanırsınız.
Düşük kaynak tüketimi
Rust ile yazılan Vaultwarden, mütevazı bir VPS'te rahatça çalışır. Aynı makinede başka hizmetlere de yer kalır.
Caddy ile HTTPS
Caddy ana makine ağında çalışır ve arayüzü 443 numaralı bağlantı noktasında kendinden imzalı sertifikayla sunar. Vaultwarden konteyneri doğrudan internete açılmaz.
Docker Compose ile dağıtım
Tüm yapılandırma
/opt/vaultwarden/docker-compose.ymlveCaddyfiledosyalarındadır. Bir değişiklikten sonradocker compose up -dçalıştırmak yeterlidir.Verileriniz ayrı bir volume'da
Veritabanı ve ekler, konteynerden ayrı olan
vw_datavolume'unda durur. Kasalarınıza dokunmadan imajı güncelleyebilirsiniz.Kontrol edilebilir kayıtlar
SIGNUPS_ALLOWEDdeğişkeni, kullanıcılarınız kaydolduktan sonra hesap oluşturmayı kapatmanızı sağlar. Böylece yabancı biri örneğinize kayıt olamaz.
Vaultwarden ile başlayın
Siparişten canlıya birkaç dakikada.
- 1
VPS'i Vaultwarden seçili olarak sipariş edin
Debian 12, Debian 13 veya Ubuntu 20.04, 22.04, 24.04 yüklü bir Linux VPS seçin (Paris veya Frankfurt). Sipariş formundaki Uygulamalar sekmesinde Vaultwarden'ı işaretleyin.
- 2
Teslimattan sonra kurulumu doğrulayın
Teslimattan sonra birkaç dakika bekleyin: betik önce Docker'ı kurar, ardından konteynerleri başlatır. SSH ile bağlanın ve
vaultwardenilecaddykonteynerlerinin çalıştığını kontrol edin.Bashssh root@SERVER_IP cd /opt/vaultwarden docker compose ps - 3
Ana hesabınızı oluşturun
Tarayıcınızda https://SERVER_IP adresini açın ve kendinden imzalı sertifika uyarısını kabul edin. Hesabınızı oluşturun, ardından kimsenin yeni hesap açamaması için kayıtları kapatın.
Bashsed -i 's/SIGNUPS_ALLOWED=true/SIGNUPS_ALLOWED=false/' /opt/vaultwarden/docker-compose.yml cd /opt/vaultwarden && docker compose up -d - 4
Geçerli HTTPS'li bir alan adına geçin
YOUR_DOMAIN için bir A kaydını SERVER_IP adresine yönlendirin. Caddyfile içindeki bloğu
tls internalolmadan YOUR_DOMAIN ile değiştirin, docker-compose.yml içindeDOMAIN=https://YOUR_DOMAINyazın, 80 ve 443 numaralı bağlantı noktalarını açın ve yeniden başlatın.Bashcd /opt/vaultwarden nano Caddyfile nano docker-compose.yml ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp docker compose up -d --force-recreate
Vaultwarden kullanım alanları
Kişisel veya aile kasası
Hanenizin parolalarını, güvenli notlarını ve kurtarma kodlarını kendi sunucunuzda tutar, tüm cihazlarınızdan erişirsiniz.
Küçük ekip erişim yönetimi
Sunucu erişimleri, SaaS hesapları ve API anahtarları gibi kimlik bilgilerini birkaç çalışma arkadaşınızla Bitwarden organizasyonları ve koleksiyonları üzerinden paylaşırsınız.
Bulut aboneliğine alternatif
Üçüncü tarafça barındırılan bir yöneticiyi bırakır, aynı Bitwarden istemcisini kullanmaya devam eder ve verilerinizi Avrupa'daki bir VPS'te tutarsınız.
Dahili araç sunucusunun bir parçası
Düşük bellek kullanımı sayesinde kasayı, aynı VPS'teki diğer kendi barındırdığınız hizmetlerin yanına yerleştirirsiniz.
Vaultwarden hakkında sık sorulan sorular
Sertifika, Caddy tarafından (tls internal) sunucunun IP adresi için üretilir, bu yüzden herhangi bir genel sertifika otoritesi tarafından imzalanmamıştır. Hesabınızı oluşturmak için kabul edebilirsiniz. Kalıcı kullanım için bir alan adı bağlayın ve Caddy'nin geçerli bir sertifika almasına izin verin.
Vaultwarden hakkında daha fazlası
Bilmeniz gereken dosyalar ve hizmetler
Her şey /opt/vaultwarden içindedir: install-vaultwarden.sh betiği, docker-compose.yml dosyası ve Caddyfile. Üç Docker volume'u şunlardır: vw_data (verileriniz), caddy_data (sertifikalar) ve caddy_config. İki konteyner de otomatik olarak yeniden başlar (restart: always).
Alan adı kullanma
Teslimatta gelen sertifika kendinden imzalıdır ve IP adresine bağlıdır. Mobil uygulamalar ve bazı eklentiler bu tür sertifikaları reddedebilir. Günlük kullanım için geçerli sertifikalı bir alan adı önerilir. Bir alan adınız varsa (bkz. alan adlarımız), asgari bir Caddyfile şöyle görünür:
YOUR_DOMAIN {
reverse_proxy 127.0.0.1:8080
}
DNS kaydı sunucuya işaret ettiği ve 80 ile 443 numaralı bağlantı noktalarına erişilebildiği sürece Caddy genel geçerli bir sertifika alabilir. Değişiklikten sonra docker compose restart caddy ile yeniden başlatın. Vaultwarden'ın DOMAIN değişkenini de buna uygun şekilde güncellemeyi unutmayın.
Yedekleme
vw_data volume'unu yedekleyin: SQLite veritabanını, anahtarları ve ekleri içerir. Volume'un tam adı proje klasörüne bağlıdır, docker volume ls ile kontrol edin (adı vaultwarden_vw_data olmalıdır).
docker run --rm -v vaultwarden_vw_data:/data -v /root:/backup alpine tar czf /backup/vw-backup.tgz -C /data .
Ardından arşivi sunucunun dışına kopyalayın. Aynı VPS üzerinde duran bir yedek, makinenin kaybedilmesine karşı sizi korumaz. /learn bölümündeki rehberler bu adımı otomatikleştirmenize yardımcı olabilir.
Güncellemeler
Kullanılan imaj vaultwarden/server:latest imajıdır. En son sürüme geçmek için önce yedek alın, sonra şunu çalıştırın:
cd /opt/vaultwarden
docker compose pull
docker compose up -d
