User Tools

Site Tools


DNS over HTTPS with Dnsmasq and https-dns-proxy



  • 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.


Install the packages and DNS encryption should be configured automatically.

# Install packages
opkg update
opkg install dnsmasq https-dns-proxy

LAN clients should use Dnsmasq as a primary resolver. Dnsmasq forwards DNS queries to https-dns-proxy which encrypts DNS traffic.


Verify that domain name resolution works.

nslookup localhost

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

Test DNSSEC validation.


Collect and analyze the following information.

# Restart 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; netstat -l -n -p | grep -e https-dns
# Runtime configuration
pgrep -f -a dnsmasq; pgrep -f -a https-dns
# Persistent configuration
uci show dhcp; uci show https-dns-proxy


Web interface

Install the necessary packages if you want to manage the settings using 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 and Cloudflare DNS by default. You can change it Google DNS or any other DoH provider. Make sure the 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 set https-dns-proxy.dns="https-dns-proxy"
uci set https-dns-proxy.dns.bootstrap_dns=","
uci set https-dns-proxy.dns.resolver_url=""
uci set https-dns-proxy.dns.listen_addr=""
uci set https-dns-proxy.dns.listen_port="5053"
uci commit https-dns-proxy
/etc/init.d/https-dns-proxy 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/09/23 14:39 by vgaetera