支持矩阵

macOS

Apple Silicon 安装使用 npm 包内置 DMG；Intel 版本会从 Release 下载并校验。首次打开需 Gatekeeper 确认（ad-hoc 签名，未公证）：右键 → 打开，或系统设置 → 隐私与安全性 → 仍要打开。安装前务必核对 SHA-256。

Windows

安装器下载固定校验和的 setup.exe 并静默运行；安装按机器级进行，需要 UAC 提权。SmartScreen 可能提示"未知发布者"，这是预览包未代码签名的预期行为——请用 SHA-256 清单交叉验证后继续。

Linux

AppImage 安装到 ~/.local/bin/Airlock.AppImage。无 FUSE 的发行版（部分容器/精简系统）使用 --appimage-extract-and-run 启动。deb 安装包同时随 Release 提供（sudo dpkg -i）。GPG 校验：

gpg --import Airlock-gpg-pubkey.asc
gpg --verify Airlock_0.1.8_amd64.AppImage.sig Airlock_0.1.8_amd64.AppImage

树莓派

• 64 位系统（Pi 4/5）：直接 npm install -g airlock-relay && airlock-installer install --open，使用 arm64 AppImage。
• 32 位系统（armv7/armhf）：GitHub 没有 armv7 构建机，需在设备端构建。克隆仓库后运行 bash scripts/build-armv7-desktop.sh [--upload]（依赖见脚本头部注释：Node.js、Rust、webkit2gtk 等）。构建出的 .deb 与 .AppImage 可上传到 Release。

验收与发布边界

macOS arm64/x64、Windows x64/x86/arm64 与 Linux x64/arm64 均已发布预览产物并通过维护者实机验收；Windows/Linux 未签名，Apple 未公证，因此不属于"已认证"发布。完整边界与发布前清单见仓库跨平台文档。

Support matrix

macOS

Apple Silicon uses the bundled DMG; Intel downloads and verifies the release DMG. First open requires Gatekeeper confirmation (ad-hoc, not notarized): right-click → Open, or System Settings → Privacy & Security → Open Anyway. Always verify the SHA-256 first.

Windows

The installer downloads the pinned setup.exe and runs it silently; installation is machine-wide and requires UAC. SmartScreen may flag the unsigned preview — cross-check the SHA-256 manifest before continuing.

Linux

AppImages install to ~/.local/bin/Airlock.AppImage. On FUSE-less distributions use --appimage-extract-and-run. deb packages also ship with the release (sudo dpkg -i). GPG verification:

gpg --import Airlock-gpg-pubkey.asc
gpg --verify Airlock_0.1.8_amd64.AppImage.sig Airlock_0.1.8_amd64.AppImage

Raspberry Pi

• 64-bit OS (Pi 4/5): install directly with npm install -g airlock-relay && airlock-installer install --open (arm64 AppImage).
• 32-bit OS (armv7/armhf): no hosted armv7 runner exists. Clone the repository on the Pi and run bash scripts/build-armv7-desktop.sh [--upload] (see the script header for dependencies). The resulting .deb and .AppImage can be uploaded to the release.

Acceptance and release boundary

macOS arm64/x64, Windows x64/x86/arm64, and Linux x64/arm64 publish preview artifacts that passed maintainer real-device acceptance; Windows/Linux are unsigned and macOS is not notarized, so they are not "certified" releases. See the repository cross-platform document for the full boundary and release checklist.

対応マトリクス

macOS

Apple Silicon は同梱 DMG、Intel は Release の DMG をダウンロード・検証して導入します。初回起動は Gatekeeper の確認が必要です（ad-hoc 署名・未公証）。SHA-256 を先に確認してください。

Windows

固定 checksum の setup.exe をダウンロードしてサイレント実行します。マシン単位のインストールのため UAC が必要です。SmartScreen の警告は未署名プレビューの想定内ですが、SHA-256 マニフェストで照合してください。

Linux

AppImage は ~/.local/bin/Airlock.AppImage にインストールされます。FUSE がない環境では --appimage-extract-and-run で起動します。deb パッケージも Release に同梱（sudo dpkg -i）。GPG 検証：

gpg --import Airlock-gpg-pubkey.asc
gpg --verify Airlock_0.1.8_amd64.AppImage.sig Airlock_0.1.8_amd64.AppImage

Raspberry Pi

• 64bit OS（Pi 4/5）：npm install -g airlock-relay && airlock-installer install --open で arm64 AppImage を導入。
• 32bit OS（armv7/armhf）：Pi 上でリポジトリを clone し bash scripts/build-armv7-desktop.sh [--upload] を実行（依存関係はスクリプト冒頭参照）。生成した .deb と .AppImage は Release にアップロードできます。

受入とリリース境界

macOS arm64/x64、Windows x64/x86/arm64、Linux x64/arm64 はプレビュー成果物として公開され、保守者の実機受入を通過しています。Windows/Linux は未署名、macOS は未公証のため「認定済み」ではありません。完全な境界はリポジトリのクロスプラットフォーム文書を参照してください。