部署 & 安装

详细介绍 CheeseWAF 的部署方案及安装过程,包括 Linux、Docker、Windows 或 macOS 系统。

CheeseWAF 支持以系统服务、容器编排或单二进制运行于各类主流操作系统。根据生产或测试环境的实际架构,选择对应的安装方式:

可选择集中式应用根目录或标准 FHS 布局,并配置 systemd 与独立运行用户。

使用 Docker Compose 部署,支持只读根文件系统与非 root 安全运行。

支持单文件 CLI、便携 Zip 包及 NSIS 安装程序,附带本地控制器。

提供 DMG 图形应用与 tar.gz 命令行分发包。

发行包列表与发布策略

从正式稳定版(v0.3.9+)起,CheeseWAF 遵循**服务器优先(Server-First)**发布策略:稳定 Release 默认优先分发经 Sigstore 签名校验与 SBOM 物料清单认证的 Linux 服务器架构发行包;Windows 与 macOS 桌面版作为可选的操作端构建产物提供。

可前往 GitHub Releases 下载官方发布的预编译包:

发行文件名目标平台与架构
cheesewaf-amd64-linux-*.tar.gzLinux x86_64 架构
cheesewaf-arm64-linux-*.tar.gzLinux ARM64 架构
cheesewaf-loong64-linux-*.tar.gzLinux LoongArch(龙芯)架构
cheesewaf-amd64-darwin-*.tar.gz / .dmgmacOS Intel 架构
cheesewaf-arm64-darwin-*.tar.gz / .dmgmacOS Apple Silicon 架构
cheesewaf-amd64-windows-*.exeWindows x86_64 单文件可执行程序
cheesewaf-arm64-windows-*.exeWindows ARM64 单文件可执行程序
cheesewaf-amd64-windows-*.zipWindows x86_64 便携压缩包
cheesewaf-arm64-windows-*.zipWindows ARM64 便携压缩包
cheesewaf-amd64-windows-*-setup.exeWindows x86_64 NSIS 图形安装向导
cheesewaf-arm64-windows-*-setup.exeWindows ARM64 NSIS 图形安装向导

安装完成后,请继续参考 快速上手 完成系统初始化与站点接入。

小型主机建议使用轻量档:逻辑核数不超过 2 或内存不超过 2 GB 时,初始化向导会推荐 low。探测超时、取消或请求失败也会回退到 low。程序配置的安全默认值仍是 127.0.0.1:9443;官方 Linux 一键安装器会明确启用公网 HTTPS 引导,并要求管理员保管一次性 Token 与安全入口。storage.profile: production 在完整生产接线完成前会拒绝启动,不会静默回退到 SQLite。

Linux 部署(systemd)

通过一键脚本或离线发行包安装 CheeseWAF,并完成公网 HTTPS 管理入口与一次性初始化。

Docker Compose 部署

使用 Docker Compose 编排部署 CheeseWAF,支持容器只读根文件系统与非 root 安全运行。

Windows 部署

Windows 环境下的三种运行方式:单文件 CLI、便携 Zip 包与 NSIS 图形安装器,以及原生系统服务与本地控制器说明。

macOS 部署

使用 DMG 镜像安装 CheeseWAF 桌面应用,或使用 tar.gz 压缩包以命令行方式运行。