PassZit

チームのためにセルフホスト型パスワード管理を導入する

空の仮想マシンから、チームがブラウザーでログイン情報を自動入力できるようになるまでのステップ ガイドです。PassZit のインストール、最初の管理者の作成、同僚の招待、ブラウザー拡張機能の接続、古いパスワードの移行、そしてサーバーのバックアップと更新までを扱います。

このガイドの内容

PassZit は、自社サーバーで動く無料・オープンソース(AGPLv3)のパスワード管理です。ユーザーごとにエンドツーエンド暗号化された保管庫があり、ログイン情報、ワンタイムコード、セキュアノート、カード、SSH キー、ファイルを保存できます。チームでは、人ごとの権限を付けて保管庫を共有します。サーバーが保存するのは暗号文だけです。「セルフホストの Bitwarden 代替」を探してツールを比較している方に向けて、PassZit の導入と展開が実際にどう進むかを示します。

必要なもの

  • VMware、VirtualBox、Proxmox VE/KVM、Hyper-V 上の仮想マシンまたは物理サーバー(2 vCPU、2 GB RAM、16 GB ディスク)——あるいは既存の 64 ビット Debian 12+、Ubuntu 22.04+、AlmaLinux、Rocky Linux 9+ サーバー(x86-64 または ARM64)。
  • ブラウザーは TCP 8443 でサーバーに接続します。PostgreSQL はインストール スクリプトとイメージが設定します。
  • ブラウザー拡張機能用に、サーバーの DNS 名とブラウザーが信頼する証明書(下記参照)。
  • 任意で SMTP サーバー。PassZit が招待や通知をメールで送れるようになります。

サーバーのインストール

方法は 4 つあり、すべてダウンロード ページにあります。どのリリースも署名されています。

方法向いている用途
VM イメージ:OVA(VMware、VirtualBox)、QCOW2(Proxmox VE、KVM)、VHDX(Hyper-V 第 1 世代)インポートして起動し、サインインするだけ——Debian、PostgreSQL、PassZit が準備済み
アプライアンス ISO新しい VM または物理サーバー。無人インストールは最初のディスクを消去します
インストール スクリプト既存の Debian、Ubuntu、AlmaLinux、Rocky Linux サーバー
パッケージ(deb、rpm;amd64、arm64)独自の PostgreSQL と構成管理

VM イメージまたは ISO:VM を起動すると、画面にコンソールのアドレスとセットアップトークンが表示されます。VM のコンソールでは pzadmin でサインインできます(初期パスワード passzit、初回サインイン時に変更)。メニューでネットワーク、サーバー名、タイムゾーンを設定し、トークンを再表示し、バックアップを復元できます。開いているポートは 22(SSH)と 8443 だけです。

インストール スクリプト:サーバー上で root として実行します。

curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh

スクリプトは PostgreSQL をインストールし、最新リリースをダウンロードして署名を確認し、ランダムなパスワードでデータベースを作成し、サービスを起動して、アドレスとセットアップトークンを表示します。--version、--db(既存の PostgreSQL データベース)、--no-auto-updates などのオプションは sh -s -- で渡します。

パッケージ:deb または rpm をインストールし、/etc/passzit/server.env に PASSZIT_DB を設定して systemctl start passzit-server を実行します。セットアップトークンは /var/lib/passzit/setup-token.txt にあります。

最初のサインインと最初の管理者

  1. https://<サーバー>:8443 を開きます。新しいサーバーは自己署名証明書を使うため、ブラウザーが一度警告します。受け入れてください。
  2. セットアップトークン、メールアドレス、マスターパスワードを入力します。ブラウザーがあなたの鍵を作成します(1 秒ほど)。この最初のアカウントが管理者になります。
  3. 認証アプリ(Microsoft Authenticator、Google Authenticator、Authy、2FAS など)で QR コードを読み取ります。2 段階サインインはすべてのアカウントで必須です。10 個のリカバリーコードを保管してください。各コードは 1 回だけアプリの代わりになります。
  4. リカバリーキーを作成し(下記参照)、新しいアイテムで最初のログイン情報を追加します。

後からマイアカウントで、セキュリティキー(YubiKey など)やデバイスのパスキーを第 2 要素として追加できます。

ブラウザーが信頼する証明書

