# arion-gateway/arion architecture

> Architecture diagram of the GitHub repository arion-gateway/arion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arion-gateway/arion
- Repository: https://github.com/arion-gateway/arion

## Overview

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: [`arion-lib/src/listeners/http_connection_manager.rs`](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager.rs) (HTTP request manager), [`arion-configuration/src/config.rs`](https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config.rs) (Bootstrap config), [`arion-proxy/src/runtime.rs`](https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/runtime.rs) (Proxy runtime), [`arion-xds/src/xds/client.rs`](https://github.com/arion-gateway/arion/blob/main/arion-xds/src/xds/client.rs) (xDS client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_bootstrap["Bootstrap config<br/>[config.rs]"]
  node_filter_config["HTTP filter config<br/>[http_filters.rs]"]
  node_route_config["Routes and matches<br/>[route.rs]"]
  node_xds_client["xDS client<br/>[client.rs]"]
end

subgraph group_proxy["Proxy runtime"]
  node_proxy_entry["Proxy process<br/>[main.rs]"]
  node_runtime["Proxy runtime<br/>[runtime.rs]"]
  node_listeners["Listeners<br/>[listener.rs]"]
  node_http_manager["HTTP request manager"]
  node_routing["Route selection<br/>[route.rs]"]
  node_clusters["Upstream clusters"]
  node_transport["Upstream transport<br/>[http_channel.rs]"]
  node_security["Auth and policies<br/>[jwt_authn.rs]"]
  node_rate_limits["Rate and connection limits<br/>[mod.rs]"]
  node_ext_proc["External processing<br/>[ext_proc.rs]"]
end

subgraph group_ai["AI and extensibility"]
  node_mcp["MCP gateway<br/>[mcp_gateway.rs]"]
  node_codemode["Code mode<br/>[engine.rs]"]
  node_wasm_host["Wasm filter host<br/>[wasm.rs]"]
  node_wasm_sdk["Wasm guest SDK<br/>[lib.rs]"]
end

subgraph group_operations["Observability and control"]
  node_metrics["Metrics<br/>[metrics.rs]"]
  node_tracing["Distributed tracing<br/>[lib.rs]"]
  node_access_log["Access logging<br/>[access_log.rs]"]
  node_admin["Admin API<br/>[admin.rs]"]
end

node_operator(("Operator"))
node_prometheus(("Prometheus scraper"))
node_control_plane(("xDS control plane"))
node_upstream(("Backend services"))

node_operator -->|"starts"| node_proxy_entry
node_operator -->|"configures"| node_bootstrap
node_bootstrap -->|"defines filters"| node_filter_config
node_bootstrap -->|"defines routes"| node_route_config
node_control_plane -->|"sends updates"| node_xds_client
node_proxy_entry -.->|"starts"| node_runtime
node_runtime -.->|"runs listeners"| node_listeners
node_listeners -.->|"dispatches HTTP"| node_http_manager
node_http_manager -.->|"selects route"| node_routing
node_http_manager -.->|"applies auth"| node_security
node_http_manager -.->|"enforces limits"| node_rate_limits
node_http_manager -.->|"dispatches processing"| node_ext_proc
node_http_manager -.->|"dispatches MCP"| node_mcp
node_http_manager -.->|"runs filters"| node_wasm_host
node_mcp -.->|"executes code"| node_codemode
node_wasm_sdk -.->|"plugins run in"| node_wasm_host
node_routing -.->|"selects upstream"| node_clusters
node_clusters -.->|"uses transport"| node_transport
node_transport -.->|"sends traffic"| node_upstream
node_xds_client -.->|"updates config"| node_runtime
node_http_manager -.->|"records metrics"| node_metrics
node_http_manager -.->|"traces requests"| node_tracing
node_http_manager -.->|"writes logs"| node_access_log
node_prometheus -.->|"scrapes"| node_metrics
node_operator -.->|"queries"| node_admin

click node_bootstrap "https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config.rs"
click node_filter_config "https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config/network_filters/http_connection_manager/http_filters.rs"
click node_route_config "https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config/network_filters/http_connection_manager/route.rs"
click node_xds_client "https://github.com/arion-gateway/arion/blob/main/arion-xds/src/xds/client.rs"
click node_proxy_entry "https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/main.rs"
click node_runtime "https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/runtime.rs"
click node_listeners "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/listener.rs"
click node_http_manager "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager.rs"
click node_routing "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/route.rs"
click node_clusters "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/clusters/clusters_manager.rs"
click node_transport "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/transport/http_channel.rs"
click node_security "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/jwt_authn.rs"
click node_rate_limits "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/rate_limiter/mod.rs"
click node_ext_proc "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/ext_proc.rs"
click node_mcp "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/mcp_gateway.rs"
click node_codemode "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs"
click node_wasm_host "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/wasm.rs"
click node_wasm_sdk "https://github.com/arion-gateway/arion/blob/main/arion-wasm-sdk/src/lib.rs"
click node_metrics "https://github.com/arion-gateway/arion/blob/main/arion-metrics/src/metrics.rs"
click node_tracing "https://github.com/arion-gateway/arion/blob/main/arion-tracing/src/lib.rs"
click node_access_log "https://github.com/arion-gateway/arion/blob/main/arion-lib/src/access_log.rs"
click node_admin "https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/admin.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_filter_config,node_route_config,node_xds_client toneBlue
class node_proxy_entry,node_runtime,node_listeners,node_http_manager,node_routing,node_clusters,node_transport,node_security,node_rate_limits,node_ext_proc toneAmber
class node_mcp,node_codemode,node_wasm_host,node_wasm_sdk toneMint
class node_metrics,node_tracing,node_access_log,node_admin toneRose
class node_operator,node_prometheus,node_control_plane,node_upstream toneIndigo
```

## Components

### Configuration

- [Bootstrap config](https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config.rs): `arion-configuration/src/config.rs`
- [HTTP filter config](https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config/network_filters/http_connection_manager/http_filters.rs): `arion-configuration/src/config/network_filters/http_connection_manager/http_filters.rs`
- [Routes and matches](https://github.com/arion-gateway/arion/blob/main/arion-configuration/src/config/network_filters/http_connection_manager/route.rs): `arion-configuration/src/config/network_filters/http_connection_manager/route.rs`
- [xDS client](https://github.com/arion-gateway/arion/blob/main/arion-xds/src/xds/client.rs): `arion-xds/src/xds/client.rs`

### Proxy runtime

- [Proxy process](https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/main.rs): `arion-proxy/src/main.rs`
- [Proxy runtime](https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/runtime.rs): `arion-proxy/src/runtime.rs`
- [Listeners](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/listener.rs): `arion-lib/src/listeners/listener.rs`
- [HTTP request manager](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager.rs): `arion-lib/src/listeners/http_connection_manager.rs`
- [Route selection](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/route.rs): `arion-lib/src/listeners/http_connection_manager/route.rs`
- [Upstream clusters](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/clusters/clusters_manager.rs): `arion-lib/src/clusters/clusters_manager.rs`
- [Upstream transport](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/transport/http_channel.rs): `arion-lib/src/transport/http_channel.rs`
- [Auth and policies](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/jwt_authn.rs): `arion-lib/src/listeners/http_connection_manager/jwt_authn.rs`
- [Rate and connection limits](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/rate_limiter/mod.rs): `arion-lib/src/listeners/rate_limiter/mod.rs`
- [External processing](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/ext_proc.rs): `arion-lib/src/listeners/http_connection_manager/ext_proc.rs`

### AI and extensibility

- [MCP gateway](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/mcp_gateway.rs): `arion-lib/src/listeners/http_connection_manager/mcp_gateway.rs`
- [Code mode](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs): `arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs`
- [Wasm filter host](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/listeners/http_connection_manager/wasm.rs): `arion-lib/src/listeners/http_connection_manager/wasm.rs`
- [Wasm guest SDK](https://github.com/arion-gateway/arion/blob/main/arion-wasm-sdk/src/lib.rs): `arion-wasm-sdk/src/lib.rs`

### Observability and control

- [Metrics](https://github.com/arion-gateway/arion/blob/main/arion-metrics/src/metrics.rs): `arion-metrics/src/metrics.rs`
- [Distributed tracing](https://github.com/arion-gateway/arion/blob/main/arion-tracing/src/lib.rs): `arion-tracing/src/lib.rs`
- [Access logging](https://github.com/arion-gateway/arion/blob/main/arion-lib/src/access_log.rs): `arion-lib/src/access_log.rs`
- [Admin API](https://github.com/arion-gateway/arion/blob/main/arion-proxy/src/admin.rs): `arion-proxy/src/admin.rs`

### Other components

- **Operator**
- **Prometheus scraper**
- **xDS control plane**
- **Backend services**

## Connections

- Operator → Proxy process: starts (evidence: `README.md`)
- Operator → Bootstrap config: configures (evidence: `README.md`)
- Bootstrap config → HTTP filter config: defines filters (evidence: `arion-configuration/src/config.rs`)
- Bootstrap config → Routes and matches: defines routes (evidence: `arion-configuration/src/config.rs`)
- xDS control plane → xDS client: sends updates (evidence: `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 (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- HTTP request manager → Auth and policies: applies auth (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- HTTP request manager → Rate and connection limits: enforces limits
- HTTP request manager → External processing: dispatches processing (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- HTTP request manager → MCP gateway: dispatches MCP (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- HTTP request manager → Wasm filter host: runs filters (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- MCP gateway → Code mode: executes code (evidence: `arion-lib/src/listeners/http_connection_manager/mcp_gateway/codemode/engine.rs`)
- Wasm guest SDK → Wasm filter host: plugins run in (evidence: `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 (evidence: `arion-lib/src/listeners/http_connection_manager.rs`)
- Prometheus scraper → Metrics: scrapes (evidence: `README.md`)
- Operator → Admin API: queries
