How struktsource/lumen-dns works
Lumen is a self-hosted DNS and network-management service. Its main path is DNS clients sending queries through bounded listeners to recursive or encrypted-forwarding resolution, with filtering and optional local answers; administrators manage configuration and network features through the console or CLI. The graph also retains documented DHCP, mDNS, certificates, authoritative zones, IPAM, and discovery capabilities. Several subsystem links are documented in the README; unsampled implementation details are not treated as inspected evidence.
Main entry points: main.rs Lumen daemon · console.rs Console API · transport.rs DNS transports · lib.rs Query service
Components 20
DNS runtime
- Lumen daemon
apps/lumen/src/main.rs - Configuration
crates/lumen-config/src/lib.rs - DNS transports
crates/lumen-core/src/transport.rs - Query service
crates/lumen-core/src/lib.rs - ACME certificates
crates/lumen-core/src/acme.rs
Resolution features
- Recursive resolver
crates/lumen-resolver/src/lib.rs - Encrypted forwarding
crates/lumen-resolver/src/forward.rs - Client filtering
crates/lumen-filter/src/lib.rs - Authoritative zones
crates/lumen-resolver/src/zones.rs
Network services
- DHCP server
crates/lumen-dhcp/src/server.rs - mDNS bridge
crates/lumen-mdns/src/bridge.rs - Address management
crates/lumen-ipam/src/store.rs - Network discovery
crates/lumen-netmon/src/engine.rs
Management
- lumenctl
apps/lumenctl/src/main.rs - Management API
crates/lumen-api/src/lib.rs - SQLite state
crates/lumen-store/src/lib.rs
Web console
- Console API
crates/lumen-web/src/console.rs - Console host
crates/lumen-web/src/host.rs - Browser console
web/js/app.js
Other components
- DNS clients
Connections 19
- DNS clients → DNS transports: sends queries
- DNS transports → Query service: dispatches queries
crates/lumen-core/src/transport.rs - Query service → Recursive resolver: resolves queries
crates/lumen-core/src/lib.rs - Recursive resolver → Encrypted forwarding: forwards optionally
crates/lumen-resolver/src/lib.rs - Query service → Client filtering: filters clients
- Recursive resolver → Authoritative zones: serves zones
crates/lumen-resolver/src/zones.rs - Lumen daemon → Configuration: loads settings
- Lumen daemon → DNS transports: starts service
- DNS transports → ACME certificates: obtains certificates
crates/lumen-core/src/transport.rs - Lumen daemon → DHCP server: starts optionally
- Lumen daemon → mDNS bridge: enables optionally
- Lumen daemon → Network discovery: runs optionally
- Console API → Address management: manages addresses
- Console API → DHCP server: manages DHCP
- Browser console → Console API: calls API
- Console API → Console host: queries daemon
crates/lumen-web/src/console.rs - Console API → SQLite state: reads and writes
crates/lumen-web/src/console.rs - lumenctl → Lumen daemon: controls service
- Management API → SQLite state: manages state