Pingap-基于 pingora 开发的反向代理

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

这是一个创建于 259 天前的主题，其中的信息可能已经有所发展或是发生改变。

Pingap 是基于pingora开发的，pingora 提供了各类模块便于 rust 开发者使用，但并不方便非 rust 开发者使用，因此 pingap 提供了以 toml 的形式配置简单易用的反向代理，实现支持多 location 代理转发。特性如下：

支持多 location 配置，可通过请求的路径与域名筛选
支持静态文件目录处理，简单方便的 chunk 的形式响应静态文件
支持 mock 的响应配置，方便测试或应急使用
支持 HTTP1 与 HTTP2 两种协议
无中断请求的配置更新，方便实时更新应用配置
模板式的请求日志输出，可按模板指定各种输出

Pingap 处理流程

根据请求的路径选择对应的服务

Pingap 支持两种特别的服务类型，以及常规的反向代理服，具体如下：

Stats: 获取 Server 所对应的性能指标
Admin: 根据启动时指定的 admin 地址或者配置的admin path转发至对应的管理后台服务
其它: 常规的反向代理服务，根据域名与路径选择对应的转发节点

graph TD;
    start("新的请求")-->ServiceFilter{{请求服务筛选}};
    ServiceFilter--是否匹配 stats-->stats 的处理;
    ServiceFilter--是否匹配 admin-->admin 的处理;
    ServiceFilter--根据 host 与 path 选择对应的 Location-->Location 筛选处理;

Location 的处理逻辑

该 Server 下的所有 location 在初始化时根据权重按高至低排序，接受到请求时按顺序一个个匹配到符合的 location 为止，若无符合的则返回出错。根据符合的 location 重写 path(若无则不需要)，添加请求头(若无则不需要)，成功响应时添加响应头(若无则不需要)。

let header = session.req_header_mut();
let path = header.uri.path();
let host = header.uri.host().unwrap_or_default();

let (location_index, lo) = self
    .locations
    .iter()
    .enumerate()
    .find(|(_, item)| item.matched(host, path))
    .ok_or_else(|| pingora::Error::new_str(LOCATION_NOT_FOUND))?;

Location 的详细说明