ブラウザー拡張機能は自己署名証明書を拒否するため、拡張機能を展開する前にサーバーへ正式な証明書を設定してください。設定 → 証明書で証明書(社内 CA のものや購入したもの。中間証明書と秘密鍵を含む PEM)をアップロードするか、Let's Encrypt を選びます。Let's Encrypt には公開 DNS 名が必要で、サーバーのポート 80 か Cloudflare の DNS レコードで確認します。後者は社内ネットワークからしか届かないサーバーでも使えます。証明書は再起動なしで即座に使われます。社内 DNS でその名前がサーバーを指すようにしてください。

チームを招待する

アカウントは招待でのみ作成されます。ユーザー → ユーザーを招待でメールアドレスとロール(ユーザーまたは管理者)を入力します。PassZit は招待リンクを一度だけ表示するので、本人に送ってください。リンクは 1 回限りで、既定では 7 日間有効です。設定 → メールで SMTP サーバーを設定していれば、招待をメールでも送信するにチェックを入れると PassZit が代わりに送信します。

招待された人は、あなたと同じようにマスターパスワードを決め、2 段階サインインを設定します。管理者はユーザーの無効化、紛失した第 2 要素のリセット、未使用の招待の取り消しができます。パスワードを共有するには、共有保管庫を作成して個人やグループにアクセス権を与えます。

会社のアカウントは設定 → 会社のサインインで接続します。OpenID Connect または SAML 2.0 によるシングル サインオンと、Active Directory / LDAP に対応しています。マスターパスワードは保管庫の鍵なので、常に残ります。

マスターパスワードとリカバリーキー

マスターパスワードはユーザーのブラウザーから外に出ません。これがエンドツーエンド暗号化の要点であり、その結果として、マスターパスワードかリカバリーキーがなければ、管理者も MaxZit も、誰も保管庫を開けません。管理者はマスターパスワードを見ることもリセットすることもできません。

  • ランダムな 4~6 語のパスフレーズは覚えやすく、推測されにくいものです。保管庫ポリシーで最小の長さ(既定 12 文字)が決まります。
  • マイアカウントのリカバリーキーを作成は、32 文字の英数字のキーを一度だけ表示します。印刷するか書き留めて、オフラインで保管してください。保管庫の中や電話のそばには置かないでください。
  • マスターパスワードを忘れたユーザーは、リカバリーキーと認証アプリのコードを使い、サインイン ページで新しいマスターパスワードを設定します。リカバリーキーがなければ保管庫は失われ、管理者にできるのはアカウントを削除して空の保管庫で再招待することだけです。ユーザー一覧で、誰がリカバリーキーを作成済みかを確認できます。

初日に全員にリカバリーキーを作成してもらいましょう。

ブラウザー拡張機能のインストール

拡張機能は、ログイン情報とワンタイムコードをそれが属するサイトでのみ入力し、新しいログインや変更されたログインの保存を提案し、支払いフォームと配送フォームにカードと住所を入力し、パスワードを生成します。ブラウザーのストアからインストールすれば、ストアが最新に保ちます。

  • Chrome Web Store——Chrome、Brave、Opera、Vivaldi
  • Firefox Add-ons——Firefox 128 以降
  • Microsoft Edge Add-ons——Microsoft Edge

リンクはダウンロード ページにあります。PassZit サーバーからも同じことができます。Web 保管庫のメニューにあるブラウザー拡張機能には、お使いのブラウザーのストアへのワンクリックでインストールと、手動インストール用のサーバー自身のバージョンのパッケージが表示されます。

  1. PassZit アイコンをクリックし、サーバーのアドレスだけを入力して(例:https://vault.example.com)、Web 保管庫で接続をクリックします。PassZit がそのサーバーと通信することをブラウザーで許可します。アドレスに :8443 のようなポートを含めても、Firefox を含むどのブラウザーでも動作します。
  2. Web 保管庫が開きます。まだサインインしていなければ、そこでサインインします。
  3. 保管庫がこのブラウザーで拡張機能を接続するか尋ねるので、接続をクリックします。拡張機能にパスワードやコードを入力する必要はありません。

Web 保管庫と拡張機能はロック解除を共有します。一方を解除すればもう一方も開き、一方をロックすれば両方がロックされます。

他のプログラムからパスワードをインポート

各ユーザーが自分の保管庫にインポートします。まず元のプログラムからエクスポートし、保管庫でツール → インポートを選んでファイルを指定します。PassZit は形式を認識し、見つかったアイテムとフォルダーの数、すでに保管庫にある数を表示し、ファイルのフォルダーを維持するか、重複をスキップするかを選べます。

移行元エクスポート方法
Chrome、Edge、Brave、Opera、VivaldiPassword manager → Settings → Export passwords (CSV)
Firefoxabout:logins → … → Export passwords (CSV)
SafariFile → Export → Passwords (CSV)
BitwardenTools → Export vault → .json または .csv(暗号化形式ではないもの)
KeePass 2 / KeePassXCKeePass XML (2.x) / CSV または XML
1PasswordFile → Export → CSV
LastPassAdvanced options → Export (CSV)

ファイルはブラウザー内で読み込まれ、サーバーは暗号化されたアイテムだけを受け取ります。ログイン情報、ノート、Web サイト、独自フィールド、フォルダー、お気に入り、TOTP シークレットが取り込まれます(Bitwarden からはカード、ID、SSH キーも)。添付ファイルはこれらのエクスポートに含まれません。インポート後はエクスポート ファイルを削除してください——パスワードが暗号化されずに入っています。

暗号化のしくみ

ブラウザーはマスターパスワードから Argon2id(64 MiB、3 パス)でマスター鍵を導出します。そこから 2 つの鍵が作られます。サインイン時に送られる認証鍵(サーバーはその argon2id ハッシュだけを保存)と、ユーザーのランダムなアカウント鍵を開くラップ鍵です。各アイテムは名前、ユーザー名、Web サイト、ノートも含め、保管庫の鍵で AES-256-GCM により暗号化されます。共有保管庫には独自の鍵があり、各メンバーの X25519 鍵に対して封印されます。サーバーが見るのは暗号文、ID、サイズ、タイムスタンプだけで、マスターパスワードや利用可能な鍵を見ることはありません。詳しくはセキュリティ ページとリポジトリの docs/ARCHITECTURE.md をご覧ください。

サーバーのバックアップ

設定 → コンソールのバックアップは毎日(今すぐバックアップで随時も)/var/lib/passzit/backups にバックアップを書き込みます。内容は全保管庫を含むデータベース、サーバーの秘密鍵、コンソール証明書で、新しいサーバーに必要なものがすべて揃います。バックアップは常に設定したパスフレーズで暗号化されるので、パスフレーズは別の場所に保管してください。各バックアップは別サーバーの SFTP フォルダーにもコピーできます。復元はアプライアンスのメニューで行うか、サービスを停止してコンソール内のガイドの説明どおり passzit-server -restore を実行します。

アップデート

設定 → アップデートとサーバーには、実行中のバージョンと最新バージョンが表示されます。インストール時には署名を再確認し、データベースとプログラムをバックアップし、更新をインストールしてサーバーが復帰したかを確認します。復帰しなければ、旧バージョンとデータベースを自動で戻します。指定した時刻の自動インストールもここで有効にできます。安定版チャンネルは正式リリースを受け取り、Testing はテスト サーバー向けにリリース候補も提供します。スクリプトでインストールした場合は、スクリプトを再実行しても PassZit が更新され、データはすべて保持されます。

知っておくべき制限

  • PassZit は活発に開発中です。最初の公開リリース 0.9.0 は 2026 年 11 月で、新しいバージョンが頻繁に出ています。
  • ネイティブのモバイル アプリはありません。スマートフォンでは Web 保管庫をホーム画面に追加して専用ウィンドウで開けますが、オフライン用には何も保存されません。サーバーがなければ「offline」ページが表示されます。
  • リカバリーキーなしで忘れたマスターパスワードは、誰にも復旧できません。
  • ブラウザー拡張機能には信頼された証明書が必要で、サインインはマスターパスワードと認証コードで行います。シングル サインオンは使えません。
  • あらゆる Web 保管庫と同様、Web 保管庫の JavaScript はサーバーから配信されるため、完全に侵害されたサーバーは改変されたコードを配信できてしまいます。拡張機能は独自のコードを持っています。
  • Docker イメージはありません。イメージ、スクリプト、パッケージのいずれかでインストールしてください。コンソール内のガイドは英語とセルビア語です。

次のステップ

PassZit をダウンロードし、共有保管庫、シークレット リンク、緊急アクセス、リモート接続、コマンドラインなどすべての機能をご覧になるか、コンソールに組み込まれたガイド(ドキュメント)をお読みください。チーム用の共有保管庫の設定方法は、ガイド「チームでパスワードを共有する」で説明しています。ご質問は GitHub Discussions へどうぞ。企業向けには MaxZit が有償サポートを提供しています(英語のみ)。