Module proxy_config 

Config-driven proxy application.

When rws.config.toml contains [[route]] or [[upstream]] sections, ConfigDrivenApp is used as the top-level Application instead of the hardcoded build_app() in main.rs.

Quick start

# rws.config.toml
[[upstream]]
name = "api"
backends = ["localhost:3000"]

[[route]]
name = "api-proxy"

[route.match]
path = "/api/*"

[route.action]
type = "proxy"

[route.action.proxy]
upstream = "api"

Modules

a2a_gateway

[route.action] type = "a2a": one public address for an A2A agent running elsewhere (18.18.0, #65).

builder

Builder: converts a ProxyConfig into a live ConfigDrivenApp with health checkers and L4/WS proxy threads.

health

Background health-checker for upstream backends.

llm

[route.action] type = "llm": the LLM proxy from the config file (18.9.0).

mcp_gateway

[route.action] type = "mcp": the MCP gateway from the config file (18.9.0).

parser

Hand-rolled TOML parser that extracts [[upstream]], [[route]], [[tcp_proxy]], [[udp_proxy]], [[ws_proxy]] sections from rws.config.toml into a flat SectionMap.

validate

Static checks for the proxy sections of rws.config.toml, used by rws --check and printed at startup. The parser itself is lenient — a typo’d key just leaves a default in place — so this is where a route that points at a missing upstream, an auth secret that isn’t set, or a key the parser never reads gets reported.

Structs

AuthzConfig

[authz] and its [authz.type.<name>] tables.

BreakerConfig

[upstream.circuit_breaker]: take a failing backend out of rotation.

CacheConfig

ConfigDrivenApp

An Application that routes requests based on a parsed ProxyConfig.

FastCgiAction

type = "fastcgi": the crate::fastcgi::FastCgiConfig fields.

HealthCheckConfig

MatchConfig

MiddlewareConfig

MirrorConfig

[route.middleware.mirror].

OidcRouteAuth

[route.middleware.auth] type = "oidc".

ProxyConfig

RateLimitConfig

RetryConfig

[upstream.retry]: try another backend.

RewriteRuleConfig

RouteAuthzConfig

[route.middleware.authz].

RouteConfig

StickyConfig

[upstream.sticky]: keep a client on one backend with a cookie.

TcpProxyConfig

UdpProxyConfig

UpstreamConfig

WafSettings

[route.middleware.waf] / [middleware.waf], parsed; errors names values that didn’t parse (rws --check reports them; the WAF then runs with the rest).

WasmConfig

[route.middleware.wasm].

WsProxyConfig

Enums

ActionConfig

AuthConfig

ReloadOutcome

What a successful ConfigDrivenApp::reload_from_str changed.

UpstreamHost

The Host a proxy route sends its upstream.

Functions

build_from_file

Build a ConfigDrivenApp from rws.config.toml and spawn L4/WS proxy threads. Returns the app and a list of thread handles.