NextDNS CLI (official build) running on Alpine. Automatically updated.
50K+
THIS REPOSITORY IS DEPRECATED.
Since NextDNS v1.44.4, the team has been publishing official Docker images.
Use nextdns/nextdns instead.
Read the wiki for more information on usage.
This is a simple Docker image that allows you to containerize your NextDNS CLI client.
Tags will be automatically published under matching versions as upstream releases happen.
You can pass what you would use with arguments as environment variables to the container.
Make sure to prefix all variables with NEXTDNS_, where NEXTDNS_PROFILE=xxxxxx would become -profile=xxxxxx to the CLI.
In addition, in order to support
Conditional Profiles and
Split Horizon/Conditional Forwarders,
you can also use NEXTDNS_PROFILE_$NAME or NEXTDNS_FORWARDER_$NAME to pass additional settings
(where $NAME is a personal identifier, and is not passed to the CLI.)
To start it, it's how you would usually do it:
docker pull jedayoshi/nextdns:latest
docker run -d --name nextdns --restart always -p "53:53/tcp" -p "53:53/udp" --env "NEXTDNS_PROFILE=xxxxxx" --env "NEXTDNS_CACHE_SIZE=10m" --env "NEXTDNS_REPORT_CLIENT_INFO=true" jedayoshi/nextdns:latest"
Or, use docker-compose! Here's an example:
version: "3"
services:
nextdns:
container_name: "nextdns"
image: "jedayoshi/nextdns:latest"
restart: "always"
ports:
- "53:53/tcp"
- "53:53/udp"
environment:
NEXTDNS_PROFILE: "xxxxxx"
NEXTDNS_CACHE_SIZE: "10m"
NEXTDNS_REPORT_CLIENT_INFO: "true"
# Warning: This WILL use your DNS query quota. Since its TTL is 300s,
# each check will be 1 query against your quota every 5 minutes. Enable carefully.
#healthcheck:
# test: [
# "CMD", "sh", "-c",
# "dig +time=10 @127.0.0.1 -p $$(echo $${NEXTDNS_LISTEN:-:53} | rev | cut -d: -f1 | rev) probe-test.dns.nextdns.io"
# ]
# interval: "1m"
# timeout: "10s"
# retries: 1
# start_period: "5s"
--use-hosts disabled by default?Because all what the /etc/hosts from the container contains is your usual
stuff plus the container name, and I'd rather avoid conflicts than to risk myself.
However, nothing stops you from using NEXTDNS_USE_HOSTS=true and
mounting your /etc/hosts from your host system as a volume:
version: "3"
services:
nextdns:
container_name: "nextdns"
image: "jedayoshi/nextdns:latest"
restart: "always"
ports:
- "53:53/tcp"
- "53:53/udp"
environment:
NEXTDNS_PROFILE: "xxxxxx"
NEXTDNS_PROFILE_HOME: "192.168.0.0/24=aaaaaa"
NEXTDNS_PROFILE_OFFICE: "10.18.0.0/16=wwwwww"
NEXTDNS_CACHE_SIZE: "10m"
NEXTDNS_REPORT_CLIENT_INFO: "true"
NEXTDNS_USE_HOSTS: "true"
volumes:
- "/etc/hosts:/etc/hosts:ro"
Unlicense for the docker-entrypoint.sh script, since it's rather minimal.
NextDNS CLI is licensed under the MIT License.
Content type
Image
Digest
sha256:1d9558a3c…
Size
11.5 MB
Last updated
over 1 year ago
docker pull jedayoshi/nextdns