1. 默认模块
智域WAF
  • 默认模块
    • 你的网站，真的安全吗？我做了一个开源 AI WAF
    • 智域 WAF 安装指南
    • 智域 WAF 使用手册
    • 智域 WAF 配置参考
    • 项目说明
    • 代理手册
  • ZHIYU-WAF V2 Control Plane API
    • Public
      • 基础健康检查
      • Prometheus 指标
    • Authentication
      • 控制台登录并获取 JWT
      • 修改当前已登录用户密码
      • 查询首次初始化状态
      • 设置首次初始化管理员密码
      • 应用首次安装配置
    • Dashboard
      • 获取 V2 安全概览
      • 获取 V2 时间序列
      • 获取 V2 控制面运行状态
      • 获取认证后的详细健康状态
      • 获取兼容统计数据
      • 获取兼容统计时间序列
    • Security Events
      • 查询 V2 风险事件
      • 获取单个 V2 风险事件
      • 列出当前生效的本地封禁 IP
      • 手动封禁 IP
      • 解除手动或风险驱动封禁
    • Attack Logs
      • 查询攻击日志
      • 导出攻击日志
      • 获取单条攻击日志
      • 标记攻击日志已复核
      • 标记攻击日志为误报
      • 攻击日志 WebSocket 流
    • Audit
      • 查询控制台审计事件
    • Rules
      • 列出检测规则
      • 创建检测规则
      • 测试单个正则表达式
      • 预览规则对模拟请求的匹配结果
      • 更新检测规则
      • 删除检测规则
    • Access Control
      • 查询 IP 黑白名单
      • 添加 IP 或 CIDR 条目
      • 批量导入 IP 黑白名单
      • 导出 IP 黑白名单 CSV
      • 删除 IP 条目
      • 列出地理封锁规则
      • 创建地理封锁规则
      • 更新地理封锁规则
      • 删除地理封锁规则
    • Threat Intelligence
      • 获取威胁情报状态
      • 触发威胁情报同步
      • 保存威胁情报 API Key
    • Sites
      • 列出 V2 代理站点
      • 创建 V2 代理站点
      • 更新 V2 代理站点
      • 删除 V2 代理站点
    • AI
      • 获取 AI 提供商与全局策略配置
      • 更新 AI 提供商连接配置
      • 更新 AI 全局策略
      • 测试当前 AI 提供商连通性
      • 获取 AI 检测统计
      • 获取本地 AI 用量计数
      • 列出 AI 规则建议
      • 将 AI 建议提升为检测规则
      • 根据自然语言生成检测规则建议
      • 获取攻击威胁画像
    • SSH Monitoring
      • 获取 SSH 监控统计
      • 查询 SSH 监控事件
    • Settings
      • 获取本地设置键值
      • 保存本地设置
      • 受控重载本地配置
    • Backup
      • 导出本地控制面备份
      • 导入本地控制面备份
    • Certificates
      • 扫描可用 TLS 证书
      • 重新加载 TLS 证书
    • Users
      • 列出控制台用户
      • 创建控制台用户
      • 删除控制台用户
      • 重置指定用户密码
    • 数据模型
      • ApiError
      • V2Envelope
      • V2ErrorEnvelope
      • HealthResponse
      • LoginRequest
      • TokenResponse
      • ChangePasswordRequest
      • StatusResponseBody
      • SetupApplyRequest
      • V2SystemStatus
      • V2Site
      • V2SiteInput
      • SecurityEvent
      • SecurityEventPage
      • CreateBlockedIPRequest
      • BlockedIP
      • AttackLog
      • AttackLogPage
      • AuditEvent
      • AuditEventPage
      • Rule
      • RuleInput
      • IPEntry
      • IPEntryInput
      • GeoRule
      • GeoRuleInput
      • AIConfiguration
      • AIGlobalUpdate
      • AITestResponse
      • Settings
      • BackupData
      • Certificate
      • User
      • CreateUserRequest
  1. 默认模块

智域 WAF 使用手册

快速开始#

1.
安装并启动 WAF（参见 安装指南）
2.
浏览器访问 http://服务器IP:9090
3.
首次访问进入初始化向导，设置管理员密码
4.
登录后进入仪表盘

仪表盘#

仪表盘展示实时安全概览：
总请求数 — 代理处理的请求总量
拦截次数 — 被 WAF 拦截的攻击请求
攻击趋势图 — 按时间维度展示攻击走势
攻击来源地区 — 按地理分布统计
Top 攻击路径 — 被攻击最多的 URL 路径
攻击类型分布 — SQL 注入、XSS、命令注入等分类统计

