README.md

DoH - Deploy to Cloudflare Workers

DNS over HTTPS

• Using DNS Wireformat: https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-wireformat/

  • GET

  curl -H 'accept: application/dns-message' -v 'https://cloudflare-dns.com/dns-query?dns=q80BAAABAAAAAAAAA3d3dwdleGFtcGxlA2NvbQAAAQAB' | hexdump

  • POST

  echo -n 'q80BAAABAAAAAAAAA3d3dwdleGFtcGxlA2NvbQAAAQAB' | base64 --decode | curl -H 'content-type: application/dns-message' --data-binary @- https://cloudflare-dns.com/dns-query -o - | hexdump

• using JSON: https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/

  • GET

  curl -H "accept: application/dns-json" "https://cloudflare-dns.com/dns-query?name=example.com&type=AAAA"

Setup

• prequirements

brew install bun
brew install just
gem install envify

• setup .env (see .env.example)

  optional

envify g

• install wrangler

bun install

• Test in local and Deploy to Cloudflare

just dev

just test

just deploy

Read the latest worker crate documentation here: https://docs.rs/worker