Pingora RustHomeHomeQuick StartQuick StartUser GuideUser GuideAbout UsAbout Us
GitHubGitHub (opens in a new tab)
  • User Guide
  • Running Pingora servers
  • Start and stop
  • Graceful shutdown
  • Configuration
  • Daemonization
  • Systemd integration
  • Handling panics
  • Error logging
  • Rate limiter
  • Prometheus
  • Building HTTP proxies
  • `pingora-proxy` phases and filters
  • how to connect to upstream
  • Sharing state across phases with `CTX`
  • How to return errors?
  • Examples: take control of the request
  • Connection pooling and reuse
  • Handling failures and failover
  • Advanced
  • Pingora internals
User Guide
User Guide

User Guide

In this guide, we will cover the most used features, operations and settings of Pingora.

Running Pingora servers

  • Start and stop
  • Graceful restart and graceful shutdown
  • Configuration
  • Daemonization
  • Systemd integration
  • Handling panics
  • Error logging
  • Prometheus

Building HTTP proxies

  • Life of a request: pingora-proxy phases and filters
  • Peer: how to connect to upstream
  • Sharing state across phases with CTX
  • How to return errors
  • Examples: take control of the request
  • Connection pooling and reuse
  • Handling failures and failover

Advanced topics (WIP)

  • Pingora internals
  • Using BoringSSL
  • User defined configuration
  • Pingora async runtime and threading model
  • Background Service
  • Blocking code in async context
  • Tracing

"Pingora" is the product name of Cloudflare and is not owned by this website. | Copyright 2025 © PingoraRust.COM