# cloudflare/cloudflared architecture

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

- Interactive diagram: https://gitdiagram.com/cloudflare/cloudflared
- Repository: https://github.com/cloudflare/cloudflared

## Overview

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: [`ingress/origin_service.go`](https://github.com/cloudflare/cloudflared/blob/master/ingress/origin_service.go) (Ingress routing), [`supervisor/tunnel.go`](https://github.com/cloudflare/cloudflared/blob/master/supervisor/tunnel.go) (Tunnel supervisor), [`cmd/cloudflared/main.go`](https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/main.go) (CLI entry), [`proxy/proxy.go`](https://github.com/cloudflare/cloudflared/blob/master/proxy/proxy.go) (Request proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and configuration"]
  node_main["CLI entry<br/>[main.go]"]
  node_commands["Tunnel commands<br/>[cmd.go]"]
  node_config["Config manager<br/>[manager.go]"]
  node_watcher["File watcher<br/>[file.go]"]
end

subgraph group_runtime["Tunnel runtime"]
  node_orchestrator["Orchestrator<br/>[orchestrator.go]"]
  node_supervisor["Tunnel supervisor<br/>[tunnel.go]"]
  node_discovery["Edge discovery<br/>[edgediscovery.go]"]
  node_connections["Edge connections<br/>[quic_connection.go]"]
  node_rpc["Tunnel RPC"]
end

subgraph group_traffic["Traffic handling"]
  node_proxy["Request proxy<br/>[proxy.go]"]
  node_ingress["Ingress routing<br/>[origin_service.go]"]
  node_origins["Origin services<br/>[origin_service.go]"]
  node_udp["UDP sessions<br/>[manager.go]"]
end

subgraph group_operations["Operations and access"]
  node_management["Management service<br/>[service.go]"]
  node_diagnostics["Diagnostics<br/>[handlers.go]"]
  node_quickauth["Quick Tunnel auth<br/>[handler.go]"]
  node_access["Layer 4 access<br/>[cmd.go]"]
  node_updater["Updater<br/>[update.go]"]
end

node_user(("Operator"))
node_cloudflare(("Cloudflare network"))

node_user -->|"runs CLI"| node_main
node_main -->|"registers commands"| node_commands
node_main -->|"starts service mode"| node_config
node_config -->|"watches config"| node_watcher
node_orchestrator -->|"builds routing"| node_ingress
node_orchestrator -->|"creates proxy"| node_proxy
node_supervisor -->|"configures"| node_orchestrator
node_supervisor -->|"discovers edges"| node_discovery
node_supervisor -->|"manages connections"| node_connections
node_connections -->|"uses RPC"| node_rpc
node_cloudflare -->|"sends tunnel traffic"| node_connections
node_proxy -->|"routes requests"| node_ingress
node_ingress -->|"proxies to origins"| node_origins
node_ingress -.->|"authorizes requests"| node_quickauth
node_user -->|"uses Layer 4 access"| node_access
node_proxy -.->|"supports UDP sessions"| node_udp
node_user -.->|"uses management endpoints"| node_management
node_management -.->|"exposes diagnostics"| node_diagnostics
node_user -->|"requests updates"| node_updater

click node_main "https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/main.go"
click node_commands "https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/tunnel/cmd.go"
click node_config "https://github.com/cloudflare/cloudflared/blob/master/config/manager.go"
click node_watcher "https://github.com/cloudflare/cloudflared/blob/master/watcher/file.go"
click node_orchestrator "https://github.com/cloudflare/cloudflared/blob/master/orchestration/orchestrator.go"
click node_supervisor "https://github.com/cloudflare/cloudflared/blob/master/supervisor/tunnel.go"
click node_discovery "https://github.com/cloudflare/cloudflared/blob/master/edgediscovery/edgediscovery.go"
click node_connections "https://github.com/cloudflare/cloudflared/blob/master/connection/quic_connection.go"
click node_rpc "https://github.com/cloudflare/cloudflared/blob/master/tunnelrpc/quic/cloudflared_client.go"
click node_proxy "https://github.com/cloudflare/cloudflared/blob/master/proxy/proxy.go"
click node_ingress "https://github.com/cloudflare/cloudflared/blob/master/ingress/origin_service.go"
click node_origins "https://github.com/cloudflare/cloudflared/blob/master/ingress/origin_service.go"
click node_udp "https://github.com/cloudflare/cloudflared/blob/master/quic/v3/manager.go"
click node_management "https://github.com/cloudflare/cloudflared/blob/master/management/service.go"
click node_diagnostics "https://github.com/cloudflare/cloudflared/blob/master/diagnostic/handlers.go"
click node_quickauth "https://github.com/cloudflare/cloudflared/blob/master/quicktunnelauth/handler.go"
click node_access "https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/access/cmd.go"
click node_updater "https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/updater/update.go"

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_main,node_commands,node_config,node_watcher toneBlue
class node_orchestrator,node_supervisor,node_discovery,node_connections,node_rpc toneAmber
class node_proxy,node_ingress,node_origins,node_udp toneMint
class node_management,node_diagnostics,node_quickauth,node_access,node_updater toneRose
class node_user,node_cloudflare toneIndigo
```

## Components

### CLI and configuration

- [CLI entry](https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/main.go): `cmd/cloudflared/main.go`
- [Tunnel commands](https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/tunnel/cmd.go): `cmd/cloudflared/tunnel/cmd.go`
- [Config manager](https://github.com/cloudflare/cloudflared/blob/master/config/manager.go): `config/manager.go`
- [File watcher](https://github.com/cloudflare/cloudflared/blob/master/watcher/file.go): `watcher/file.go`

### Tunnel runtime

- [Orchestrator](https://github.com/cloudflare/cloudflared/blob/master/orchestration/orchestrator.go): `orchestration/orchestrator.go`
- [Tunnel supervisor](https://github.com/cloudflare/cloudflared/blob/master/supervisor/tunnel.go): `supervisor/tunnel.go`
- [Edge discovery](https://github.com/cloudflare/cloudflared/blob/master/edgediscovery/edgediscovery.go): `edgediscovery/edgediscovery.go`
- [Edge connections](https://github.com/cloudflare/cloudflared/blob/master/connection/quic_connection.go): `connection/quic_connection.go`
- [Tunnel RPC](https://github.com/cloudflare/cloudflared/blob/master/tunnelrpc/quic/cloudflared_client.go): `tunnelrpc/quic/cloudflared_client.go`

### Traffic handling

- [Request proxy](https://github.com/cloudflare/cloudflared/blob/master/proxy/proxy.go): `proxy/proxy.go`
- [Ingress routing](https://github.com/cloudflare/cloudflared/blob/master/ingress/origin_service.go): `ingress/origin_service.go`
- [Origin services](https://github.com/cloudflare/cloudflared/blob/master/ingress/origin_service.go): `ingress/origin_service.go`
- [UDP sessions](https://github.com/cloudflare/cloudflared/blob/master/quic/v3/manager.go): `quic/v3/manager.go`

### Operations and access

- [Management service](https://github.com/cloudflare/cloudflared/blob/master/management/service.go): `management/service.go`
- [Diagnostics](https://github.com/cloudflare/cloudflared/blob/master/diagnostic/handlers.go): `diagnostic/handlers.go`
- [Quick Tunnel auth](https://github.com/cloudflare/cloudflared/blob/master/quicktunnelauth/handler.go): `quicktunnelauth/handler.go`
- [Layer 4 access](https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/access/cmd.go): `cmd/cloudflared/access/cmd.go`
- [Updater](https://github.com/cloudflare/cloudflared/blob/master/cmd/cloudflared/updater/update.go): `cmd/cloudflared/updater/update.go`

### Other components

- **Operator**
- **Cloudflare network**

## Connections

- Operator → CLI entry: runs CLI (evidence: `README.md`)
- CLI entry → Tunnel commands: registers commands (evidence: `cmd/cloudflared/main.go`)
- CLI entry → Config manager: starts service mode (evidence: `cmd/cloudflared/main.go`)
- Config manager → File watcher: watches config (evidence: `config/manager.go`)
- Orchestrator → Ingress routing: builds routing (evidence: `orchestration/orchestrator.go`)
- Orchestrator → Request proxy: creates proxy (evidence: `orchestration/orchestrator.go`)
- Tunnel supervisor → Orchestrator: configures (evidence: `supervisor/tunnel.go`)
- Tunnel supervisor → Edge discovery: discovers edges (evidence: `supervisor/tunnel.go`)
- Tunnel supervisor → Edge connections: manages connections (evidence: `supervisor/tunnel.go`)
- Edge connections → Tunnel RPC: uses RPC (evidence: `connection/quic_connection.go`)
- Cloudflare network → Edge connections: sends tunnel traffic (evidence: `README.md`)
- Request proxy → Ingress routing: routes requests (evidence: `proxy/proxy.go`)
- Ingress routing → Origin services: proxies to origins (evidence: `README.md`)
- Ingress routing → Quick Tunnel auth: authorizes requests
- Operator → Layer 4 access: uses Layer 4 access (evidence: `README.md`)
- Request proxy → UDP sessions: supports UDP sessions
- Operator → Management service: uses management endpoints
- Management service → Diagnostics: exposes diagnostics
- Operator → Updater: requests updates
