默认模块
复制页面
智域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
默认模块
复制页面
项目说明
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 接管
8080
WAF 代理监听
9090
Dashboard 管理后台
生产注意事项
#
管理后台建议只对可信 IP 开放。
首次部署后立即修改管理员密码。
jwt_secret
必须使用随机强密钥。
打开 iptables 接管前先确认后端业务地址可用。
SSH 白名单成功登录不会记录,失败登录仍记录。
修改于
2026-05-21 11:24:25
上一页
智域 WAF 配置参考
下一页
代理手册