How flannel-io/flannel works
Flannel is a per-host Kubernetes network agent: it obtains a node subnet lease and network configuration from Kubernetes or etcd, then configures a selected backend to transport traffic between hosts. The principal runtime path also installs host traffic rules and reports readiness. Backend implementations include overlay tunnels, routing, and cloud-specific options; the README documents these capabilities, while the excerpts show only selected implementation details, so some backend relationships are documented rather than traced through sampled callers.
Main entry points: main.go flanneld agent · common.go Backend API · local_manager.go etcd lease manager · trafficmngr.go Traffic manager
Components 19
Agent runtime
- flanneld agent
main.go - Backend manager
pkg/backend/manager.go - Interface selection
pkg/ipmatch/match.go
Subnet management
- Lease model
pkg/lease/lease.go - Subnet manager API
pkg/subnet/subnet.go - Kubernetes store
pkg/subnet/kube/kube.go - etcd registry
pkg/subnet/etcd/registry.go - etcd lease manager
pkg/subnet/etcd/local_manager.go
Network backends
- Backend API
pkg/backend/common.go - VXLAN transport
pkg/backend/vxlan/vxlan_network.go - WireGuard transport
pkg/backend/wireguard/wireguard_network.go - Host-gateway routes
pkg/backend/hostgw/hostgw_windows.go - IP-in-IP transport
pkg/backend/ipip/ipip.go - IPsec transport
pkg/backend/ipsec/ipsec.go - Cloud backends
pkg/backend/tencentvpc/tencentvpc.go
Host networking
- Traffic manager
pkg/trafficmngr/trafficmngr.go - iptables rules
pkg/trafficmngr/iptables/iptables.go - nftables rules
pkg/trafficmngr/nftables/nftables.go
Other components
- Cluster operator
Connections 21
- Cluster operator → flanneld agent: starts
README.md - flanneld agent → Interface selection: selects interface
main.go - flanneld agent → Kubernetes store: creates manager
main.go - flanneld agent → etcd lease manager: creates manager
main.go - etcd lease manager → etcd registry: uses registry
pkg/subnet/etcd/local_manager.go - etcd lease manager → Lease model: allocates leases
pkg/subnet/etcd/local_manager.go - Kubernetes store → Lease model: provides leases
pkg/subnet/kube/kube.go - Backend manager → Subnet manager API: receives manager
pkg/backend/manager.go - Backend manager → Backend API: constructs backend
pkg/backend/manager.go - flanneld agent → Backend API: registers network
main.go - Backend API → VXLAN transport: selects transport
README.md - Backend API → WireGuard transport: selects transport
README.md - Backend API → Host-gateway routes: selects transport
README.md - Backend API → IP-in-IP transport: selects transport
README.md - Backend API → IPsec transport: selects transport
README.md - Backend API → Cloud backends: selects integration
README.md - flanneld agent → Traffic manager: configures forwarding
main.go - flanneld agent → iptables rules: chooses rules
main.go - flanneld agent → nftables rules: chooses rules
main.go - Traffic manager → iptables rules: implements rules
pkg/trafficmngr/iptables/iptables.go - Traffic manager → nftables rules: implements rules
pkg/trafficmngr/trafficmngr.go