Skip to main content

Crate orca_proxy

Crate orca_proxy 

Source
Expand description

Reverse proxy with HTTP routing for containers and Wasm trigger dispatch.

Routes HTTP traffic by Host header to container backends (round-robin), and by path pattern to Wasm component invocations via a callback. Supports automatic TLS via ACME/Let’s Encrypt (Caddy-style zero-config).

Modules§

acme
ACME certificate management with automatic Let’s Encrypt provisioning.
rate_limit
Simple per-IP token bucket rate limiter.
sni
Peek at TLS ClientHello to extract SNI hostname without consuming bytes.
tls
TLS configuration for the reverse proxy.

Structs§

FallbackConfig
Fallback proxy configuration. When orca’s route table has no match, requests are forwarded here. Lets orca coexist with another reverse proxy.
RouteTarget
A backend target for container routing.
WasmTrigger
A Wasm HTTP trigger: maps a path pattern to a Wasm runtime instance.

Functions§

run_proxy
Run the reverse proxy on the given port.
run_proxy_with_acme
Run HTTP on port 80 (for ACME challenges + redirect) and HTTPS on port 443.
run_proxy_with_acme_and_fallback
Run HTTP+HTTPS with ACME and optional fallback to another reverse proxy.
run_proxy_with_fallback
Run the proxy with optional fallback support.

Type Aliases§

SharedCertResolver
Shared dynamic cert resolver for hot-provisioning.
SharedWasmTriggers
Shared Wasm trigger table type.
WasmInvokeFuture
Future type returned by the Wasm invoker.
WasmInvoker
Callback invoked when a request matches a Wasm trigger. Receives (runtime_id, method, path, body) and returns the response body string.