Bu rehber neleri kapsıyor
PassZit, kendi sunucunuzda çalışan ücretsiz ve açık kaynaklı (AGPLv3) bir parola yöneticisidir. Her kullanıcının oturum bilgileri, tek kullanımlık kodlar, güvenli notlar, kartlar, SSH anahtarları ve dosyalar için uçtan uca şifreli bir kasası vardır; ekipler kasaları kişi başına haklarla paylaşır. Sunucu yalnızca şifreli veri saklar. Self-hosted bir Bitwarden alternatifi aradığınız için araçları karşılaştırıyorsanız, bu rehber PassZit'in kurulumunun ve kullanıma alınmasının pratikte nasıl göründüğünü gösterir.
- Neye ihtiyacınız var
- Sunucuyu kurun
- İlk oturum açma ve ilk yönetici
- Tarayıcıların güvendiği bir sertifika
- Ekibinizi davet edin
- Ana parola ve kurtarma anahtarı
- Tarayıcı uzantısını kurun
- Başka bir programdan parolaları içe aktarın
- Şifreleme nasıl çalışır
- Sunucuyu yedekleyin
- Güncellemeler
- Bilmeniz gereken sınırlar
- Sonraki adımlar
Neye ihtiyacınız var
- VMware, VirtualBox, Proxmox VE/KVM veya Hyper-V üzerinde bir sanal makine ya da fiziksel bir sunucu: 2 vCPU, 2 GB RAM ve 16 GB disk — veya mevcut 64 bit Debian 12+, Ubuntu 22.04+, AlmaLinux ya da Rocky Linux 9+ sunucusu (x86-64 veya ARM64).
- Tarayıcılar sunucuya TCP 8443 üzerinden ulaşır. PostgreSQL'i kurulum betiği ve imajlar kurar.
- Tarayıcı uzantıları için: sunucu için bir DNS adı ve tarayıcıların güvendiği bir sertifika (aşağıya bakın).
- İsteğe bağlı olarak, PassZit'in davetleri ve bildirimleri e-postayla göndermesi için bir SMTP sunucusu.
Sunucuyu kurun
Dört yol vardır; hepsi indirme sayfasında ve her sürüm imzalıdır.
| Yol | En uygun olduğu durum |
|---|---|
| VM imajı: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V 1. nesil) | İçe aktarın, başlatın, oturum açın — Debian, PostgreSQL ve PassZit hazır |
| Appliance ISO | Yeni bir VM veya fiziksel sunucu; gözetimsiz kurulum ilk diski siler |
| Kurulum betiği | Mevcut bir Debian, Ubuntu, AlmaLinux veya Rocky Linux sunucusu |
| Paketler (deb, rpm; amd64, arm64) | Kendi PostgreSQL'iniz ve yapılandırma yönetiminiz |
VM imajı veya ISO: VM'i başlatın. Ekranında konsol adresi ve kurulum belirteci görünür. VM konsolunda pzadmin olarak oturum açabilirsiniz (ilk parola passzit, ilk oturumda değiştirilir): bir menü ağı, sunucu adını ve saat dilimini ayarlar, belirteci yeniden gösterir ve yedekleri geri yükler. Yalnızca 22 (SSH) ve 8443 portları açıktır.
Kurulum betiği: sunucuda root olarak:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Betik PostgreSQL'i kurar, en yeni sürümü indirir, imzasını doğrular, rastgele parolalı bir veritabanı oluşturur, hizmeti başlatır ve adresi ile kurulum belirtecini yazdırır. --version, --db (mevcut bir PostgreSQL veritabanı) veya --no-auto-updates gibi seçenekler sh -s -- ile verilir.
Paketler: deb veya rpm paketini kurun, /etc/passzit/server.env içinde PASSZIT_DB değerini ayarlayın ve systemctl start passzit-server komutunu çalıştırın. Kurulum belirteci /var/lib/passzit/setup-token.txt dosyasındadır.
İlk oturum açma ve ilk yönetici
https://<sunucu>:8443adresini açın. Yeni bir sunucu kendinden imzalı bir sertifika kullanır; tarayıcı bir kez uyarır — kabul edin.- Kurulum belirtecini, e-posta adresinizi ve bir ana parola girin. Tarayıcınız şimdi anahtarlarınızı oluşturur; bu bir saniye sürer. Bu ilk hesap yöneticidir.
- QR kodunu bir kimlik doğrulama uygulamasıyla tarayın (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). İki adımlı oturum açma her hesap için zorunludur. On kurtarma kodunu saklayın; her biri uygulamanın yerini bir kez tutar.
- Bir kurtarma anahtarı oluşturun (aşağıya bakın) ve ilk oturum bilginizi Yeni öğe ile ekleyin.
Daha sonra Hesabım altında ikinci faktör olarak güvenlik anahtarları (YubiKey ve diğerleri) veya cihazınızın geçiş anahtarını ekleyebilirsiniz.
Tarayıcıların güvendiği bir sertifika
Tarayıcı uzantıları kendinden imzalı sertifikaları reddeder; bu yüzden uzantıyı dağıtmadan önce sunucuya gerçek bir sertifika verin. Ayarlar → Sertifika altında bir sertifika yükleyin (şirketinizin CA'sından veya satın alınmış; ara sertifikalar ve özel anahtarla birlikte PEM) ya da Let's Encrypt'i seçin. Let's Encrypt herkese açık bir DNS adı ister ve bunu sunucunun 80 numaralı portu veya Cloudflare'deki bir DNS kaydı üzerinden doğrular — ikincisi yalnızca kendi ağınızdan erişilen bir sunucu için de çalışır. Sertifika yeniden başlatma olmadan hemen kullanılır; ağınızın DNS'i adı sunucuya yönlendirmelidir.
Ekibinizi davet edin
Hesaplar yalnızca davetle oluşturulur. Kullanıcılar → Kullanıcı davet et altında e-posta adresini ve rolü (Kullanıcı veya Yönetici) girin. PassZit davet bağlantısını yalnızca bir kez gösterir; bağlantıyı kişiye gönderin. Bağlantı bir kez ve varsayılan olarak 7 gün çalışır. Ayarlar → E-posta altında bir SMTP sunucusu ayarladıysanız Daveti e-postayla da gönder seçeneğini işaretleyin; PassZit daveti sizin yerinize gönderir.
Davet edilen kişi, sizin gibi, bir ana parola seçer ve iki adımlı oturum açmayı ayarlar. Yöneticiler kullanıcıları devre dışı bırakabilir, kaybolan ikinci faktörü sıfırlayabilir ve açık davetleri geri çekebilir. Parolaları paylaşmak için paylaşılan bir kasa oluşturun ve kişilere veya gruplara erişim verin.
Şirket hesapları Ayarlar → Şirket oturum açması altında bağlanır: OpenID Connect veya SAML 2.0 ile çoklu oturum açma ve Active Directory / LDAP. Ana parola her zaman kalır, çünkü kasanın anahtarıdır.
Ana parola ve kurtarma anahtarı
Ana parola kullanıcının tarayıcısından hiç çıkmaz. Uçtan uca şifrelemenin amacı budur ve bir sonucu vardır: hiç kimse — ne yönetici ne MaxZit — ana parola veya kurtarma anahtarı olmadan bir kasayı açamaz. Yöneticiler ana parolaları göremez ve sıfırlayamaz.
- Dört ila altı rastgele kelimeden oluşan bir parola cümlesi kolay hatırlanır ve zor tahmin edilir. Kasa politikası en az uzunluğu belirler (varsayılan 12 karakter).
- Hesabım altında Kurtarma anahtarı oluştur, 32 harf ve rakamdan oluşan bir anahtarı yalnızca bir kez gösterir. Yazdırın veya not alın ve çevrimdışı saklayın — kasada değil, telefonunuzun yanında da değil.
- Ana parolasını unutan bir kullanıcı, kurtarma anahtarı ve kimlik doğrulama uygulamasından bir kodla oturum açma sayfasında yeni bir parola belirler. Kurtarma anahtarı yoksa kasa kaybolur; yönetici yalnızca hesabı silip kişiyi boş bir kasayla yeniden davet edebilir. Kullanıcı listesi kimin kurtarma anahtarı oluşturduğunu gösterir.
Herkesten ilk gün bir kurtarma anahtarı oluşturmasını isteyin.
Tarayıcı uzantısını kurun
Uzantı, oturum bilgilerini ve tek kullanımlık kodları yalnızca ait oldukları sitede doldurur, yeni ve değişen oturum bilgilerini kaydetmeyi önerir, ödeme ve teslimat formlarına kart ve adresleri doldurur ve parola üretir. Onu güncel tutan tarayıcınızın mağazasından kurun:
- Chrome Web Store — Chrome, Brave, Opera ve Vivaldi
- Firefox Add-ons — Firefox 128 veya daha yenisi
- Microsoft Edge Add-ons — Microsoft Edge
Bağlantılar indirme sayfasında. PassZit sunucusu da aynısını sunar: web kasasının menüsündeki Tarayıcı uzantıları, kullandığınız tarayıcının mağazasıyla Tek tıkla yükle seçeneğini ve elle kurulum için kendi sürümünün paketlerini gösterir.
- PassZit simgesine tıklayın, yalnızca sunucunuzun adresini girin (örneğin
https://vault.example.com) ve Web kasası ile bağla'ya tıklayın. Tarayıcının PassZit'in bu sunucuyla konuşmasına izin vermesini onaylayın. Adresteki bir port, örneğin:8443, Firefox dahil her tarayıcıda çalışır. - Web kasası açılır; henüz oturum açmadıysanız orada oturum açın.
- Kasa, uzantının bu tarayıcıda bağlanıp bağlanmayacağını sorar — Bağla'ya tıklayın. Uzantıya parola veya kod yazılmaz.
Web kasası ve uzantı tek bir kilit açmayı paylaşır: birinin kilidini açarsanız diğeri de açılır, birini kilitlerseniz ikisi de kilitlenir.
Başka bir programdan parolaları içe aktarın
Her kullanıcı kendi kasasına aktarır. Önce eski programdan dışa aktarın, sonra kasada Araçlar → İçe aktar'ı seçip dosyayı belirleyin. PassZit biçimi tanır, kaç öğe ve klasör bulduğunu ve kaçının zaten kasada olduğunu gösterir; dosyadaki klasörleri korumanıza ve yinelenenleri atlamanıza izin verir.
| Kaynak | Orada dışa aktarma |
|---|---|
| Chrome, Edge, Brave, Opera, Vivaldi | Password manager → Settings → Export passwords (CSV) |
| Firefox | about:logins → … → Export passwords (CSV) |
| Safari | File → Export → Passwords (CSV) |
| Bitwarden | Tools → Export vault → .json veya .csv, şifreli varyant değil |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV veya XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
Dosya tarayıcıda okunur; sunucu öğeleri yalnızca şifreli alır. Oturum bilgileri, notlar, web siteleri, özel alanlar, klasörler, sık kullanılanlar ve TOTP sırları aktarılır (Bitwarden'dan kartlar, kimlikler ve SSH anahtarları da). Ekli dosyalar bu dışa aktarmaların parçası değildir. Ardından dışa aktarma dosyasını silin — parolaları şifresiz içerir.
Şifreleme nasıl çalışır
Tarayıcı, ana paroladan Argon2id (64 MiB, 3 geçiş) ile bir ana anahtar türetir. Bundan iki anahtar çıkar: oturum açarken gönderilen bir kimlik doğrulama anahtarı — sunucu bunun yalnızca argon2id özetini saklar — ve kullanıcının rastgele hesap anahtarını açan bir sarma anahtarı. Adı, kullanıcı adı, web siteleri ve notları dahil her öğe, kasasının anahtarıyla AES-256-GCM kullanılarak şifrelenir; paylaşılan kasaların her üyenin X25519 anahtarına mühürlenmiş kendi anahtarı vardır. Sunucu şifreli veriyi, kimlikleri, boyutları ve zaman damgalarını görür; ana parolayı veya kullanabileceği bir anahtarı asla görmez. Ayrıntılar güvenlik sayfasında ve deponun docs/ARCHITECTURE.md dosyasındadır.
Sunucuyu yedekleyin
Ayarlar → Konsol yedeği her gün (ve istek üzerine Şimdi yedekle ile) /var/lib/passzit/backups klasörüne bir yedek yazar: tüm kasalarla birlikte veritabanı, sunucunun gizli anahtarı ve konsol sertifikası — yeni bir sunucunun ihtiyaç duyduğu her şey. Yedek her zaman belirlediğiniz bir parola cümlesiyle şifrelenir; onu başka bir yerde saklayın. Her yedek ayrıca başka bir sunucudaki bir SFTP klasörüne kopyalanabilir. Geri yüklemek için appliance menüsünü kullanın ya da hizmeti durdurup konsoldaki kılavuzda anlatıldığı gibi passzit-server -restore komutunu çalıştırın.
Güncellemeler
Ayarlar → Güncellemeler ve sunucu çalışan ve en yeni sürümü gösterir. Kurulum imzayı yeniden doğrular, veritabanını ve programı yedekler, güncellemeyi kurar ve sunucunun geri geldiğini kontrol eder — gelmezse eski sürümü ve veritabanını kendisi geri koyar. Seçilen bir saatte otomatik kurulum da orada açılır. Kararlı kanal sürümleri alır; Testing bir test sunucusu için sürüm adaylarını da sunar. Betikle yapılan kurulumda betiği yeniden çalıştırmak da PassZit'i günceller ve tüm verileri korur.
Bilmeniz gereken sınırlar
- PassZit aktif olarak geliştirilmektedir: ilk herkese açık sürüm Kasım 2026'da 0.9.0 idi ve yeni sürümler sık çıkıyor.
- Yerel bir mobil uygulama yoktur. Telefonlarda web kasası ana ekrana eklenebilir ve kendi penceresinde açılır, ancak çevrimdışı kullanım için hiçbir şey saklanmaz — sunucu olmadan bir "offline" sayfası görürsünüz.
- Kurtarma anahtarı olmadan unutulan bir ana parolayı kimse kurtaramaz.
- Tarayıcı uzantıları güvenilir bir sertifika ister ve ana parola ile kimlik doğrulama koduyla oturum açar — çoklu oturum açmayla değil.
- Her web kasasında olduğu gibi, web kasasının JavaScript'i sunucudan gelir; tamamen ele geçirilmiş bir sunucu değiştirilmiş kod sunabilir. Uzantı kendi kodunu getirir.
- Docker imajı yoktur; bir imaj, betik veya paketlerle kurun. Konsoldaki kılavuz İngilizce ve Sırpçadır.
Sonraki adımlar
PassZit'i indirin, tüm özelliklere göz atın — paylaşılan kasalar, gizli bağlantılar, acil durum erişimi, uzak bağlantılar, komut satırı — veya konsola yerleşik kılavuzu okuyun (belgeler). Bir ekip için paylaşılan kasaların nasıl kurulacağını Parolaları ekiple paylaşma rehberi anlatır. Sorularınızı GitHub Discussions'ta bekliyoruz. Şirketler MaxZit'ten ticari destek alabilir (yalnızca İngilizce).