Ovenrack - 🍳🥧

"Keep your pi(e)s warm!""

What is Ovenrack? - ⁉️

A: Ovenrack is a DNS proxy:

|Computer| <----[dns]----> |Ovenrack| <----[dns]----> |DNS Server|

B: Ovenrack can proxy tunnel the DNS over TLS (DoT):

|Computer| <----[dns]----> |Ovenrack| <----[DoT]----> |DNS/DoT Server|

C: Ovenrack can proxy tunnel the DNS over HTTPS (DoH):

|Computer| <----[dns]----> |Ovenrack| <----[DoH]----> |DNS/DoH Server|

D: Ovenrack remembers the queries, and prefetches when the TTL expires:

|Computer| <----[dns]----> |Ovenrack| <----[dns/DoT/DoH]----> |DNS/DoT/DoH Server|
                                ^----------[dns/DoT/DoH]----> |DNS/DoT/DoH Server|

Installation - 📦

1. Download this repo
2. cargo install

Usage - 🖥️

Ovenrack uses the following command line syntax:

Ovenrack 0.1.0
Eric M. <[email protected]>
Keeps your pi(e)S warm!

USAGE:
    ovenrack [FLAGS] [OPTIONS] <SRC> <DEST>

FLAGS:
    -c               Enable prefetch cache
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v               Verbose output

OPTIONS:
    -p, --port <PORT>    Override the default input port [default: 53]

ARGS:
    <SRC>     Source for the requests. Using "-" inputs from stdin. See README for usage.
    <DEST>    Destination for the requests. Using "-" outputs to stdout. See README for usage.

SRC can be one of three formats, which dictate the behavoir:

• -. Takes input in from stdin.
• BIND_IP_ADDRESS, eg. 127.0.0.1. Ovenrack will bind to a port (default 53) and act as a DNS server.

DEST can be one of three formats, which dictate the behavoir:

• -. Outputs to stdout.
• IP_ADDR, eg. 1.1.1.1. Ovenrack will forward DNS traffic to the specified address as plain UDP DNS (DNS).
• IP_ADDR#DOMAIN, eg. 8.8.8.8#dns.google.com. Ovenrack will forward DNS traffic to the specified address + domain as DNS over TLS (DoT).
• https://HOSTNAME, eg. https://cloudflare-dns.com/dns-query. Ovenrack will forward DNS traffic to the specified address + domain as DNS over HTTPS (DoH).

License - ⚖️

See LICENSE.txt.