# apache/apisix architecture

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

- Interactive diagram: https://gitdiagram.com/apache/apisix
- Repository: https://github.com/apache/apisix

## Overview

Apache APISIX is a dynamic API/AI gateway. The documented request path is: an administrator configures a route, a client request enters the gateway, traffic is matched and managed, and the request is proxied to an upstream service. The supplied tree is a partial snapshot dominated by tests and examples; it does not include the gateway runtime or most feature implementations. Accordingly, the graph captures documented product stages and capabilities, but cannot assign source paths to those unsupplied components. Edges are based on the README rather than inspected runtime code.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_admin_api["Admin API"]
  node_route_config["Route configuration"]
end

subgraph group_traffic["Gateway traffic"]
  node_gateway["APISIX gateway"]
  node_routing["Dynamic routing"]
end

subgraph group_capabilities["Traffic capabilities"]
  node_load_balancing["Load balancing"]
  node_resilience["Retries and resilience"]
  node_traffic_control["Traffic control"]
  node_security["Authentication and security"]
  node_observability["Observability"]
end

subgraph group_integrations["Protocols and integrations"]
  node_ai_proxy["AI proxying"]
  node_protocol_proxy["Protocol proxies"]
end

node_admin(("Administrator"))
node_client(("API client"))
node_upstream["Upstream service"]
node_etcd[("etcd configuration store")]

node_admin -->|"configures"| node_admin_api
node_admin_api -->|"sets routes"| node_route_config
node_client -->|"sends request"| node_gateway
node_gateway -->|"matches route"| node_routing
node_routing -->|"proxies request"| node_upstream
node_gateway -->|"balances traffic"| node_load_balancing
node_gateway -->|"manages failures"| node_resilience
node_gateway -->|"controls traffic"| node_traffic_control
node_gateway -->|"secures traffic"| node_security
node_gateway -->|"provides observability"| node_observability
node_gateway -->|"routes AI traffic"| node_ai_proxy
node_gateway -->|"proxies protocols"| node_protocol_proxy
node_gateway -->|"uses configuration store"| node_etcd

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_admin_api,node_route_config,node_client toneBlue
class node_gateway,node_routing,node_etcd toneAmber
class node_load_balancing,node_resilience,node_traffic_control,node_security,node_observability toneMint
class node_ai_proxy,node_protocol_proxy toneRose
class node_admin,node_upstream toneIndigo
```

## Components

### Configuration

- **Admin API**
- **Route configuration**

### Gateway traffic

- **APISIX gateway**
- **Dynamic routing**

### Traffic capabilities

- **Load balancing**
- **Retries and resilience**
- **Traffic control**
- **Authentication and security**
- **Observability**

### Protocols and integrations

- **AI proxying**
- **Protocol proxies**

### Other components

- **Administrator**
- **API client**
- **Upstream service**
- **etcd configuration store**

## Connections

- Administrator → Admin API: configures
- Admin API → Route configuration: sets routes
- API client → APISIX gateway: sends request
- APISIX gateway → Dynamic routing: matches route
- Dynamic routing → Upstream service: proxies request
- APISIX gateway → Load balancing: balances traffic
- APISIX gateway → Retries and resilience: manages failures
- APISIX gateway → Traffic control: controls traffic
- APISIX gateway → Authentication and security: secures traffic
- APISIX gateway → Observability: provides observability
- APISIX gateway → AI proxying: routes AI traffic
- APISIX gateway → Protocol proxies: proxies protocols
- APISIX gateway → etcd configuration store: uses configuration store
