WAF 安全防护使用
OpenFlare WAF 使用可视化有向无环图编排规则。新建规则时只填写名称,系统创建默认的“开始 → 通过”图并进入编辑器。
节点与连线
- 开始:每条规则唯一,沿
next进入图。 - 通过:结束当前规则;若路由仍有后续规则则继续执行。
- 阻止:立即按配置的状态码和 HTML 响应终止请求。
- IP 匹配:配置 IP、CIDR 或 IP 组,分别连接
true、false。 - 地域匹配:按国家或 ISO 3166-2 一级行政区代码分支;国家列表同时显示中文名称与代码,行政区可按国家名、行政区名或代码搜索。Country 与 City MMDB 由磁盘文件提供(Docker 镜像会 COPY 到默认路径;裸二进制首次启动时按配置 URL 下载),并按配置周期更新。City MMDB 不可用时按未匹配处理。
- 攻击防护:选择攻击防护规则组。平衡或高强度规则命中时进入
false,其余请求进入true。 - 旧 PoW 节点:保留已有配置的兼容执行。新配置请使用独立的 PoW 防护;站点保存独立策略后,旧 PoW 节点自动沿
next跳过。
服务端会拒绝循环、悬空出口、不可达节点、重复端口连接和无效配置。保存时携带页面加载得到的 revision;发生 409 冲突时应重新加载,避免覆盖他人修改。
选中普通节点或连线后,可点击画布右上角的删除按钮,或按 Delete/Backspace 删除。删除节点会同时删除关联连线;唯一的“开始”和“通过”节点不可删除。拖动节点只在松开时记录最终坐标,不会在移动过程中反复重建画布状态。
右侧节点属性栏默认隐藏,点击节点后显示;点击连线或画布空白区域后自动收起。
编排区默认使用较紧凑的高度和较小的首次缩放比例,仍可通过滚轮或画布 Controls 自由缩放。
攻击防护规则组
- 在「安全性 → 攻击防护」新建规则组,为各检测类别选择禁用、仅观察、平衡防护或高强度防护。可批量设置后逐项调整。
- 在「安全性 → WAF」编辑流程,添加「攻击防护」节点并选择规则组。将
false连到「阻止」节点即可拦截,将true连到「通过」或后续节点。 - 启用流程并绑定到目标代理路由。更新规则组后,引用它的流程随站点快照自动同步。应用引用规则组的快照前,边缘节点需要升级到支持
zentinel-modsec的版本。
在「攻击防护」页打开「检测规则目录」,可按攻击类别筛选,或按规则 ID 和说明搜索。编辑规则组时,可从表单工具栏打开完整目录,也可点击某个类别的运行规则数量打开该类别的目录。
在规则目录中可设置单条规则的动作。「关闭」会跳过检测,「开启」命中时进入 false 分支,「记录」命中时写入攻击日志。仅命中记录或仅观察规则时,请求沿 true 分支执行。单条动作优先于类别等级,选择「沿用类别设置」可恢复继承。批量设置等级会保留逐条设置,所有改动随规则组一同保存。
例如,SQL 注入类别使用平衡防护时,可搜索 942100 并将其设为「记录」。保存后,这条规则的命中仍可在攻击日志中查看,同类别其他规则继续按其有效设置执行。节点需使用支持逐条设置的 Edge 版本才能应用含自定义规则的配置。
Edge 使用 zentinel-modsec 执行内置的 OWASP CRS 4.30.0 请求检测规则。平衡防护运行所选类别的 CRS PL1 规则,高强度防护运行 PL1 至 PL4,禁用时跳过该类别。仅观察同样运行 PL1 至 PL4,只有观察规则命中时,请求沿 true 分支执行。已有「安全防护」节点保留启用的检测类别,并按高强度执行。XML 外部实体和 ASP 代码注入继续使用 OpenFlare 补充规则。
规则检测覆盖请求 URI、参数及规则所用的请求头和 Cookie。请求体检查适用于长度已知且不超过 64 KiB 的请求,包括 JSON、表单、XML 和 multipart。规则组选择请求检测类别,最终处置由流程图连线决定。
- SSRF 使用 CRS 的服务端请求伪造规则,检测可疑的内部地址与协议。目录列出每条 CRS 规则的级别。
- CSRF 使用 OpenFlare 补充规则,检查携带 Cookie 的非安全方法请求。平衡防护检测跨源请求,高强度防护还检测缺少可验证来源的请求。依赖 Cookie 的合法跨源接口可以使用独立规则组。应用自身的 CSRF Token 仍由应用校验。
- 畸形 HTTP 协议 使用 CRS 协议规则,检测异常请求行、请求头、范围值和编码等。规则检查到达 WAF 流程的请求,代理在解析阶段直接拒绝的报文不会产生 WAF 命中记录。
已有规则组中的新类别默认禁用。启用 CSRF 或畸形 HTTP 协议检测前,需要先更新处理相关路由的 Edge 节点。
攻击日志
- 「攻击事件」默认按源 IP、域名和固定的 5 分钟时间窗口汇总拦截记录,可展开对应的单条日志。
- 两个标签页的筛选栏均显示源 IP、域名和动作。边缘节点、时间范围与自动刷新位于「更多筛选」,折叠时仍保留所选条件。
- 「日志记录」显示拦截与观察动作,可按源 IP、域名、边缘节点、动作和时间筛选。详情包含触发原因、WAF 流程、流程节点 ID 和攻击防护规则组。命中规则显示实际 CRS 规则 ID 及原始说明,OpenFlare 补充规则和历史日志沿用原有 ID。
- 「请求报文」在打开详情时加载,展示边缘节点解析后的请求行、查询参数和请求头。正文已被边缘节点读取时,可预览未压缩的 UTF-8 JSON、URL 编码表单和纯文本。常见凭据在记录前遮盖,单条报文预览最多保留 8 KiB。
- 报文沿用访问日志的上报、存储和保留策略。更新控制台和 Edge 节点后,新产生的拦截与观察记录可查看报文。历史记录保留原有详情。
绑定与生效
启用的全局规则固定最先执行;路由绑定的自定义规则严格按列表顺序执行。保存顺序后,规则随站点快照自动同步到 Pingora 节点。
在「安全性 → WAF」的规则组列表中,点击「应用范围」下的网站数量可查看绑定的网站。支持按站点名称或域名筛选,点击网站可进入对应代理规则的 WAF 设置。勾选一个或多个网站后,选择「解除绑定」可批量移除当前自定义规则组的引用。全局规则组适用于所有网站,应用范围提供查看和跳转。
IP 组成员是动态资源。节点通过配置清单比较摘要并更新运行中的内存快照。手动、订阅与自动 IP 组均可被 IP 匹配节点引用。单次完整 IP 组运行时快照最多 20 MiB;超过上限时同步会返回错误,并继续使用上一份有效快照。
在 任务管理 → 定时任务 中,OpenFlare WAF IP 组同步默认开启「隐藏任务成功日志」。任务最终失败时会在 任务日志 中保留执行详情。单个 IP 组的最近同步结果仍在 IP 组列表中查看。
[!IMPORTANT] 从旧固定黑白名单/地域/PoW 表单升级时,规则图会重置为“开始 → 通过”,旧策略字段不会迁移。请逐条重新编排并验证规则。
架构、图校验和失败回滚细节见 WAF 可编排规则设计。