HomeDNS

A toy DNS server supports local record and query forwarding.
Now it supports a few query types includes

• A
• AAAA
• CNAME
• NS
• MX

And it support normal plain-text DNS to DoT/DoH forwarding. You can use it as a DoT/DoH proxy with configuration.

Requirements

• Python 3.8 or above

To do

• DoT
• DoH (GET Only)
• Optimization

Usage

Please be sure that you have installed sqlite3, for Ubuntu users

sudo apt-get install sqlite3

then,

# install dependencies
pip install -r requirements.txt
# initialize database
mkdir data && sqlite3 data/dns_records.db < scripts/schema.sql

now you can insert your own entries with sqlite3

sqlite3 data/dns_records.db < "INSERT INTO RECORDS ( DOMAIN, RECORD_TYPE, VALUE)
VALUES ( 'test.com', 1, '1.1.1.1');"

edit configuration dns_config.py, for example

config = Config(
    roots=[
        ("192.168.102.81", None),
        ("114.114.114.114", None),
    ],
    db_path="data/dns_records.db",
    # when encrypted_roots in set, only encrpted roots take effect not unencrpted roots.
    # encrypted_roots=[("1.1.1.1", "cloudflare-dns.com", "DoT"),
    #                   ("1.1.1.1", "cloudflare-dns.com", "DoH")], 
    client_denylist=[
        ("192.168.56.103", "*"),
        ("192.168.56.102", "A"),
    ],
)

After adding some DNS rule, you can start the DNS server. It listens on 8053 by default.

python main.py --port=<port>

Learn More About DNS

CLOUDFLARE DNS
RFC 1035
CLOUDFLARE DoT/DoH
Google DNS DoH