Expand description
The proxy and operations layer of rust-web-server: reverse proxy, config-driven routes, load balancing, L4 and WebSocket proxies, the admin API, cluster sync, fleet pull, WAF, LLM and A2A gateways, FastCGI, traffic insights.
Internal to rust-web-server, released with it at the same version: use
these through the rust_web_server paths, which stay stable; this
crate’s own layout may change in any release. See
spec/WORKSPACE_SPLIT.md.
Modules§
- a2a
- A2A (Agent2Agent) 1.0 server, JSON-RPC binding (18.17.0, #65): other
agents discover this one by its Agent Card at
/.well-known/agent-card.jsonand talk to it withSendMessage,GetTask,ListTasks,CancelTask. - admin
- The admin API (18.10.0, #29): change and inspect a running server on a listener of its own, never on the public routes.
- canary
- Weighted canary / A-B traffic splitting middleware.
- cluster
- Runtime state shared across replicas through Redis (18.22.0). Runtime state shared across replicas (18.22.0, #76).
- config_
check rws --check: validaterws.config.tomlwithout starting the server — the counterpart ofnginx -t/caddy validate.- fastcgi
- FastCGI client: PHP through php-fpm (18.21.0). FastCGI (18.21.0, #72): PHP through php-fpm, and any other FastCGI responder, without FrankenPHP or a second web server.
- ingress
- Kubernetes Ingress watcher and router.
- llm
- An LLM proxy (18.9.0, #41): one endpoint in front of OpenAI-compatible and Anthropic providers that counts tokens, enforces budgets and fails over between providers.
- proxy
- Reverse proxy middleware with round-robin load balancing.
- proxy_
config - Config-driven proxy application.
- tcp_
proxy - Layer-4 TCP proxy.
- traffic
- Traffic insights (18.15.0): who visits — people, AI agents, bots — worked out by rws from each request, for the admin UI’s Traffic page.
- udp_
proxy - Layer-4 UDP proxy.
- waf
- Web application firewall: rws’s own rules (18.22.0). Web application firewall (18.22.0, #77): rws’s own rules, no rule language to learn and no external engine.
- ws_
proxy - WebSocket reverse proxy.