Concepts · Architecture

理解 WAFred 的两层职责。

控制面维护站点和策略;数据面 Agent 代理请求并执行安全检查。两者通过 gRPC 同步配置和遥测。

控制面 · Server数据面 · AgentgRPC
System map

组件与数据流

客户端流量进入 WAFred Agent 并转发到源站;控制面下发规则并接收 Agent 的日志、指标和状态。
业务请求流经 Agent;策略和遥测通过控制平面链路同步。
Control plane

控制面负责定义与协调

server 提供管理控制台、REST API 和 gRPC 服务,与 PostgreSQL 持久化配置。它管理站点、规则、Agent 注册信息和配置版本,并汇总 Agent 的状态与遥测数据。

Data plane

Agent 负责代理与判决

agent 连接控制面并接收站点策略。收到访客请求后,它匹配站点与路由、执行配置的安全检查,再将放行流量代理到上游。安全判决和请求记录随请求处理阶段产生。

Control channel

gRPC 传递策略与观测信息

控制面 → Agent

注册响应、策略包、站点配置与运行命令。

Agent → 控制面

心跳、节点和证书状态、日志与指标。

这一通道用于管理和遥测同步;HTTP/S 站点流量由 Agent 直接接收,不经过控制面转发。

Deployment shape

从合并进程到分布式节点

模式组成适用场景
all-in-oneserver 与本地 agent 组合单机试用与集中部署
serverREST、gRPC、控制台与数据库独立管理节点
agent数据面代理进程一个或多个流量入口

选择拓扑时,考虑流量入口、站点源站可达性、管理网络、Agent 到控制面的加密链路和故障恢复方式。

WAFred all-in-one 单机模式和 server 加多个 Agent 的分布式部署模式。
两种常见拓扑共享同一套控制面与数据面职责。
Further reading

相关资料