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. 默认模块

代理手册

1. 代理链路#

启用接管后,流量链路如下:
公网用户 -> 服务器:80 -> iptables REDIRECT -> WAF:8080 -> 真实站点 127.0.0.1:80

2. 关键配置#

字段说明:
listen_addr:WAF 代理监听地址。
backend_addr:真实站点地址。
iptables_enable:是否接管入口端口。
iptables_port:入口端口,通常是 80。

3. iptables 规则#

系统启用接管后会创建 NAT 链:
ZHIYU_WAF_REDIRECT
典型规则:
查看:

4. 代理行为#

WAF 代理收到请求后会依次执行:
1.
解析 HTTP 请求。
2.
提取客户端 IP。
3.
检查黑白名单。
4.
执行规则引擎检测。
5.
执行 AI 检测。
6.
对首次访问非静态资源的客户端展示安全验证页。
7.
通过后转发到真实后端。

5. 静态资源处理#

以下资源类型默认跳过安全验证页:
.css .js .png .jpg .jpeg .gif .svg .ico .woff .woff2 .ttf .eot

6. HTTPS 说明#

当前代理主要面向 HTTP 入口。
生产 HTTPS 推荐部署方式:
公网用户 -> Nginx/SLB HTTPS -> WAF HTTP -> 后端 HTTP
或在云负载均衡层终止 TLS,再将 HTTP 转发给 WAF。

7. 常见验证命令#

8. 关闭接管#

服务关闭接管后会清理 ZHIYU_WAF_REDIRECT 链。
修改于 2026-05-21 11:23:00
上一页
项目说明
下一页
基础健康检查
Built with