OpenWrt Project

User Tools

Site Tools

You are here: Welcome to the OpenWrt Project » Documentation » User guide » Additional Services » DNS (aka Domain Name System) » DNS over HTTPS with Dnsmasq and https-dns-proxy
en
 ?

Sidebar

docs:guide-user:services:dns:doh_dnsmasq_https-dns-proxy

Table of Contents

DNS over HTTPS with Dnsmasq and https-dns-proxy

This article relies on the following:

Introduction

Goals

  • Encrypt your DNS traffic improving security and privacy.
    • Prevent DNS leak and DNS hijacking.
  • Bypass regional restrictions using public DNS providers.
    • Escape DNS-based content filters and internet censorship.

Instructions

Enable split DNS mode to encrypt LAN client DNS traffic assuming that local system traffic does not involve private data.

Use https-dns-proxy to encrypt DNS traffic. Configure Dnsmasq to forward DNS queries to https-dns-proxy. Enforce DNS encryption for LAN clients to avoid DNS leak. 

# Install packages
opkg update
opkg install dnsmasq https-dns-proxy
 
# Enable DNS encryption
uci -q delete dhcp.@dnsmasq[0].server
DOHPROXY_ADDR="$(uci get https-dns-proxy.@https-dns-proxy[0].listen_addr)"
DOHPROXY_PORT="$(uci get https-dns-proxy.@https-dns-proxy[0].listen_port)"
DOHPROXY_SERV="${DOHPROXY_ADDR//[][]/}#${DOHPROXY_PORT}"
uci add_list dhcp.@dnsmasq[0].server="${DOHPROXY_SERV}"
 
# Enforce DNS encryption for LAN clients
uci set dhcp.@dnsmasq[0].noresolv="1"
uci commit dhcp
/etc/init.d/dnsmasq restart

Testing

Verify that domain name resolution works. 

nslookup openwrt.org localhost

Check your DNS provider. Make sure there is no DNS leak.

Test DNSSEC validation.

Troubleshooting

Collect and analyze the following information. 

# Restart the services
/etc/init.d/log restart; /etc/init.d/dnsmasq restart; /etc/init.d/https_dns_proxy restart
 
# Log and status
logread -e dnsmasq; netstat -l -n -p | grep -e dnsmasq
logread -e https_dns_proxy; netstat -l -n -p | grep -e https_dns
 
# Runtime configuration
pgrep -f -a dnsmasq; pgrep -f -a https_dns_proxy
 
# Persistent configuration
uci show dhcp; uci show https_dns_proxy

Extras

Web interface

Install the necessary packages if you want to manage the settings via web interface. 

# Install packages
opkg update
opkg install luci-app-https-dns-proxy
  • Navigate to LuCI → Network → DHCP and DNS to configure Dnsmasq.
  • Navigate to LuCI → Services → HTTPS DNS Proxy to configure https-dns-proxy.

DoH provider

https-dns-proxy is configured with Google DNS & Cloudflare DNS by default with Google taking precedent. You can change it to another DoH provider. Make sure selected provider supports DNSSEC validation if required. Specify several servers to improve fault tolerance. 

# Configure DoH provider
while uci -q delete https-dns-proxy.@https-dns-proxy[0]; do :; done
uci add https-dns-proxy https-dns-proxy
uci set https-dns-proxy.@https-dns-proxy[-1]=https-dns-proxy
uci set https-dns-proxy.@https-dns-proxy[-1].bootstrap_dns='1.1.1.1,1.0.0.1'
uci set https-dns-proxy.@https-dns-proxy[-1].resolver_url='https://cloudflare-dns.com/dns-query'
uci set https-dns-proxy.@https-dns-proxy[-1].listen_addr='127.0.0.1'
uci set https-dns-proxy.@https-dns-proxy[-1].listen_port='5053'
uci set https-dns-proxy.@https-dns-proxy[-1].user='nobody'
uci set https-dns-proxy.@https-dns-proxy[-1].group='nogroup'
uci set https-dns-proxy.@https-dns-proxy[-1].ipv4_resolvers='1'
uci set https-dns-proxy.@https-dns-proxy[-1].verbosity='0'
uci commit https-dns-proxy
/etc/init.d/https-dns-proxy restart

Local system

Local system does not use Dnsmasq as a primary resolver when DNS encryption is enabled. Enforce Dnsmasq as a primary resolver to provide DNS encryption for local system. Bypass DNS encryption for NTP provider to avoid deadlock state when system time is not synchronized. Beware of race condition with Adblock service. 

# Enforce DNS encryption for local system
uci set dhcp.@dnsmasq[0].localuse="1"
 
# Fetch DNS provider
. /lib/functions/network.sh
network_flush_cache
network_find_wan NET_IF
network_find_wan6 NET_IF6
network_get_dnsserver NET_DNS "${NET_IF}"
network_get_dnsserver NET_DNS6 "${NET_IF6}"
 
# Bypass DNS encryption for NTP provider
uci get system.ntp.server \
| sed -e "s/\s/\n/g" \
| sed -e "s/^[0-9]*\.//" \
| sort -u \
| while read -r NTP_DOMAIN
do
uci add_list dhcp.@dnsmasq[0].server="/${NTP_DOMAIN}/${NET_DNS%% *}"
uci add_list dhcp.@dnsmasq[0].server="/${NTP_DOMAIN}/${NET_DNS6%% *}"
done
uci commit dhcp
/etc/init.d/dnsmasq restart
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/guide-user/services/dns/doh_dnsmasq_https-dns-proxy.txt · Last modified: 2020/01/10 04:32 by rahulpatel

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki