PassZit

PassZit のダウンロード

各リンクは GitHub の最新リリースを指します。リリースは署名済みで、サーバーも同じリリースから自動更新されます。

サーバーのインストール方法を選ぶ

方法向いている用途必要なもの
1. 既製の VM イメージインポートして起動、サインイン。Debian、PostgreSQL、PassZit が準備済みVMware、VirtualBox、Proxmox/KVM、Hyper-V
2. アプライアンス ISO新しい VM や物理サーバーへ無人インストールインストール中のインターネット接続
3. インストールスクリプト既存の Debian、Ubuntu、AlmaLinux、Rocky Linux サーバーroot 権限とインターネット接続
4. パッケージを手動で独自の PostgreSQL、構成管理ツールリリースの deb または rpm パッケージ

サーバーには 2 vCPU、2 GB RAM、16 GB のディスクが必要です。ブラウザーは TCP 8443 で接続します。ブラウザー拡張機能のためには、名前とブラウザーが信頼する証明書が必要です。PassZit は Let's Encrypt から取得するか、お手持ちの証明書を使います(設定 → 証明書)。

1. 既製の VM イメージ

OVA

VMware ESXi、Workstation、VirtualBox

passzit-appliance.ova

ESXi Host Client:Create / Register VM → Deploy a virtual machine from an OVF or OVA file。vSphere:Deploy OVF Template。

QC

Proxmox VE と KVM

passzit-appliance.qcow2

ディスクなしの VM(2 vCPU、2 GB RAM、VirtIO ネットワーク)を作成し、ディスクをインポートして SCSI ブートディスクとして接続します。

VHD

Hyper-V(第 1 世代)

passzit-appliance-vhdx.zip

展開し、2 GB RAM の第 1 世代 VM を作成して、VHDX をディスクとして選びます。

Proxmox VE では、イメージをノードにコピーしたあと:

qm importdisk <vmid> passzit-appliance.qcow2 local-lvm

VM を起動すると、画面にコンソールのアドレスとセットアップトークンが表示されます。https://<アドレス>:8443 を開き、自己署名証明書を一度だけ受け入れ、トークンを入力して、2 要素サインインを設定した最初の管理者を作成します。VM の画面で pzadmin としてサインインすると(初期パスワードは passzit、初回サインイン時に変更)、メニューからネットワーク、サーバー名、タイムゾーンの設定、セットアップトークンの表示、バックアップの復元ができます。開いているのはポート 22(SSH)と 8443 だけです。

2. アプライアンス ISO

passzit-appliance.iso — これで VM やサーバーを起動します。5 秒後に無人インストールが始まり、最初のディスクを消去して、ネットワークから Debian、PostgreSQL、PassZit をインストールし、最後にコンソールのアドレスとセットアップトークンを表示します。

3. インストールスクリプト

Debian 12+、Ubuntu 22.04+、AlmaLinux / Rocky Linux 9+(x86-64 または ARM64)で、root として実行します:

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

スクリプトは PostgreSQL をインストールし、最新リリースをダウンロードして署名を検証し、ランダムなパスワードでデータベースを作成し、サービスを起動して、アドレスとセットアップトークンを表示します。もう一度実行するとアップデートされます。オプション(パイプで渡す場合は sh -s -- を付けます):--version X、--db postgres://…、--no-auto-updates(OS の自動セキュリティ更新を有効にしない)、--source URL。先に内容を確認するには:

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

4. パッケージとその他のファイル

sudo apt install ./passzit-server_X_amd64.deb      # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm   # AlmaLinux, Rocky Linux

/etc/passzit/server.env で PASSZIT_DB を設定し、systemctl start passzit-server を実行します。セットアップトークンは /var/lib/passzit/setup-token.txt にあります。以下のファイルは名前にバージョンを含み、リリースページに掲載されています:

ファイル内容
passzit-server_X_amd64.deb、_arm64.deb、.rpm手動インストール用のサーバー(x86-64 と ARM64)
passzit-extension-chromium-X.zip、-firefox-X.zip手動インストール用のブラウザー拡張機能(下記参照)
passzit-cli-X-linux-amd64、-windows-amd64.exe、-darwin-arm64 …Linux、Windows、macOS 用の passzit コマンドライン
passzit-helper-X-linux-amd64、-arm64Linux で拡張機能からリモート接続を開きます。Windows では MaxZit Launcher が担当します(サーバーの Launcher ページからダウンロード)
SHA256SUMSプログラムとパッケージのチェックサム
SHA256SUMS-applianceVM イメージと ISO のチェックサム

ブラウザー拡張機能

拡張機能は Chrome、Edge、Opera、Brave、Vivaldi、Firefox でログイン情報を入力・保存します。ブラウザーのストアからインストールすれば、自動で最新の状態に保たれます:

PassZit サーバーからも同じものを入手できます。Web 保管庫のメニューにあるブラウザー拡張機能から、お使いのブラウザーのストアへ移動したり、サーバーと同じバージョンのパッケージを手動インストール用に入手したりできます。その後 PassZit のアイコンをクリックし、サーバーのアドレスを入力して Web 保管庫で接続 を選びます。拡張機能でパスワードを入力する必要はありません。

ダウンロードの検証

sha256sum -c SHA256SUMS --ignore-missing             # プログラムとパッケージ
sha256sum -c SHA256SUMS-appliance --ignore-missing   # OVA、QCOW2、VHDX zip、ISO

サーバーとインストールスクリプトは、何かをインストールする前に署名済みのリリースマニフェストを検証します。セキュリティを参照してください。

アップデート

設定 → アップデートとサーバーでは、稼働中と最新のバージョンが表示され、アップデートをインストールできます。指定した時刻に自動で行うことも可能です。インストールされるのは PassZit のリリース鍵で署名されたリリースだけです。サーバーは事前にデータベースとプログラムをバックアップし、新しいバージョンが起動しなければ元に戻します。Testing チャネルはテストサーバー向けにリリース候補を提供します。設定 → コンソールのバックアップは、新しいマシンへの復元のために、データベース、サーバーの秘密鍵、証明書の暗号化バックアップを毎日保存します。