Bu rehber neleri kapsıyor
PassZit, MaxZit tarafından geliştirilen, uçtan uca şifrelemeli, ücretsiz, açık kaynaklı (AGPLv3) ve self-hosted bir parola yöneticisidir. PostgreSQL veritabanlı tek bir sunucu programı, bir web kasası, tarayıcı uzantıları ve bir komut satırından oluşur. Bu rehber yalnızca PassZit'i anlatır — başka ürünlerin özelliklerini veya fiyatlarını karşılaştırmaz — böylece onu kendi sunucunuzun bugün yaptıklarıyla kıyaslayabilirsiniz.
- Bir bakışta
- Kurulum
- Şifreleme modeli
- Tarayıcı uzantıları
- Bitwarden biçimindeki bir dışa aktarmayı içe aktarın
- İkinci faktör, geçiş anahtarları ve tek kullanımlık kodlar
- Sunucunun yedekleri ve güncellemeleri
- LDAP ve çoklu oturum açma
- PassZit'i mevcut sunucunuzun yanında test edin
- Bilmeniz gereken sınırlar
- Sonraki adımlar
Bir bakışta
| Alan | PassZit'te var | PassZit'te yok |
|---|---|---|
| Kurulum | VM imajları (OVA, QCOW2, VHDX), appliance ISO, kurulum betiği, deb/rpm paketleri; amd64 ve arm64 | Docker imajı yok |
| Şifreleme | Tarayıcıda Argon2id, öğe başına AES-256-GCM, paylaşılan kasalar için X25519 | Web kasasının kodu sunucudan gelir (uzantılar kendi kodlarını getirir) |
| İstemciler | Web kasası (uygulama olarak kurulabilir), Chromium tarayıcıları ve Firefox için uzantılar, komut satırı | Yerel mobil uygulama yok, Safari uzantısı yok, çevrimdışı kopya yok |
| İçe aktarma | Şifresiz Bitwarden JSON veya CSV, ayrıca tarayıcılar, KeePass/KeePassXC, 1Password, LastPass, CSV | Başka programların şifreli dışa aktarmaları yok; dosyadan ekler, geçiş anahtarları veya parola geçmişi alınmaz |
| Oturum açma | Zorunlu ikinci faktör, güvenlik anahtarları ve geçiş anahtarları, LDAP / Active Directory, OIDC ve SAML | Uzantılar çoklu oturum açmayı kullanmaz |
| İşletim | SFTP kopyalı, şifreli günlük konsol yedeği; geri almalı, imzalı kendi kendine güncelleme | — |
Kurulum
PassZit, PostgreSQL veritabanlı tek bir programdır: passzit-server. Kurmanın dört yolu vardır, hepsi indirme sayfasında:
- VM imajı — Debian, PostgreSQL ve PassZit'i hazır olarak içeren OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM) veya VHDX (Hyper-V 1. nesil). VM konsolunda
pzadminkullanıcısı ağ, sunucu adı, saat dilimi, kurulum belirteci ve geri yüklemeler için bir menü alır. Yalnızca 22 ve 8443 portları açıktır. - Appliance ISO — yeni bir VM veya fiziksel sunucu için; gözetimsiz kurulum ilk diski siler.
- Debian 12+, Ubuntu 22.04+, AlmaLinux veya Rocky Linux 9+ üzerinde kurulum betiği:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh. Sürüm imzasını kontrol eder, PostgreSQL'i kurar, rastgele parolalı bir veritabanı oluşturur ve adresi ile kurulum belirtecini yazdırır.--dbmevcut bir PostgreSQL veritabanını kullanır. - Sağlamlaştırılmış bir systemd hizmetiyle paketler (deb, rpm);
/etc/passzit/server.enviçindePASSZIT_DBdeğerini ayarlayın vepasszit-server'ı başlatın.
README 2 vCPU, 2 GB RAM ve 16 GB disk ister. Konsol HTTPS 8443 portunda dinler ve siz Ayarlar → Ağ ve erişim altında başkalarına izin verene kadar yalnızca özel ağlara yanıt verir. Docker imajı yoktur; diğer her şeyi konteynerlerde çalıştırıyorsanız appliance imajıyla küçük bir VM kullanın. Adım adım sürüm Kendi sunucunuzda parola yöneticisi rehberindedir.
Şifreleme modeli
Güvenlik sayfasında ve deponun docs/ARCHITECTURE.md dosyasında anlatıldığı gibi:
- Tarayıcı, ana paroladan Argon2id ile bir ana anahtar türetir (varsayılan olarak 64 MiB, 3 geçiş; kasa politikası belleği, geçişleri ve şeritleri değiştirebilir).
- Bundan, sunucunun yalnızca argon2id özeti olarak sakladığı bir kimlik doğrulama anahtarı ve tarayıcıdan hiç çıkmayan, rastgele hesap anahtarını açan bir sarma anahtarı çıkar.
- Her öğe — ad, kullanıcı adı, parola, web siteleri, notlar, alanlar, klasör ve geçmiş — AES-256-GCM ile şifrelenir. Ekli dosyalar ve öğe belgeleri de tarayıcıda şifrelenir.
- Paylaşılan bir kasanın, her üyenin X25519 açık anahtarına mühürlenmiş kendi anahtarı vardır. PassZit biriyle ilk kez paylaştığınızda anahtar parmak izini gösterir ve onaylanmış bir anahtar değiştiğinde uyarır; biri kasadan ayrıldığında kasa yeni bir anahtar alır.
PassZit'in kendi ifadesiyle neye karşı koruma sağlamadığı: web kasasının JavaScript'i sunucunuzdan gelir, bu yüzden sunucuyu tamamen kontrol eden biri değiştirilmiş kod sunabilir; bir kasaya grup üzerinden katılan kişiler parmak izi onayı olmadan erişim alır; kullanıcının bilgisayarındaki kötü amaçlı yazılım yazılanları okuyabilir. Tarayıcı uzantıları, sunucunun değiştiremeyeceği kendi kodlarını getirir. Unutulmuş bir ana parolayı kimse sıfırlayamaz — kasayı yeniden yalnızca kullanıcının kurtarma anahtarı açar.
Tarayıcı uzantıları
PassZit uzantısı Chrome Web Store (Chrome, Brave, Opera, Vivaldi), Firefox Add-ons (Firefox 128 veya daha yenisi) ve Microsoft Edge Add-ons'ta bulunur; bağlantılar indirme sayfasında. Sunucu da onu web kasasındaki Tarayıcı uzantıları altında, kullanılan tarayıcının mağazası için Tek tıkla yükle ve elle kurulum için kendi paketleriyle sunar.
- Bağlanma: yalnızca sunucu adresini girin ve Web kasası ile bağla'ya tıklayın; web kasasında oturum açar ve orada onaylarsınız. Sunucu 8443 gibi kendi portunda çalışabilir. Tarayıcının güvendiği bir sertifikaya ihtiyaç duyar — uzantı yeni bir sunucunun kendinden imzalı sertifikasını reddeder (Ayarlar → Sertifika: kendinizinki veya Let's Encrypt).
- Doldurma: bir oturum bilgisi yalnızca kendi web sitesinde (Public Suffix List), yalnızca üst sayfanın görünür alanlarında önerilir, başka sitelerin çerçevelerinde asla; HTTPS için kaydedilmiş bir oturum bilgisi düz HTTP'de önerilmez. Tek kullanımlık kodlar onları isteyen sayfada doldurulur.
- Kaydetme: Yeni ve değişen giriş bilgilerini kaydetmeyi öner seçeneğini açtıktan sonra PassZit simgesi bir sayı gösterir; PassZit web sayfasının içinde hiçbir şey göstermez.
- Kartlar ve adresler ödeme ve teslimat formlarını doldurur — yalnızca boş alanları, yalnızca HTTPS sayfalarında, yalnızca üst sayfada ve bir kart için bir sorudan sonra.
- Tek kilit açma: aynı sunucunun web kasası ve uzantısı birlikte açılır ve kilitlenir. Windows Hello, Touch ID veya telefonun ekran kilidi web kasasını bir geçiş anahtarıyla (WebAuthn PRF) açabilir.
Mevcut olmayanlar: Safari için bir uzantı, uzantıda çoklu oturum açma (ana parola ve kimlik doğrulama koduyla oturum açar) ve bir ödeme sağlayıcısının çerçevesindeki ödeme alanlarına doldurma.
Bitwarden biçimindeki bir dışa aktarmayı içe aktarın
PassZit'in içe aktarıcısı şifresiz Bitwarden dışa aktarmasını .json veya .csv olarak okur. Şifreli bir dışa aktarma, şifresiz bir tane isteyen bir mesajla reddedilir. PassZit bir dosyayı onu oluşturan programa göre değil, içeriğine göre tanır: items listesi olan bir JSON dosyası Bitwarden biçimi olarak okunur.
- Mevcut programınızda şifresiz dışa aktarmayı oluşturun.
- PassZit web kasasında Araçlar → İçe aktar'ı seçin ve dosyayı belirleyin. Dosya tarayıcıda okunur; PassZit biçimi, öğe ve klasör sayısını ve kaçının zaten kasada olduğunu gösterir.
- Dosyadaki klasörleri koru'yu veya yeni bir klasörü seçin, Kasada zaten olan öğeleri atla'yı açık bırakın ve içe aktarın.
- Dışa aktarma dosyasını silin — tüm parolaları şifresiz içerir.
PassZit, Bitwarden JSON biçiminden web siteleri, tek kullanımlık kod sırları ve özel alanlarıyla oturum bilgilerini (gizli alanlar gizli kalır), güvenli notları, kartları, kimlikleri, SSH anahtarlarını, klasörleri ve sık kullanılanları alır. Alınmayanlar: ekli dosyalar (dışa aktarma dosyalarının parçası değildir — yeniden ekleyin), dosyada saklanan geçiş anahtarları (uzantıyla yeniden kaydedin), bir öğenin parola geçmişi ve klasörler dışındaki her türlü gruplama. Her kullanıcı kendi kasasına aktarır; bir ekip için öğeler daha sonra öğe düzenleyicisindeki Kasa alanıyla, birer birer taşınır. İçe ve dışa aktarmalar denetim günlüğüne öğe sayısıyla, ama asla içerikleri olmadan kaydedilir.
İkinci faktör, geçiş anahtarları ve tek kullanımlık kodlar
- Hesap oturumu: iki adımlı oturum açma her hesap için zorunludur — on kurtarma kodlu bir kimlik doğrulama uygulaması (TOTP). Hesabım → Güvenlik anahtarları ve geçiş anahtarları altında bir güvenlik anahtarı (YubiKey, Titan …) veya bir cihaz geçiş anahtarı web kasasında uygulama kodunun yerini alabilir; uzantılar yine uygulama kodunu kullanır. Bir yönetici kaybolan ikinci faktörü sıfırlayabilir; kasa bundan etkilenmez.
- Web sitesi geçiş anahtarları: Geçiş anahtarları için PassZit'i kullan açıkken bir web sitesi geçiş anahtarı oluşturduğunda uzantı PassZit'e kaydet'i önerir ve onu, uzantının bulunduğu her tarayıcıda kullanılabilen şifreli bir kasa öğesi olarak saklar. PassZit bir "user verified" bayrağı göndermez; bu yüzden doğrulama gerektiren bir web sitesi tarayıcının kendi geçiş anahtarlarını alır.
- Web siteleri için tek kullanımlık kodlar: bir oturum bilgisi, yapıştırılmış veya bir QR kodundan okunmuş Doğrulayıcı anahtarı (TOTP) tutabilir — web kasasında bir resimden, uzantıda Bu sayfadaki doğrulayıcı QR kodunu oku ile. Kasayı açan kişi bu durumda her iki faktöre de sahip olur; en önemli hesaplar için PassZit'in kılavuzu ayrı bir kimlik doğrulama uygulaması önerir.
Sunucunun yedekleri ve güncellemeleri
Ayarlar → Konsol yedeği her gün ve istek üzerine (Şimdi yedekle) /var/lib/passzit/backups klasörüne bir yedek yazar: tüm kasalarla birlikte veritabanı, sunucunun gizli anahtarı ve konsol sertifikası. Yedekler her zaman belirlediğiniz bir parola cümlesiyle şifrelenir ve her biri başka bir sunucudaki bir SFTP klasörüne kopyalanabilir. Appliance menüsüyle veya passzit-server -restore ile geri yükleyin; geri yükleme tüm veritabanını tek adımda değiştirir. Bunun yerine kendiniz yedekliyorsanız veritabanını ve secret.key dosyasını alın — ikinci faktörler gibi sunucunun kendi sırları ona ihtiyaç duyar.
Ayarlar → Güncellemeler ve sunucu yalnızca imzalı sürümleri kurar: veritabanını ve programı yedekler, güncellemeyi kurar ve sunucu geri gelmezse eski sürümü kendisi geri koyar. Seçilen bir saatte otomatik kurulum ve sürüm adayları için bir Testing kanalı orada ayarlanabilir.
Kullanıcılar kendi kasalarının bir kopyasını da tutabilir: Araçlar → Dışa aktar → Şifreli PassZit dosyası (önerilir), kendi seçtikleri bir parolayla korunur.
LDAP ve çoklu oturum açma
Ayarlar → Şirket oturum açması, kimin oturum açabileceğine ek kurallar getirir; ana parola her zaman kalır, çünkü kasanın anahtarıdır, ve hesaplar yine yalnızca davetle oluşur.
- Web kasası için OpenID Connect (Microsoft Entra ID, Google, Okta, Keycloak …) veya SAML 2.0 (ADFS, Entra ID, Okta …) ile Çoklu oturum açma.
- Active Directory / LDAP: her oturum açmada, uzantılar ve komut satırı dâhil, PassZit adresi bir hizmet hesabıyla arar; bulunmayan veya devre dışı hesaplar oturum açamaz. Ara ayarları test eder.
- Her ikisi de PassZit gruplarını aynı adlı şirket gruplarıyla eşitleyebilir; böylece paylaşılan kasalara erişim dizini izler.
SCIM ile hesap sağlama ve davetsiz kayıt yoktur. Paylaşılan kasaların, grupların ve yetkilerin nasıl çalıştığı Parolaları ekiple paylaşma rehberinde anlatılır.
PassZit'i mevcut sunucunuzun yanında test edin
- Mevcut sunucunuzu çalışır durumda tutun. PassZit appliance'ını kendi DNS adı olan küçük bir VM olarak içe aktarın ve uzantıyı denemeden önce ona güvenilir bir sertifika verin.
- Önce test hesapları kullanın. İki veya üç kişiyi davet edin, paylaşılan bir kasa ve bir grup oluşturun; yetkileri, parmak izi kontrolünü ve birini kasadan çıkarmayı deneyin.
- Her şeyi değil, bir kopyayı içe aktarın. Bir test hesabının şifresiz dışa aktarmasını oluşturun, içe aktarın, öğe sayılarını karşılaştırın ve birkaç kartı, kimliği, SSH anahtarını ve tek kullanımlık kodu kontrol edin. Dışa aktarma dosyasını silin.
- İki uzantıyı da yalnızca test ettiğiniz yerde kurun. PassZit'in oturum bilgilerini kaydetme önerisi siz açana kadar kapalıdır, Geçiş anahtarları için PassZit'i kullan da öyle; böylece karşılaştırırken iki uzantı aynı anda sormaz.
- Sunucunun yedeğini test edin. Şimdi yedekle'yi çalıştırın, yedeği ikinci bir test VM'ine geri yükleyin ve orada oturum açın.
- Aşağıdaki sınırları onu kullanacak kişilerle, özellikle mobil kullanım ve uzantının oturum açmasını, birlikte gözden geçirin.
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 mobil uygulama ve Safari uzantısı yok (ikisi de planlanıyor). Web kasası bir telefonun ana ekranına eklenebilir, ancak çevrimdışı kullanım için hiçbir şey saklamaz.
- Docker imajı yok; bir imaj, betik veya paketlerle kurun.
- İçe aktarıcı yalnızca şifresiz dışa aktarma dosyalarını okur; dosyadaki ekler, geçiş anahtarları ve parola geçmişi alınmaz.
- Uzantılar güvenilir bir sertifika ister ve çoklu oturum açmayla değil, ana parola ve kimlik doğrulama koduyla oturum açar.
- Kurtarma anahtarı olmadan unutulan bir ana parolayı kimse kurtaramaz.
- Arayüz 14 dildedir; yerleşik kullanıcı kılavuzu İngilizce ve Sırpçadır.
Sonraki adımlar
PassZit'i indirin, tüm özellikleri ve güvenlik modelini okuyun ya da Kendi sunucunuzda parola yöneticisi ve Parolaları ekiple paylaşma rehberleriyle başlayın. Barındırılan bir hizmetten geçen ekipler daha fazlasını Ekipler için self-hosted bir 1Password alternatifi rehberinde bulur. Sorularınızı GitHub Discussions'ta bekliyoruz (yalnızca İngilizce); şirketler MaxZit'ten ticari destek alabilir (yalnızca İngilizce).
Bitwarden, sahibinin ticari markasıdır; Vaultwarden bağımsız bir projenin adıdır. PassZit ve MaxZit bunların hiçbiriyle bağlantılı değildir, onlar tarafından desteklenmez ve onlarla hiçbir şekilde ilişkili değildir. Adlar burada yalnızca insanların ne aradığını ve PassZit'in hangi dışa aktarma biçimini içe aktarabildiğini anlatmak için kullanılmaktadır.