规则管理#

查看规则#

导航到「规则管理」页面，可查看所有规则列表，包括规则名称、严重级别、启用状态。

创建规则#

点击「新建规则」，填写：
名称 — 规则的描述性名称
严重级别 — low / medium / high / critical
匹配位置 — 选择检测位置：URL、请求头、请求体、查询参数等
匹配模式 — 正则表达式或关键字（每行一个）
示例 — 拦截 SQL 注入：
(\bunion\b.*\bselect\b)
(\bselect\b.*\bfrom\b.*\bwhere\b)
'.*\bor\b.*'.*=

测试规则#

在规则详情页点击「测试」，输入测试请求内容，系统会模拟检测并显示是否命中。

观察模式#

在设置中开启「观察模式」，所有规则仅记录不拦截，适合新规则上线前的验证阶段。

IP 管理#

黑名单#

被加入黑名单的 IP 将被直接拒绝，返回 403。

白名单#

白名单 IP 会跳过所有规则检测，直接放行。

单个添加#

在 IP 管理页面，输入 IP 地址（支持 CIDR 格式如 10.0.0.0/8），选择黑白名单，添加备注。

批量导入#

点击「批量导入」，在文本框中每行输入一个 IP，格式：
192.168.1.100 攻击者
10.0.0.0/8 内网段
172.16.0.1
IP 后可跟空格和备注文字。

导出#

点击「导出」按钮，将当前 IP 列表导出为 CSV 文件。

地理围栏#

基于 IP 地理位置进行访问控制：
1.
导航到「地理围栏」
2.
选择国家/地区
3.
设置动作：block（拦截）或 allow（放行）
4.
生效后，来自该地区的 IP 将按规则处理

攻击日志#

查看日志#

「攻击日志」页面展示所有被检测到的攻击记录：
时间、来源 IP、请求方法和路径
命中的规则名称和严重级别
攻击来源（规则引擎 / AI 分析）

过滤#

支持按以下条件过滤：
来源 IP
严重级别
检测来源（规则 / AI）
时间范围

标记#

标记为已审核 — 确认处理
标记为误报 — 该记录不计入统计，并反馈给规则引擎

导出#

点击「导出」，选择 CSV 或 JSON 格式，可导出当前过滤条件下的所有日志。

实时监控#

WebSocket 实时流：
ws://服务器IP:9090/api/v1/logs/stream?token=JWT_TOKEN

用户管理#

管理员可以创建和管理多个用户账户。

角色说明#

角色权限
admin完整管理权限，包括用户管理
operator规则、IP、日志等操作权限，不能管理用户
viewer只读权限，可查看日志和统计

创建用户#

1.
导航到「设置」→「用户管理」
2.
点击「新建用户」
3.
填写用户名、密码（至少 12 位）、选择角色

备份与恢复#

导出备份#

1.
导航到「设置」→「备份」
2.
点击「导出配置」
3.
系统会下载一个 JSON 文件，包含：规则、IP 列表、站点、地理围栏、系统设置
敏感信息（密码哈希、许可证等）不会包含在导出文件中。

导入备份#

1.
点击「导入配置」
2.
选择之前导出的 JSON 文件
3.
系统会导入所有数据，已存在的记录会跳过
4.
导入完成后自动触发规则重载

审计日志#

审计日志记录所有管理操作：
用户登录/登出
规则创建/修改/删除
IP 添加/移除
配置变更
备份导入/导出
支持按操作者和时间范围过滤。

设置#

基本设置#

动态防护 — 开启后会对 HTML 响应进行变换，增加爬虫难度
观察模式 — 规则仅记录不拦截
日志保留天数 — 自动清理过期日志

AI 设置#

启用/禁用 AI 分析
选择 AI 提供商 — OpenAI / Claude
API Key 配置
熔断策略 — AI 服务故障时的降级策略

告警设置#

启用告警 — 高危攻击触发通知
Webhook URL — 接收 JSON 格式告警
邮件通知 — 通过 SMTP 发送告警邮件
去重间隔 — 防止同类告警重复发送

常用操作#

重载配置#

修改配置文件后，点击「设置」→「重载配置」或执行：

重置密码#

如忘记管理员密码，删除数据库中的密码设置后重启，系统会再次进入初始化向导：

查看系统状态#

修改于 2026-05-21 11:19:55
上一页
智域 WAF 安装指南
下一页
智域 WAF 配置参考
Built with