Http Filter 介绍 on Apache Dubbo

Dubbo HttpFilter 介绍

Mon, 01 Jan 0001 00:00:00 +0000

使用 HTTP 调用 Dubbo

定义Pixiu配置文件

static_resources:
 listeners:
 - name: "http-listener"
 protocol_type: "HTTP"
 address:
 socket_address:
 address: "0.0.0.0"
 port: 8888
 filter_chains:
 filters:
 - name: dgp.filter.httpconnectionmanager
 config:
 route_config:
 routes:
 - match:
 prefix: "*"
 http_filters:
 - name: dgp.filter.http.dubboproxy
 config:
 dubboProxyConfig:
 auto_resolve: true
 registries:
 "zookeeper":
 protocol: "zookeeper"
 timeout: "3s"
 address: "127.0.0.1:2181"
 username: ""
 password: ""
 timeout_config:
 connect_timeout: 5s
 request_timeout: 5s
 clusters:
 - name: "dubbo-server"
 lb_policy: "lb"
 endpoints:
 - id: 1
 socket_address:
 address: 127.0.0.1
 port: 20000
 shutdown_config:
 timeout: "60s"
 step_timeout: "10s"
 reject_policy: "immediacy"

准备Dubbo服务

启动zookeeper,需要提前准备好docker和compose，如果本地有的话可以忽略

docker-compose.yml

docker-compose -f {CURRENT_PATH}/dubbo-go-pixiu-samples/dubbohttpproxy/docker/docker-compose.yml && docker-compose up -d

启动 Dubbo Server

Run

Metric 介绍

Mon, 01 Jan 0001 00:00:00 +0000

指标上报过滤器 (dgp.filter.http.metric)

概述

dgp.filter.http.metric 过滤器为 Pixiu 网关提供统一的指标上报功能。它整合了之前的两个过滤器（dgp.filter.http.metric 和 dgp.filter.http.prometheusmetric）的功能，并支持 Pull 和 Push 两种模式，集成了 OpenTelemetry。

注意：此过滤器默认使用 Push 模式。如需使用 Pull 模式，请在配置中显式指定 mode: "pull"。

核心特性

统一入口：单个过滤器支持 Pull 和 Push 两种模式
OpenTelemetry 集成：Pull 模式使用 OpenTelemetry（与 Pixiu Tracing 保持一致）
Context 扩展：其他过滤器可通过 HttpContext.RecordMetric() 记录自定义指标
向后兼容：复用原有过滤器的逻辑

模式说明

Pull 模式（推荐）

指标通过 HTTP 端点暴露，供 Prometheus 抓取。

特点：

使用 OpenTelemetry SDK
指标通过全局 HTTP 端点暴露
Prometheus 标准拉取模型
支持来自 Context 的动态自定义指标

适用场景：

长期运行的服务
Kubernetes 环境
开发和测试环境

Push 模式

指标主动推送到 Prometheus Push Gateway。

Opa 介绍

Mon, 01 Jan 0001 00:00:00 +0000

OPA 过滤器 (dgp.filter.http.opa)

中文

概述

dgp.filter.http.opa 过滤器通过 Rego 策略将授权决策委托给 Open Policy Agent (OPA)。该过滤器评估每个 HTTP 请求并根据 Rego 策略决定是否允许或拒绝请求。策略通过内联 Rego 模块加载，并使用 OPA 的内置查询引擎进行评估。

实际行为

从配置项 policy 读取 Rego 模块源码字符串。
从配置项 entrypoint 读取 Rego 查询字符串。
每次请求构造 input 对象（见下），并评估该查询。
如果查询结果为 true，则放行请求；否则拒绝请求。

目前过滤器不支持：外部文件或 URI 加载、自定义拒绝状态码或返回自定义错误体等。

配置结构

将过滤器添加到 HTTP 连接管理器的 http_filters 列表中：

filters:
 - name: dgp.filter.httpconnectionmanager
 config:
 route_config:
 # ... 你的路由
 http_filters:
 - name: dgp.filter.http.opa
 config:
 policy: |
 package http.authz

 default allow = false

 allow {
 input.method == "GET"
 input.path == "/status"
 } 
 entrypoint: "data.http.authz.allow"
 # HTTP proxy 过滤器应该在OPA 过滤器之后
 - name: dgp.filter.http.proxy
 config:
 	# ... proxy config

字段说明

policy（字符串，必填）
- 含义： Rego 模块源码（内联字符串）。通过 rego.Module("policy.rego", policy) 加载。
- 数据类型： string（建议使用 YAML 多行格式 |）。
- 说明： 当前版本不支持外部文件路径或 bundle URI。
entrypoint（字符串，必填）
- 含义： 传给 rego.Query(...) 的 Rego 查询字符串，应为合法查询，如 data.<package>.<rule>（如 data.http.authz.allow）。
- 数据类型： string。

判定约定

如果查询结果集合非空且首个表达式值为 true，则请求放行。
否则（空结果或值≠true），请求被拒绝。

策略输入（`input`）

过滤器将 HTTP 请求转换为以下键值对（与当前实现一致，策略编写时请进行空值检查）：

RateLimiter 介绍

Mon, 01 Jan 0001 00:00:00 +0000

欢迎认领补充此文档。

断路器介绍

Mon, 01 Jan 0001 00:00:00 +0000

欢迎认领补充此文档。

Http Filter 介绍 on Apache Dubbo

Dubbo HttpFilter 介绍

使用 HTTP 调用 Dubbo

定义Pixiu配置文件

准备Dubbo服务

启动zookeeper,需要提前准备好docker和compose，如果本地有的话可以忽略

启动 Dubbo Server

Metric 介绍

指标上报过滤器 (dgp.filter.http.metric)

概述

核心特性

模式说明

Pull 模式（推荐）

Push 模式

Opa 介绍

OPA 过滤器 (dgp.filter.http.opa)

中文

概述

实际行为

配置结构

字段说明

判定约定

策略输入（input）

RateLimiter 介绍

断路器介绍

策略输入（`input`）