下载与安装
两种安装方式，按你的环境选择即可。脚本会自动获取最新镜像并完成部署，无外部依赖。
环境要求
- Linux 发行版（Debian / Ubuntu / CentOS / RHEL / Rocky / 银河麒麟 / 统信 UOS 等）
- 架构：amd64 或 arm64
- 内核 ≥ 4.18（启用 HTTP/3 / QUIC 建议 ≥ 5.4）
- root 或具备
sudo权限的账户 - 已安装
curl、docker≥ 20.10、docker compose
方式 1 · 一键安装脚本（推荐）
脚本会自动检测 Docker 与系统环境，下载并启动最新版本。安装完成后可通过 foxwaf CLI 管理服务。
curl -fsSL https://server.foxwaf.cn/install.sh | bash
提示：默认面板地址为
http://<服务器 IP>:8088/fox，初始账号 fox / fox，请登录后立即修改密码。
方式 2 · Docker Compose
已有 Docker 环境时，可手动获取镜像与 docker-compose.yaml 后部署：
mkdir -p /data/foxwaf && cd /data/foxwaf
curl -fsSLO https://server.foxwaf.cn/release/latest/docker-compose.yaml
docker compose up -d
各历史版本目录均包含完整的 docker-compose.yaml、镜像 tar 包及校验文件，可在
版本发布 页选取。
常用 CLI 命令
安装完成后可使用 foxwaf 管理服务：
| 命令 | 说明 |
|---|---|
foxwaf status | 查看运行状态、版本、CPU / 内存、端口监听 |
foxwaf logs | 实时跟踪运行日志 |
foxwaf restart | 平滑重启服务，配置变更立即生效 |
foxwaf update | 按 GitCode / GitHub / 官方镜像源优先级检查并安装新版本 |
foxwaf export | 打包配置 / 数据库 / 证书 / 插件至 backup/ 目录 |
foxwaf import <file> | 从备份文件恢复（省略路径时取 backup/ 下最新一份） |
foxwaf reset-auth | 重置 Web 控制台登录用户 / 密码，无需重启 |
校验与升级
每个版本目录均提供 waf、source.enc.md5、foxwaf-image.tar.gz.md5。下载后可手动校验：
md5sum -c waf
在线升级：CLI 会从配置的镜像源（GitHub / GitCode）按优先级尝试拉取，全部失败时自动回退至官方直链。
foxwaf update