jenesequa/chinadns-ng repository overview

⁠Unofficial chinadns-ng Docker Image

This repository provides Docker image for the chinadns-ng⁠ project, a high-performance and feature-rich DNS server written in Zig.

This image is automatically built and updated via GitHub Actions whenever a new version of chinadns-ng is released upstream.

Built from the alpine base image. The final image contains nothing but the single chinadns-ng binary, making it extremely small and secure. Provides images for a wide range of platforms, ready for any device.

⁠Supported Architectures

This image is built for the following platforms:

⁠Usage

⁠Simple docker run Command

To run the chinadns-ng server and expose the DNS ports on your host machine:

docker run -d --name chinadns-ng --restart=unless-stopped \
  -p 53:53/udp \
  -p 53:53/tcp \
  jenesequa/chinadns-ng:latest

⁠Passing Arguments to chinadns-ng

This image uses the chinadns-ng binary as its ENTRYPOINT. Any commands or arguments you append to the docker run command will be passed directly to the binary.

For example, to specify a custom configuration file, you would first need to mount the file into the container:

docker run -d --name chinadns-ng --restart=unless-stopped \
  -p 53:53/udp \
  -p 53:53/tcp \
  jenesequa/chinadns-ng:latest \
  -b 0.0.0.0 -l 53 -d chn -c 1.1.1.1

⁠Using Docker Compose

Here is a sample docker-compose.yml configuration:

services:
  chinadns-ng:
    image: jenesequa/chinadns-ng:latest
    container_name: chinadns-ng
    restart: unless-stopped
    ports:
      - "53:53/udp"
      - "53:53/tcp"
    # To use a custom config file, uncomment the following lines:
    # volumes:
    #   - ./chinadns-ng.conf:/etc/chinadns-ng.conf
    command: ["-b", "0.0.0.0", "-l", "53", "-d", "chn", "-c", "1.1.1.1", "-C", "/etc/chinadns-ng.conf"]

Feel free to open an issue or pull request there if you have any suggestions.