Skip to Content
OpenFlare
使用指南安装部署技术参考架构设计更新日志

WAF 设计

OpenFlare WAF 的现行规则模型是可视化 DAG。节点语义、图约束、多规则顺序、发布编译与迁移边界统一以 WAF 可编排规则设计 为准。

系统边界

Server 保存带坐标和修订号的编辑图,发布时再次校验并编译为紧凑运行图;Agent 原子写入快照并 reload OpenResty;请求热路径只遍历 Worker 内存中的不可变图。

Worker 初始化时预计算全局规则与站点的有序执行列表、图节点数量和 UA 匹配集合,并编译规则中的 IP 匹配器。请求按站点直接查找执行列表,不再扫描全部规则和绑定。WAF 与 PoW 共用 IP 匹配模块,支持 IPv4、IPv6 与 CIDR;二进制地址有效时直接采用匹配结果,只有输入不可用时才回退字符串匹配。

IP 组独立于规则拓扑更新。手动、订阅和自动 IP 组由控制面维护,Agent 先原子替换 JSON、最后更新 checksum。协调 Worker 每 5 秒检查 checksum,仅变化时读取完整快照并分发给其它 Worker;失败时保留上一份有效数据。完整运行时快照上限为 20 MiB,Server 发布/同步与 Agent 落盘使用同一序列化校验;OpenResty 使用独立的 64 MiB 共享字典和非淘汰写入,容量不足时拒绝新版本而不破坏已提交快照。

各 Worker 在采用新 IP 组快照前编译启用组的匹配器,使更新后的首个业务请求不再承担名单编译成本。默认渲染不再分配已无用途的 10 MiB 观测字典,也不再为每个请求调用空的观测日志脚本;访问明细仍由 Nginx access log 采集。

地域节点使用 Country 与 City MMDB。Docker 镜像内置数据库文件,裸二进制安装由 Agent 首次启动时下载缺失文件,后续按配置周期更新,请求处理始终读取 OpenResty 已加载的数据库。数据库不可用时地域匹配返回 false 并限频告警,不允许因数据损坏意外放行其它执行错误。

安全顺序

启用的全局规则固定前置;路由规则按绑定 sequence 执行。阻止节点立即终止,通过节点仅结束当前规则,全部规则通过后才进入回源链路。未知节点、缺失出口或步数超限一律阻止请求。

本页目录