How cloudflare/cloudflared works
cloudflared is a command-line daemon that maintains outbound tunnels between Cloudflare’s network and configured origins. Users authenticate and create or configure a tunnel, then route public or private traffic through it; the daemon discovers edge endpoints, establishes transport connections, and proxies requests to origins. The repository also supports Layer 4 access, management and diagnostics, quick tunnels, and updates. Several links below reflect README capabilities; source excerpts and the index show the main runtime ownership, but do not expose every subsystem’s wiring.
Main entry points: origin_service.go Ingress routing · tunnel.go Tunnel supervisor · main.go CLI entry · proxy.go Request proxy
Components 20
CLI and configuration
- CLI entry
cmd/cloudflared/main.go - Tunnel commands
cmd/cloudflared/tunnel/cmd.go - Config manager
config/manager.go - File watcher
watcher/file.go
Tunnel runtime
- Orchestrator
orchestration/orchestrator.go - Tunnel supervisor
supervisor/tunnel.go - Edge discovery
edgediscovery/edgediscovery.go - Edge connections
connection/quic_connection.go - Tunnel RPC
tunnelrpc/quic/cloudflared_client.go
Traffic handling
- Request proxy
proxy/proxy.go - Ingress routing
ingress/origin_service.go - Origin services
ingress/origin_service.go - UDP sessions
quic/v3/manager.go
Operations and access
- Management service
management/service.go - Diagnostics
diagnostic/handlers.go - Quick Tunnel auth
quicktunnelauth/handler.go - Layer 4 access
cmd/cloudflared/access/cmd.go - Updater
cmd/cloudflared/updater/update.go
Other components
- Operator
- Cloudflare network
Connections 19
- Operator → CLI entry: runs CLI
README.md - CLI entry → Tunnel commands: registers commands
cmd/cloudflared/main.go - CLI entry → Config manager: starts service mode
cmd/cloudflared/main.go - Config manager → File watcher: watches config
config/manager.go - Orchestrator → Ingress routing: builds routing
orchestration/orchestrator.go - Orchestrator → Request proxy: creates proxy
orchestration/orchestrator.go - Tunnel supervisor → Orchestrator: configures
supervisor/tunnel.go - Tunnel supervisor → Edge discovery: discovers edges
supervisor/tunnel.go - Tunnel supervisor → Edge connections: manages connections
supervisor/tunnel.go - Edge connections → Tunnel RPC: uses RPC
connection/quic_connection.go - Cloudflare network → Edge connections: sends tunnel traffic
README.md - Request proxy → Ingress routing: routes requests
proxy/proxy.go - Ingress routing → Origin services: proxies to origins
README.md - Ingress routing → Quick Tunnel auth: authorizes requests
- Operator → Layer 4 access: uses Layer 4 access
README.md - Request proxy → UDP sessions: supports UDP sessions
- Operator → Management service: uses management endpoints
- Management service → Diagnostics: exposes diagnostics
- Operator → Updater: requests updates