動作確認済 (試験マトリクス)
release 前に各 distro で install → nginx -t pass → plugin load → admin healthz=200 → challenge 配信 (http=403) までを通しています:
| distro | package | nginx (試験 version) | status |
| AlmaLinux 10 / Rocky 10 / RHEL 10 | rpm | 1.26.3 | verified |
| AlmaLinux 9 / Rocky 9 / RHEL 9 | rpm | 1.20.1 | verified |
| AlmaLinux 8 / Rocky 8 / RHEL 8 | rpm | 1.14.1 | verified |
| CentOS 7 / RHEL 7 (EOL 2024-06) | rpm | 1.20.1 (EPEL) | verified |
| CentOS 6 / RHEL 6 (EOL 2020-11) | rpm | 1.10.3 (EPEL) | verified |
| Debian 13 | deb | 1.26.3 | verified |
| Debian 12 | deb | 1.22.1 | verified |
| Ubuntu 26.04 | deb | 1.28.3 | verified |
| Ubuntu 24.04 | deb | 1.24.0 | verified |
| Ubuntu 22.04 | deb | 1.18.0 | verified |
| Alpine 3.x | apk | 1.26.3 | verified |
同じパッケージ形式の distro (install を試せる)
rpm / deb / apk を使う派生 distro では install が通ることが多いものの、 CI には組み込めていないため動作は未確定です。動いた / 動かない両方の報告を歓迎します —
issue tracker までどうぞ:
| distro | format | 備考 |
| openSUSE Leap / Tumbleweed | rpm | パッケージ系統は同じ。SELinux ではなく AppArmor 環境 (confinement は別途調整が必要かも) |
| Fedora | rpm | RHEL 系統。SELinux postinstall (setsebool 自動) の対象 |
| Linux Mint | deb | Ubuntu / Debian 派生 |
| Pop!_OS | deb | Ubuntu 派生 |
| Devuan | deb | Debian 派生 (systemd 非依存)。openrc / sysvinit 用 init script 同梱 |
| Raspbian / Raspberry Pi OS | deb (arm64) | 64-bit OS なら arm64 パッケージで動作 (native plugin も arm64 同梱) |
現時点で非対応
以下は配布物・互換性の制約で動かないため、install を試す意味はありません:
| 環境 | 理由 |
| Arch Linux | pacman .pkg.tar.zst 形式。AUR パッケージを作っていない (contributor welcome) |
| Gentoo | portage ebuild。同上。 |
| NixOS | nix derivation。flake / nixpkgs での提供は将来の候補。 |
| FreeBSD / OpenBSD | pkg(8)。BSD の nginx ABI 向けに別途ビルドが必要。 |
| macOS | 本番のサーバー OS ではないため対象外 (Linux コンテナでの開発は docker run で可能)。 |
| Windows / WSL | nginx の Windows 版は ABI が非互換です。WSL 内の Linux distro は対応 distro と同じ手順で動きます。 |
architecture
unmask は x86_64 (amd64) と aarch64 (arm64) の両方をサポートしています。各 distro のパッケージ (main / nginx plugin / web 統合) を両 arch 向けにビルドし、実機 (Ampere arm64) で native + forward-auth + JA4 抽出まで検証済みです。