How envoyproxy/envoy works
Envoy is a cloud-native proxy that accepts downstream traffic, applies configured protocol handling and routing, and connects to upstream services; its APIs also support dynamic configuration. The tree and excerpts show HTTP connection management, cluster management, listener management, and mobile-engine setup, while the README characterizes the product broadly as an edge, middle, and service proxy. The excerpts do not establish a complete server startup-to-request call chain, so uncertain runtime links are omitted. Core interfaces and shared runtime facilities are included as internal layers.
Main entry points: conn_manager_impl.cc HTTP connection manager · cluster_manager_impl.cc Cluster manager · main.cc Envoy server · internal_engine.cc Mobile engine
Components 22
Startup and mobile
- Envoy server
source/exe/main.cc - Mobile builder
mobile/library/cc/engine_builder.cc - Mobile engine
mobile/library/common/internal_engine.cc
Traffic handling
- HTTP connection manager
source/common/http/conn_manager_impl.cc - RBAC engine
source/extensions/filters/common/rbac/engine_impl.cc - AI transcoding
source/extensions/filters/http/ai_protocol_manager/transcoding_engine.cc - Regex engine
source/server/regex_engine.cc
Configuration and upstreams
- Proxy APIs
api/envoy/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto - xDS manager
envoy/config/xds_manager.h - Listener manager
envoy/server/listener_manager.h - Cluster manager
source/common/upstream/cluster_manager_impl.cc - Cluster interface
envoy/upstream/cluster_manager.h
Runtime foundations
- Event dispatcher
envoy/event/dispatcher.h - Buffer API
envoy/buffer/buffer.h - Stats scopes
envoy/stats/scope.h - TLS contexts
envoy/ssl/context_manager.h - Assertions
source/common/common/assert.h - Common utilities
source/common/common/utility.h - Runtime features
source/common/runtime/runtime_features.h
Other components
- Proxy user
- Control plane
- Upstream services
Connections 20
- Proxy user → Envoy server: configures
README.md - Proxy user → Mobile builder: configures
- Mobile builder → Mobile engine: configures
mobile/library/cc/engine_builder.cc - Mobile engine → Listener manager: uses listener API
mobile/library/common/internal_engine.cc - Control plane → xDS manager: supplies configuration
- Proxy APIs → xDS manager: defines config
- xDS manager → Cluster interface: uses interface
envoy/config/xds_manager.h - Envoy server → Cluster manager: initializes
- Envoy server → Listener manager: starts listeners
- Proxy user → HTTP connection manager: sends traffic
README.md - HTTP connection manager → Cluster manager: routes upstream
- Cluster manager → Upstream services: connects upstream
- HTTP connection manager → RBAC engine: applies policy
- HTTP connection manager → AI transcoding: transcodes requests
- Event dispatcher → Mobile engine: dispatches work
mobile/library/common/internal_engine.cc - HTTP connection manager → Buffer API: processes data
source/common/http/conn_manager_impl.cc - HTTP connection manager → Stats scopes: records metrics
source/common/http/conn_manager_impl.cc - Cluster manager → Event dispatcher: uses event loop
source/common/upstream/cluster_manager_impl.cc - Regex engine → Common utilities: uses utilities
source/server/regex_engine.cc - Runtime features → Common utilities: uses runtime helpers