terafin/nextdns-proxy

Simple NextDNS proxy DNS server that you can run on your local network to proxy all traffic via secure DNS to NextDNS

nextdns-proxy

This is a simple DNS server that wraps up dnsmasq and the nextdns client into a single package

Example usage

Here is an example docker-compose.yml file that will setup three docker services.

1. The autoheal service from willfarrell/autoheal that will kill the container if DNS services fail.
2. The DNS service itself
3. Will auto update nextdns-proxy

version: '2'

services:
  watchtower:
    container_name: watchtower
    restart: always
    image: v2tec/watchtower
    environment:
      WATCHTOWER_CLEANUP: "true"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
  autoheal:
    container_name: autoheal
    image: jstrader/autoheal
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
  nextdns-proxy:
    image: "ghcr.io/terafin/nextdns-proxy:latest"
    container_name: nextdns-proxy
    hostname: nextdns-proxy
    labels:
      autoheal: "true"
    ports:
     - "53:53/udp"
    environment: # Note, these are ALL optional
      NEXTDNS_CONFIG: <<Your NextDNS Config/Endpoint ID here, this can be found on the NextDNS Setup page>
      NEXTDNS_CONFIG_CUSTOM1: <<Your conditional routing pattern here. Documentation here: https://github.com/nextdns/nextdns/wiki/Conditional-Configuration>
      NEXTDNS_CONFIG_CUSTOM2: <<Your conditional routing pattern here. Documentation here: https://github.com/nextdns/nextdns/wiki/Conditional-Configuration>
      NEXTDNS_CONFIG_YOUR_CUSTOM_SUFFIX: <<Your conditional routing pattern here. Documentation here: https://github.com/nextdns/nextdns/wiki/Conditional-Configuration>
      NEXTDNS_FORWARDING_DOMAIN: <<Your Local DNS Name Here, eg: myfancyhome.net>>
      NEXTDNS_FORWARDING_DNSIP: <<Your Local Router's IP Here, eg: 10.0.1.1>>
      NEXTDNS_MAX_TTL: <<Maximum TTL in seconds for hostnames from NextDNS - defaults to 15>>
      NEXTDNS_CACHE_SIZE: <<Cache size for NextDNS - defaults to 10MB>>
    restart: always

To use the compose file, just make it in the directory of your choice, then simply run:

docker-compose up -d

Note, for Raspberry Pi deployment, change the line: image: jstrader/autoheal to be: image: jstrader/autoheal:latest-arm

nextdns-proxy's Issues

Wrong target port in docker-compose example

    ports:
      - "53:53/udp"

should be

    ports:
      - "53:8053/udp"

unless I'm missing something

attach to new container?

Hello,

forgive my ignorance, i got container nextdns-proxy up and running.
now how do i attach it to new container so it will have nextdns?

thanks

examples

I'm running the nextdns-cli on Linux are I'm using the Conditional Configuration. Can you provide an example of how that's done here, ie. syntax:

NEXTDNS_CONFIG_CUSTOM1:

And how would this be used:

NEXTDNS_CONFIG_YOUR_CUSTOM_SUFFIX:

Device names not showing up

For the life of me I can't figure out how to get the device names to show up properly in the logs. Right now they appear as "Device #xxxx."

I've gone as far as modifying the /etc/nextdns.conf file in the Docker container. Here's what it's currently set to, which is a combination of what multiple people on the Internet say resolved their issue:

report-client-info true
detect-captive-portals false
bogus-priv true
control /var/run/nextdns.sock
hardened-privacy false
use-hosts true
setup-router true
auto-activate false
discovery-dns 192.168.4.1
cache-size 0
max-ttl 0s
timeout 5s
listen 192.168.4.32:53
log-queries false
cache-max-age 0s

I'm not an expert at this stuff so pretty sure I'm missing something.