How arion-gateway/arion works
Arion Proxy accepts static Envoy-compatible bootstrap configuration or dynamic xDS updates, then serves and routes HTTP/TCP traffic to upstream clusters. Its request path includes routing, authentication and policy, rate limits, external processing, MCP tools, and optional Wasm filters; it also exposes observability and administration. The map preserves those documented capabilities, but sampled source only verifies selected configuration, request-handler, metrics, and xDS relationships; unverified runtime wiring is left out.
Main entry points: http_connection_manager.rs HTTP request manager · config.rs Bootstrap config · runtime.rs Proxy runtime · client.rs xDS client
Components 26
Configuration
- Bootstrap config
arion-configuration/src/config.rs - HTTP filter config
arion-configuration/src/config/network_filters/http_connection_manager/http_filters.rs - Routes and matches
arion-configuration/src/config/network_filters/http_connection_manager/route.rs - xDS client
arion-xds/src/xds/client.rs
Proxy runtime
- Proxy process
arion-proxy/src/main.rs - Proxy runtime
arion-proxy/src/runtime.rs - Listeners
arion-lib/src/listeners/listener.rs - HTTP request manager
arion-lib/src/listeners/http_connection_manager.rs - Route selection
arion-lib/src/listeners/http_connection_manager/route.rs - Upstream clusters
arion-lib/src/clusters/clusters_manager.rs - Upstream transport
arion-lib/src/transport/http_channel.rs - Auth and policies
arion-lib/src/listeners/http_connection_manager/jwt_authn.rs - Rate and connection limits
arion-lib/src/listeners/rate_limiter/mod.rs - External processing
arion-lib/src/listeners/http_connection_manager/ext_proc.rs
AI and extensibility
- MCP gateway
arion-lib/src/listeners/http_connection_manager/mcp_gateway.rs - Code mode
arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs - Wasm filter host
arion-lib/src/listeners/http_connection_manager/wasm.rs - Wasm guest SDK
arion-wasm-sdk/src/lib.rs
Observability and control
- Metrics
arion-metrics/src/metrics.rs - Distributed tracing
arion-tracing/src/lib.rs - Access logging
arion-lib/src/access_log.rs - Admin API
arion-proxy/src/admin.rs
Other components
- Operator
- Prometheus scraper
- xDS control plane
- Backend services
Connections 25
- Operator → Proxy process: starts
README.md - Operator → Bootstrap config: configures
README.md - Bootstrap config → HTTP filter config: defines filters
arion-configuration/src/config.rs - Bootstrap config → Routes and matches: defines routes
arion-configuration/src/config.rs - xDS control plane → xDS client: sends updates
README.md - Proxy process → Proxy runtime: starts
- Proxy runtime → Listeners: runs listeners
- Listeners → HTTP request manager: dispatches HTTP
- HTTP request manager → Route selection: selects route
arion-lib/src/listeners/http_connection_manager.rs - HTTP request manager → Auth and policies: applies auth
arion-lib/src/listeners/http_connection_manager.rs - HTTP request manager → Rate and connection limits: enforces limits
- HTTP request manager → External processing: dispatches processing
arion-lib/src/listeners/http_connection_manager.rs - HTTP request manager → MCP gateway: dispatches MCP
arion-lib/src/listeners/http_connection_manager.rs - HTTP request manager → Wasm filter host: runs filters
arion-lib/src/listeners/http_connection_manager.rs - MCP gateway → Code mode: executes code
arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs - Wasm guest SDK → Wasm filter host: plugins run in
README.md - Route selection → Upstream clusters: selects upstream
- Upstream clusters → Upstream transport: uses transport
- Upstream transport → Backend services: sends traffic
- xDS client → Proxy runtime: updates config
- HTTP request manager → Metrics: records metrics
- HTTP request manager → Distributed tracing: traces requests
- HTTP request manager → Access logging: writes logs
arion-lib/src/listeners/http_connection_manager.rs - Prometheus scraper → Metrics: scrapes
README.md - Operator → Admin API: queries