Sōzu is an open-source, fast and lightweight HTTP reverse proxy written in Rust, designed for high-performance traffic management in immutable infrastructure environments. It is configurable at runtime through a protobuf-based IPC protocol without requiring restarts, making it ideal for always-up deployments. Sōzu supports TLS termination, load balancing, and dynamic cluster configuration, and is developed by the sozu-proxy open-source organization on GitHub.
URL: Visit APIs.json URL
- Type: Index
- Position: Consuming
- Access: 3rd-Party
- Proxy
- Reverse Proxy
- Load Balancing
- Rust
- Open Source
- Created: 2026-03-27
- Modified: 2026-05-02
The Sozu Command API provides programmatic control of the Sōzu HTTP reverse proxy at runtime. External tools communicate with the Sozu main process through a secure Unix socket using a protobuf-based binary protocol (IPC). The sozu-command-lib crate ships the protobuf schema, configuration parser, replicated state, channels, and file descriptor passing helpers. This enables dynamic cluster configuration, certificate management, and backend routing changes without restarts.
- Documentation
- GitHub
- Getting Started
- Configuration Guide
- JSON Schema - Cluster
- JSON Schema - Frontend
The Sozu ACME integration automates TLS certificate requests from Let's Encrypt and other ACME-enabled certificate authorities. Now integrated directly into the main Sōzu binary.
The sozu-command-futures library provides a futures-based async Rust API for configuring the Sōzu HTTP reverse proxy programmatically.
| Schema | Description |
|---|---|
| sozu-cluster-schema.json | Backend cluster configuration including load balancing and backend instances |
| sozu-frontend-schema.json | Frontend routing rule binding hostname/path to a backend cluster |
| Structure | Description |
|---|---|
| sozu-configuration-structure.json | Hierarchical structure of proxy configuration: listeners, clusters, frontends, and certificates |
| Context | Description |
|---|---|
| sozu-context.jsonld | Linked data context mapping Sozu proxy configuration vocabulary to schema.org |
| Example | Description |
|---|---|
| sozu-cluster-example.json | Sample cluster configuration with two backend instances |
| sozu-frontend-example.json | Sample HTTPS frontend routing rule |
| Vocabulary | Description |
|---|---|
| sozu-vocabulary.yml | Domain vocabulary for Sozu reverse proxy configuration and operations |
The sozu-proxy GitHub organization maintains the following repositories:
| Repository | Description |
|---|---|
| sozu | Main HTTP reverse proxy binary and library |
| sozu-acme | ACME/Let's Encrypt certificate automation |
| sozu-command-futures | Futures-based async Rust API for Sozu configuration |
| dashboard | Experimental management dashboard |
| sozu-integration-tests | Integration test suite using Testcontainers |
| tube-cheese | Configuration manager based on Traefik patterns |
| sozu-demo | Demo configurations and usage examples |
FN: API Evangelist
Email: info@apievangelist.com