How it-nilesh/pingora works
Pingora is a Rust framework for programmable network services, especially HTTP reverse proxies. A request arrives through a configured server/listener, is handled as an HTTP session, and—when proxy logic is used—is routed to an upstream and returned to the client. The workspace also provides protocol/TLS implementations, load-balancing extensions, caching, connection pooling, limits, and observability integrations. Some links below are documented capabilities rather than inspected call sites; those are marked dashed where source-level wiring was not shown.
Main entry points: lib.rs Proxy Engine · server.rs HTTP Session · services Services · listeners Listeners
Components 21
Server Runtime
- Server Setup
pingora-core/src/server/configuration - Listeners
pingora-core/src/listeners - Services
pingora-core/src/services - HTTP Application
pingora-core/src/apps/http_app.rs - Async Runtime
pingora-runtime/src/lib.rs
Network Protocols
- HTTP Session
pingora-core/src/protocols/http/server.rs - HTTP/1
pingora-core/src/protocols/http/v1/server.rs - HTTP/2
pingora-core/src/protocols/http/v2/server.rs - Upstream Client
pingora-core/src/protocols/http/client.rs - TLS
pingora-core/src/protocols/tls
Proxy and Routing
- Proxy Engine
pingora-proxy/src/lib.rs - Proxy Modes
pingora-proxy/src/proxy_h1.rs - Proxy Cache
pingora-proxy/src/proxy_cache.rs - Load Balancer
pingora-load-balancing/src/lib.rs
State and Resilience
- Connection Pool
pingora-pool/src/connection.rs - Cache Storage
pingora-cache/src/storage.rs - Memory Cache
pingora-memory-cache/src/lib.rs - Request Limits
pingora-limits/src/rate.rs
Integrations
- Telemetry
pingora-foundations/src/lib.rs - Prometheus
pingora-prometheus/src/lib.rs
Other components
- Client
Connections 21
- Client → Listeners: opens connection
- Server Setup → Services: configures
- Services → Listeners: accepts traffic
- Listeners → HTTP Application: dispatches
- HTTP Application → HTTP Session: serves session
- HTTP Session → HTTP/1: dispatches
pingora-core/src/protocols/http/server.rs - HTTP Session → HTTP/2: dispatches
pingora-core/src/protocols/http/server.rs - HTTP Session → Proxy Engine: supports proxying
- Proxy Engine → Proxy Modes: delegates
pingora-proxy/src/lib.rs - Proxy Engine → Upstream Client: proxies upstream
- Proxy Engine → Load Balancer: selects backend
- Proxy Engine → Proxy Cache: uses cache logic
pingora-proxy/src/lib.rs - Proxy Engine → HTTP Session: reads and writes
- Upstream Client → Connection Pool: reuses connections
- Listeners → TLS: secures transport
- Proxy Cache → Cache Storage: reads and writes
- Memory Cache → Cache Storage: provides caching
- Proxy Engine → Request Limits: applies limits
- Services → Telemetry: integrates telemetry
- Telemetry → Prometheus: exports metrics
- Services → Async Runtime: runs asynchronously