How vvm2/shiddns works
Core Components
• DNS Server (Main Service)
• Configuration Manager
• Message Parser/Handler
• Filter System
• Local DNS Resolver
• Upstream DNS Forwarder
External Components
• Upstream DNS Server (e.g., 1.1.1.1)
• Block List Sources
• Client DNS Queries
Main Service Layer
• UDP Socket Listener (port configurable)
• Message Processing Pipeline
• Control File Monitor (IPC mechanism)
Resolution Flow
a. Incoming DNS Query → Message Parser
b. Message Parser → Filter System
c. Filter System → Local DNS Resolver
d. Local DNS Resolver → Upstream DNS Forwarder (if local resolution fails)
e. Response Path back to Client
Configuration and Storage
• Local DNS Entries
• Filter Rules
• Network Settings
• Service Settings
Filter System Detail
• Block Lists Storage
• Allow Lists Storage
• Regular Expression Patterns
• Filter Rules Processor
• Blue: Core DNS components
• Green: Local DNS resolution components
• Red: Filtering and blocking components
• Gray: External services/components
• Yellow: Configuration elements
Specific Implementation Details to Highlight:
Message Flow
Client Query → UDP Socket
• → Message Parser
• → Filter Check
• → Resolution (Local/Upstream)
• → Response Generation
• → Client Response
Control Flow
Control File → Service Commands
• → Filter Refresh
• → Configuration Reload
Separation between local and upstream resolution paths
• Data flow directions
• Component types
• Configuration dependencies
• Security boundaries
• Filter processing paths
Level of Detail:
Local DNS Resolution Process
This will provide a comprehensive view of the system while maintaining clarity at each level of abstraction.