lazydns 0.2.63

A light and fast DNS server/forwarder implementation in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

# LazyDNS Example Configuration

This directory contains a complete working example of LazyDNS configuration based on the [lazymosdns](https://github.com/lazywalker/lazymosdns) setup.

## Features Demonstrated

- **DNS Caching**: Cache query results for faster responses
- **Multiple Upstreams**: Forward queries to both local (CN) and remote (international) DNS servers
- **Domain Lists**: Separate handling for CN domains, GFW domains, and ad domains
- **IP Lists**: China IP detection and whitelisting
- **Hosts File**: Custom DNS records with auto-reload support
- **Auto-Reload**: All data provider plugins (hosts, domain_set, ip_set) support automatic file reloading
- **Fallback**: Intelligent fallback between local and remote DNS servers
- **RouterOS Integration**: Add domains to RouterOS address lists 
(optional)
- **Rate Limiting and Validation**: Basic rate limiting and query validation

## Quick Start

### 1. Run the Example

From the repository root:

```bash
target/release/lazydns -c config.yaml -d examples/etc/
```

### 2. Test with dig

Test basic DNS resolution:

```bash
# Test localhost resolution (from hosts.txt)
dig @127.0.0.1 -p 5354 localhost

# Test a CN domain (should use local DNS)
dig @127.0.0.1 -p 5354 baidu.com

# Test an international domain (should use remote DNS)
dig @127.0.0.1 -p 5354 google.com

# Test AAAA (IPv6) query
dig @127.0.0.1 -p 5354 AAAA google.com
```

### 3. Test with nslookup

```bash
# Test basic resolution
nslookup -port=5354 localhost 127.0.0.1

# Test domain resolution
nslookup -port=5354 baidu.com 127.0.0.1
```

## Configuration Files

### Main Configuration

- **config.yaml**: Main configuration file defining all plugins and their execution flow

### Data Files

- **hosts.txt**: Custom hosts file for local DNS resolution
- **hosts-github.txt**: GitHub-related hosts entries
- **direct-list.txt**: List of domains that should use local (CN) DNS servers
- **apple-cn.txt**: Apple domains for CN region
- **my-domain-list.txt**: Custom domain list
- **proxy-list.txt**: Domains that should use remote DNS servers
- **proxy-ext-list.txt**: Extended GFW domain list
- **reject-list.txt**: Ad/tracking domains to block
- **china-ip-list.txt**: China IP address ranges (CIDR format)
- **white-ip-list.txt**: Whitelisted IP addresses


## License

This example configuration is provided as-is for demonstration purposes.