智域 WAF 安装指南

系统要求

Linux (推荐 Ubuntu 20.04+ / CentOS 7+) 或 macOS

Go 1.21+ (源码编译)

Node.js 18+ (前端编译)

SQLite3 (默认) 或 MySQL 5.7+ / 8.0+

方式一：二进制安装

方式二：源码编译

仅编译后端（跳过前端，用于开发）：

前端开发模式（热更新）：

方式三：Docker

docker-compose.yml 示例

方式四：systemd 服务

初始配置

1. 首次访问

启动后访问 http://服务器IP:9090，系统会自动进入初始化向导，引导设置管理员密码。

2. 修改配置

编辑 configs/zhiyu-waf.yaml：

3. 配置域名（HTTPS）

方式一 — 手动证书：

方式二 — ACME 自动证书：

MySQL 配置（可选）

大流量生产环境推荐使用 MySQL：

首次启动会自动创建所需的数据库表。

验证安装

常见问题

端口被占用

权限问题

WAF 需要绑定低端口（如 80/443），需要 root 权限或设置：

iptables 配置

如果启用 iptables_enable，需要确保系统支持 iptables：

智域 WAF 安装指南

系统要求#

方式一：二进制安装#

方式二：源码编译#

方式三：Docker#

docker-compose.yml 示例#

方式四：systemd 服务#

初始配置#

1. 首次访问#

2. 修改配置#

3. 配置域名（HTTPS）#

MySQL 配置（可选）#

验证安装#

常见问题#

端口被占用#

权限问题#

iptables 配置#