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

项目说明

ZhiYu-WAF 专业版是一个面向服务器与 Web 站点防护的统一安全系统。
系统不是“前后端分离部署”的两套服务,而是一个集成系统:
Go 后端提供代理、防护、检测、日志、Dashboard API。
Vue 前端构建后由 Go Dashboard 直接托管。
SQLite 存储配置、规则、攻击日志、SSH 事件和 IP 黑白名单。
iptables 可接管业务入口端口,将流量引入 WAF 代理。

核心能力#

Web 流量透明代理。
iptables 自动接管入口流量。
SQL 注入、XSS、命令注入、路径穿越等规则检测。
企业规则扩展:扫描器、WebShell、SSRF、SSTI、反序列化、Log4Shell 等。
AI 检测能力,支持 OpenAI 兼容接口与 Claude。
攻击日志、地区聚合、实时 WebSocket 事件。
SSH 登录监控、暴力破解封禁、白名单策略。
IP 黑名单、白名单管理。
Dashboard 管理后台。

设计原则#

低侵入:业务站点仍运行在原端口,WAF 通过 iptables 接管。
可回滚:关闭 iptables_enable 即可恢复直接访问。
可扩展:规则 YAML 化,支持热重载。
可观测:攻击日志、SSH 日志和状态统计统一展示。

端口说明#

端口用途
80业务入口,被 WAF 接管
8080WAF 代理监听
9090Dashboard 管理后台

生产注意事项#

管理后台建议只对可信 IP 开放。
首次部署后立即修改管理员密码。
jwt_secret 必须使用随机强密钥。
打开 iptables 接管前先确认后端业务地址可用。
SSH 白名单成功登录不会记录,失败登录仍记录。
修改于 2026-05-21 11:24:25
上一页
智域 WAF 配置参考
下一页
代理手册
Built with