pingap

What is Pingap

A reverse proxy like nginx, built on pingora, simple and efficient.

中文说明

Feature

• Filter location by host and path
• Path rewrite with regexp
• HTTP 1/2 end to end proxy
• TOML base configuration, file or etcd storage
• Graceful reload and auto restart after the configuration is changed
• Template for http access log
• Admin Web UI configuration
• Genrate TLS certificates from let's encrypt
• Notification events: lets_encrypt, backend_unhealthy, diff_config, restart, etc.
• Http proxy plugins: compression, static serve, limit, stats, mock, etc.

Start

Loads all configurations from /opt/proxy and run in the background. Log appends to /opt/proxy/pingap.log.

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

Graceful restart

Validate the configurations, send quit signal to pingap, then start a new process to handle all requests.

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

Config

All toml configurations are as follows pingap.toml.

Proxy step

graph TD;
    server("HTTP Server");
    locationA("Location A");
    locationB("Location B");
    locationPluginListA("Proxy Plugin List A");
    locationPluginListB("Proxy Plugin List B");
    upstreamA1("Upstream A1");
    upstreamA2("Upstream A2");
    upstreamB1("Upstream B1");
    upstreamB2("Upstream B2");
    locationResponsePluginListA("Response Plugin List A");
    locationResponsePluginListB("Response Plugin List B");

    start("New Request") --> server

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

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

    locationA -- "Exec Proxy Plugins" --> locationPluginListA

    locationB -- "Exec Proxy Plugins" --> locationPluginListB

    locationPluginListA -- "proxy pass: 10.0.0.1:8001" --> upstreamA1

    locationPluginListA -- "proxy pass: 10.0.0.2:8001" --> upstreamA2

    locationPluginListA -- "done" --> response

    locationPluginListB -- "proxy pass: 10.0.0.1:8002" --> upstreamB1

    locationPluginListB -- "proxy pass: 10.0.0.2:8002" --> upstreamB2

    locationPluginListB -- "done" --> response

    upstreamA1 -- "Exec Response Plugins" --> locationResponsePluginListA
    upstreamA2 -- "Exec Response Plugins" --> locationResponsePluginListA

    upstreamB1 -- "Exec Response Plugins" --> locationResponsePluginListB
    upstreamB2 -- "Exec Response Plugins" --> locationResponsePluginListB

    locationResponsePluginListA --> response
    locationResponsePluginListB --> response

    response("HTTP Response") --> stop("Logging");

Performance

CPU: M2, Thread: 1

wrk 'http://127.0.0.1:6188/stats' --latency
Running 10s test @ http://127.0.0.1:6188/stats
  2 threads and 10 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency    87.92us   60.91us   3.69ms   89.97%
    Req/Sec    57.32k     2.17k   69.69k    91.09%
  Latency Distribution
     50%   93.00us
     75%  100.00us
     90%  106.00us
     99%  133.00us
  1151171 requests in 10.10s, 320.61MB read
Requests/sec: 113977.63
Transfer/sec:     31.74MB

Rust version

Our current MSRV is 1.74

License

This project is Licensed under Apache License, Version 2.0.