单机 all-in-one 起步,按需拆分控制面与数据面
架构与运行模式

控制策略,执行流量。

WAFred 把配置管理和请求转发拆成清晰的数据边界。一个控制面管理站点和策略,一个或多个 Agent 在流量入口处执行规则。

客户端经过边缘 Agent 检查后到达源站;控制面与 Agent 通过 gRPC 同步策略和遥测数据。
控制面不承接站点的代理流量;真正的 HTTP/S 请求由数据面 Agent 转发。箭头动效表示请求和遥测方向。
展示 all-in-one 单机模式和 server 管理多个 Agent 的分布式模式。
从 all-in-one 开始,再按需要将 server 与 Agent 拆分部署。
Two planes

控制面与数据面

控制面 · Server

提供管理控制台、REST API 和 gRPC 服务;保存站点、策略、配置版本与集群状态。

数据面 · Agent

作为反向代理接收 HTTP/S 请求,执行站点策略、选择源站并回传日志和指标。

Agent 注册后从控制面获取身份和心跳周期。策略更新由控制面同步给 Agent;Agent 通过持久 gRPC 流报告状态和遥测。规则变更不要求逐台手工维护配置文件。

Request path

请求在边缘完成检查

  1. 客户端将请求发送到配置的 WAFred Agent 入口。
  2. Agent 按站点匹配 WAF、访问控制、限流等策略,并生成明确判决。
  3. 通过策略的请求根据路由与负载均衡规则转发到源站。
  4. 判决、请求日志和流量指标按配置回报控制面或存储后端。

控制面用于管理和观测;站点请求不需要先经过控制面再转到 Agent。

Run modes

三种运行模式,对应不同部署边界

模式包含组件常见用途
all-in-one控制面与数据面在一个进程内运行本地体验、单机和小规模部署
server控制台、REST API、gRPC 与数据库连接独立的集中管理节点
agent代理站点流量并连接远端控制面部署在流量入口或边缘节点

可从 all-in-one 评估,再按网络边界和流量入口拆分 server 与多个 agent。各节点间的网络和 TLS 配置应按部署环境明确设定。

Persistence & telemetry

配置与观测数据的去向

  • PostgreSQL 用于控制面数据与配置持久化。
  • 可配置 Elasticsearch 接收请求日志。
  • Agent 心跳携带节点状态、流量指标和站点证书状态。
  • Agent 可缓存规则,数据面与控制面暂时断开时遵循自身缓存与连接配置。
Network boundaries

部署前确认监听端口

端口用途开放位置
80 / 443数据面站点流量入口对需要保护的访客网络开放
9080控制台与 REST API按管理网络边界限制访问
9090Agent 连接控制面的 gRPC 端口仅允许受信任的 Agent 连接
Build your topology

用 Compose 启动单机环境。

先验证控制台、站点路由和 WAF 判决,再把 Agent 放到你需要的流量入口。