サーバーのインストール方法を選ぶ
| 方法 | 向いている用途 | 必要なもの |
|---|---|---|
| 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 イメージ
VMware ESXi、Workstation、VirtualBox
ESXi Host Client:Create / Register VM → Deploy a virtual machine from an OVF or OVA file。vSphere:Deploy OVF Template。
Proxmox VE と KVM
ディスクなしの VM(2 vCPU、2 GB RAM、VirtIO ネットワーク)を作成し、ディスクをインポートして SCSI ブートディスクとして接続します。
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、-arm64 | Linux で拡張機能からリモート接続を開きます。Windows では MaxZit Launcher が担当します(サーバーの Launcher ページからダウンロード) |
| SHA256SUMS | プログラムとパッケージのチェックサム |
| SHA256SUMS-appliance | VM イメージと ISO のチェックサム |
ブラウザー拡張機能
拡張機能は Chrome、Edge、Opera、Brave、Vivaldi、Firefox でログイン情報を入力・保存します。ブラウザーのストアからインストールすれば、自動で最新の状態に保たれます:
Chrome Web Store
Chrome、Brave、Opera、Vivaldi。
Firefox Add-ons
Firefox 128 以降。
Microsoft Edge Add-ons
Microsoft Edge。
PassZit サーバーからも同じものを入手できます。Web 保管庫のメニューにあるブラウザー拡張機能から、お使いのブラウザーのストアへ移動したり、サーバーと同じバージョンのパッケージを手動インストール用に入手したりできます。その後 PassZit のアイコンをクリックし、サーバーのアドレスを入力して Web 保管庫で接続 を選びます。拡張機能でパスワードを入力する必要はありません。
ダウンロードの検証
sha256sum -c SHA256SUMS --ignore-missing # プログラムとパッケージ
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA、QCOW2、VHDX zip、ISO
サーバーとインストールスクリプトは、何かをインストールする前に署名済みのリリースマニフェストを検証します。セキュリティを参照してください。
アップデート
設定 → アップデートとサーバーでは、稼働中と最新のバージョンが表示され、アップデートをインストールできます。指定した時刻に自動で行うことも可能です。インストールされるのは PassZit のリリース鍵で署名されたリリースだけです。サーバーは事前にデータベースとプログラムをバックアップし、新しいバージョンが起動しなければ元に戻します。Testing チャネルはテストサーバー向けにリリース候補を提供します。設定 → コンソールのバックアップは、新しいマシンへの復元のために、データベース、サーバーの秘密鍵、証明書の暗号化バックアップを毎日保存します。