| description |
|---|
Pingap 简述 |
Pingap是基于pingora开发的，pingora提供了各类模块便于rust开发者使用，但并不方便非rust开发者使用，因此pingap提供了以toml的形式配置简单易用的反向代理，单服务支持多location转发，通过插件的形式支持更多的需求场景。特性如下：
- 支持多location配置，可通过请求的路径与域名匹配
- 支持HTTP1与HTTP2两种协议
- 部分配置(location, upstream)支持热更新，其它为无中断请求的配置重启更新，方便实时更新应用配置
- 模板式的请求日志输出，可按模板指定各种输出
- 提供Web界面式的配置，简化操作
- 可通过let's encrypt自动生成https证书
- 可配置各种事件通过，如：lets_encrypt, backend_status, diff_config, restart等等
- 支持各种插件形式，根据需要灵活配置各种特性：如静态文件目录、服务性能指标、WEB后台配置应用等
该Server下的所有location在初始化时根据权重按高至低排序，接收到请求时按顺序一个个匹配到符合的location为止，若无符合的则返回出错。在选择对应的location之后，判断是否有配置重写path(若无则不需要)，添加请求头(若无则不需要)。
let mut location_index = None;
let mut location = None;
let header = session.req_header_mut();
let host = util::get_host(header).unwrap_or_default();
if let Some(locations) = get_server_locations(&self.name) {
let path = header.uri.path();
for (index, name) in locations.iter().enumerate() {
if let Some(lo) = get_location(name) {
if lo.matched(host, path) {
location = Some(lo);
location_index = Some(index);
break;
}
}
}
}Pingap的插件主要分为两类，请求前或响应后的处理，提供压缩、缓存、认证等各种不同场景的应用需求。插件是添加至location的，可根据不同需求参数配置各种不同的插件后，在location添加对应的插件，实现不同的功能组合。
Upstream的逻辑比较简单，在匹配location后，根据该location配置的upstream节点列表，按算法选择可用节点，并将请求转发至该节点即可。需要注意，插件也可配置在proxy_upstream_filter转发至upstream之前执行，可按需配置对应的插件。
现在日志是按server来配置，因此该server下的所有location共用，已支持各种不同的占位符，按需配置不同的访问日志输出。