axeleroy/dnsproxy repository overview

⁠DNS Proxy Docker

A dead-simple, multi-arch Docker image for AdguardTeam/dnsproxy⁠. Supports DNS-over-TLS, DNS-over-HTTPS, DNS-over-QUIC and DNSCrypt.

Releases are automated⁠ and published in the 24 hours following a new version of DNS Proxy.

⁠Usage

TL;DR: start the container and put the arguments for the dnsproxy command in the ARGS environment variable. Details on the arguments and examples can be found in the original repo⁠.

⁠Vanilla Docker

docker run -d \
  -e "ARGS=-u 8.8.8.8:53 -u 1.1.1.1:53 --cache" \
  -p 53:53 \
  axeleroy/dnsproxy:latest

⁠Docker Compose

version: "3"
services:
  dnsproxy:
    image: axeleroy/dnsproxy:latest
    environment:
      - ARGS=-u 8.8.8.8:53 -u 1.1.1.1:53 --cache 
    ports:
      - "53:53"

⁠DNS-over-TLS and DNS-over-HTTPS with Pi-hole and unbound

I made an example Docker Compose stack⁠ that shows you how to set up Pi-hole using unbound as its upstream DNS server with DNS-over-TLS and DNS-over-HTTPS capabilities (for using your Pi-hole outside your home on your mobile devices).

⁠Building the image

Simply run the docker build command and specify the desired version in the dnsproxy_version argument.

docker build --build-arg dnsproxy_version=v0.46.5 -t axeleroy/dnsproxy:custom .