What is this?
Pingora is a Rust framework by Cloudflare for building fast, reliable, and programmable network services and proxies. It is battle-tested, having served more than 40 million internet requests per second for years.
Pingora is a Rust framework by Cloudflare for building fast, reliable, and programmable network services and proxies. It is battle-tested, having served more than 40 million internet requests per second for years.Is this a ready-made proxy server or a framework I build on top of?It is a framework made up of several Rust crates (pingora-core, pingora-proxy, pingora-load-balancing, etc.) that you use to assemble your own proxy or networked service, not a drop-in standalone proxy binary.
It is a framework made up of several Rust crates (pingora-core, pingora-proxy, pingora-load-balancing, etc.) that you use to assemble your own proxy or networked service, not a drop-in standalone proxy binary.How do I get started building something with it?Follow the quick starting guide to build a simple load balancer first, then use the user guide for configuring and running Pingora servers and building custom HTTP proxy logic on top of the framework's APIs.
Follow the quick starting guide to build a simple load balancer first, then use the user guide for configuring and running Pingora servers and building custom HTTP proxy logic on top of the framework's APIs.What do I need installed to build it?You need Clang installed (required for the BoringSSL build) and Perl 5 (required for OpenSSL), plus a Rust toolchain of at least version 1.85 since Pingora keeps a rolling 6-month MSRV policy.
You need Clang installed (required for the BoringSSL build) and Perl 5 (required for OpenSSL), plus a Rust toolchain of at least version 1.85 since Pingora keeps a rolling 6-month MSRV policy.Does it run as well outside Linux?Linux is the tier-1, main-focus environment. macOS is supported for development convenience though some features might be missing, and Windows support is only preliminary and maintained on a community best-effort basis.
Linux is the tier-1, main-focus environment. macOS is supported for development convenience though some features might be missing, and Windows support is only preliminary and maintained on a community best-effort basis.Which TLS backends can I use with Pingora?OpenSSL, BoringSSL, and s2n-tls are supported TLS backends, with rustls support currently marked as experimental.
OpenSSL, BoringSSL, and s2n-tls are supported TLS backends, with rustls support currently marked as experimental.Can I build a caching proxy with it?There is a pingora-memory-cache crate for async in-memory caching with cache-lock protection against cache stampede, but caching integration with pingora-proxy is explicitly called experimental with volatile APIs.
There is a pingora-memory-cache crate for async in-memory caching with cache-lock protection against cache stampede, but caching integration with pingora-proxy is explicitly called experimental with volatile APIs.Why would I choose Pingora over a C/C++ proxy?Pingora gives you memory safety as a Rust alternative to services traditionally written in C/C++, while still delivering comparable speed and efficiency for performance-sensitive workloads.
Pingora gives you memory safety as a Rust alternative to services traditionally written in C/C++, while still delivering comparable speed and efficiency for performance-sensitive workloads.Does it support gRPC and WebSocket traffic?Yes, Pingora includes gRPC and WebSocket proxying as built-in feature highlights alongside HTTP/1 and HTTP/2 end-to-end proxying.
Yes, Pingora includes gRPC and WebSocket proxying as built-in feature highlights alongside HTTP/1 and HTTP/2 end-to-end proxying.Which topics is it in?load-balancer, grpc, caching, reverse-proxy, async, tls, high-performance, websocket, http, observability, proxy, backend
load-balancer, grpc, caching, reverse-proxy, async, tls, high-performance, websocket, http, observability, proxy, backend