Pingora Gateway Controller¶

Kubernetes controller implementing Gateway API for Pingora proxy.

Route traffic through a high-performance Pingora-based reverse proxy using standard Gateway API resources (Gateway, HTTPRoute, GRPCRoute).

Architecture¶

graph TB
    subgraph Kubernetes Cluster
        GW[Gateway API Resources<br/>Gateway, HTTPRoute, GRPCRoute]
        CTL[pingora-gateway-controller<br/>Go]
        PX[pingora-proxy<br/>Rust/Pingora]
        SVC[Backend Services]
    end

    CLIENT[Client Traffic] -->|HTTP/gRPC| PX
    GW -->|watches| CTL
    CTL -->|gRPC sync| PX
    PX -->|proxies| SVC

Features¶

• Standard Gateway API - GatewayClass, Gateway, HTTPRoute, GRPCRoute support
• High Performance - Built on Pingora, Cloudflare's battle-tested proxy framework
• Dynamic Configuration - Routes synced via gRPC without proxy restarts
• Leader Election - High availability deployments with multiple replicas
• Multi-arch Images - Supports amd64 and arm64 architectures
• Secure by Default - Non-root containers, read-only filesystem, minimal capabilities

Quick Start¶

# 1. Install Gateway API CRDs
kubectl apply --filename https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.4.1/standard-install.yaml

# 2. Install the controller with Helm
helm install pingora-gateway-controller \
  oci://ghcr.io/lexfrei/pingora-gateway-controller/chart \
  --namespace pingora-system \
  --create-namespace

# 3. Create HTTPRoute to expose your service
kubectl apply --filename - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: my-app
spec:
  parentRefs:
    - name: pingora-gateway
      namespace: pingora-system
  hostnames:
    - app.example.com
  rules:
    - backendRefs:
        - name: my-service
          port: 80
EOF

See Getting Started for detailed setup instructions.

Documentation Sections¶

Roadmap¶

Target: Gateway API v1.4.1 Standard Channel Conformance

Milestones¶

Gateway API Support¶

Resources¶

HTTPRoute Filters¶

HTTPRoute Matching (Implemented)¶

See GitHub Milestones for detailed progress.

Project Links¶

• GitHub Repository
• Issues
• Releases

License¶

BSD 3-Clause License - see LICENSE for details.