Skip to content

Latest commit

 

History

History
162 lines (115 loc) · 5.36 KB

README_zh.md

File metadata and controls

162 lines (115 loc) · 5.36 KB
Raw

pingap

Pingap是类似于nginx的反向代理，基于pingora构建，简单而高效。

Sentry与opentelemetry为可选的特性，在全功能版本中支持。

例子

文档

flowchart LR
  internet("互联网") -- 客户端请求 --> pingap["Pingap"]
  pingap -- 转发:pingap.io/api/* --> apiUpstream["10.1.1.1,10.1.1.2"]
  pingap -- 转发:cdn.pingap.io --> cdnUpstream["10.1.2.1,10.1.2.2"]
  pingap -- 转发:pingap.io --> upstream["10.1.3.1,10.1.3.2"]
Loading

特性

  • 服务支持配置多个Location，通过host与path筛选对应的location，按权重逐一匹配选择
  • 支持正则形式配置重写Path，方便应用按前缀区分转发
  • 支持透明代理形式转发
  • HTTP 1/2 的全链路支持，包括h2c的支持
  • 支持静态配置、DNS以及docker label的三种服务发现形式
  • 支持grpc-web反向代理
  • 基于TOML格式的配置，配置方式非常简洁，可保存至文件或etcd
  • 支持10多个Prometheus指标，可以使用pull与push的形式收集相关指标
  • Opentelemetry支持w3c context trace与jaeger trace的形式
  • 频繁更新的Upstream与Location相关配置调整准实时生效(30秒)，其它应用配置更新后，无中断式的优雅重启程序
  • 访问日志的模板化配置，已支30多个相关属性的配置，可按需指定输出各种参数与指标
  • WEB形式的管理后台界面，无需学习，简单易用
  • 开箱即用的let's encrypttls证书，仅需配置对应域名即可
  • 不同域名的tls证书可使用在同一服务端口中，按servername自动选择匹配证书
  • 支持各种事件的推送：lets_encrypt, backend_status, diff_config, restart等等
  • 丰富的http插件，如高效的缓存服务组件、多种压缩算法的压缩组件、不同种类的认证组件、不同形式的限流组件等等
  • 提供了不同阶段的统计数据，如upstream_connect_time, upstream_processing_time, compression_time, cache_lookup_time 与 cache_lock_time等

启用程序

从 /opt/pingap/conf目录中加载所有配置，并以后台程序的形式运行，日志写入至/opt/pingap/pingap.log。

RUST_LOG=INFO pingap -c=/opt/pingap/conf -d --log=/opt/pingap/pingap.log

优雅重启

校验配置是否正确后，发送信号给pingap并启动新的程序接收原有的请求。

RUST_LOG=INFO pingap -c=/opt/pingap/conf -t \
  && pkill -SIGQUIT pingap \
  && RUST_LOG=INFO pingap -c=/opt/pingap/conf -d -u --log=/opt/pingap/pingap.log

自动重启

应用启动后，监听相关配置变化，若有变化则无中断式重启程序或热更新加载配置。autoreload参数表示如果只是upstream与location的配置变化，则准实时(30秒内)刷新对应配置生效，无需重启。

RUST_LOG=INFO pingap -c=/opt/pingap/conf \
  -a -d --autoreload --log=/opt/pingap/pingap.log

应用配置

[upstreams.charts]
addrs = ["127.0.0.1:5000"]

[locations.lo]
upstream = "charts"
path = "/"

[servers.test]
addr = "0.0.0.0:6188"
locations = ["lo"]

所有的应用配置可查阅说明： pingap.toml。

请求处理流程

graph TD;
    server["HTTP服务"];
    locationA["Location A"];
    locationB["Location B"];
    locationPluginListA["转发插件列表A"];
    locationPluginListB["转发插件列表B"];
    upstreamA1["上游服务A1"];
    upstreamA2["上游服务A2"];
    upstreamB1["上游服务B1"];
    upstreamB2["上游服务B2"];
    locationResponsePluginListA["响应插件列表A"];
    locationResponsePluginListB["响应插件列表B"];

    start("新的请求") --> server

    server -- "host:HostA, Path:/api/*" --> locationA

    server -- "Path:/rest/*"--> locationB

    locationA -- "顺序执行转发插件" --> locationPluginListA

    locationB -- "顺序执行转发插件" --> locationPluginListB

    locationPluginListA -- "转发至: 10.0.0.1:8001" --> upstreamA1

    locationPluginListA -- "转发至: 10.0.0.2:8001" --> upstreamA2

    locationPluginListA -- "处理完成" --> response

    locationPluginListB -- "转发至: 10.0.0.1:8002" --> upstreamB1

    locationPluginListB -- "转发至: 10.0.0.2:8002" --> upstreamB2

    locationPluginListB -- "处理完成" --> response

    upstreamA1 -- "顺序执行响应插件" --> locationResponsePluginListA
    upstreamA2 -- "顺序执行响应插件" --> locationResponsePluginListA

    upstreamB1 -- "顺序执行响应插件" --> locationResponsePluginListB
    upstreamB2 -- "顺序执行响应插件" --> locationResponsePluginListB

    locationResponsePluginListA --> response
    locationResponsePluginListB --> response

    response["HTTP响应"] --> stop("日志记录");
Loading

性能测试

CPU: M4 Pro, Thread: 1

wrk 'http://127.0.0.1:6100/ping' --latency

Running 10s test @ http://127.0.0.1:6100/ping
  2 threads and 10 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency    59.87us   20.27us   1.00ms   81.00%
    Req/Sec    82.12k     3.04k   85.77k    90.59%
  Latency Distribution
     50%   63.00us
     75%   69.00us
     90%   76.00us
     99%   97.00us
  1650275 requests in 10.10s, 215.61MB read
Requests/sec: 163396.17
Transfer/sec:     21.35MB

最低支持rust版本

最低支持的rust版本为1.74

开源协议

This project is Licensed under Apache License, Version 2.0.