https://github.com/containers/aardvark-dns

Authoritative dns server for A/AAAA container records. Forwards other request to host's /etc/resolv.conf
https://github.com/containers/aardvark-dns

container coredns dns dns-server dnsmasq name-resolution nameserver

Last synced: 2 days ago
JSON representation

Authoritative dns server for A/AAAA container records. Forwards other request to host's /etc/resolv.conf

• Host: GitHub
• URL: https://github.com/containers/aardvark-dns
• Owner: containers
• License: apache-2.0
• Created: 2021-12-08T18:11:42.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-05T20:07:03.000Z (3 days ago)
• Last Synced: 2024-11-05T21:19:37.178Z (3 days ago)
• Topics: container, coredns, dns, dns-server, dnsmasq, name-resolution, nameserver
• Language: Rust
• Homepage:
• Size: 12.6 MB
• Stars: 186
• Watchers: 10
• Forks: 32
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE-OF-CONDUCT.md

Awesome Lists containing this project

• awesome-starred - containers/aardvark-dns - Authoritative dns server for A/AAAA container records. Forwards other request to host's /etc/resolv.conf (others)

README

        
# aardvark-dns

Aardvark-dns is an authoritative dns server for `A/AAAA` container records. It can forward other requests

to configured resolvers.

Read more about configuration in `src/backend/mod.rs`. It is mostly intended to be used with

[Netavark](https://github.com/containers/netavark/) which will launch it automatically if both are

installed.

```console

aardvark-dns 0.1.0

USAGE:

    aardvark-dns [OPTIONS] 

FLAGS:

    -h, --help       Print help information

    -V, --version    Print version information

OPTIONS:

    -c, --config     Path to configuration directory

    -p, --port         Host port for aardvark servers, defaults to 5533

SUBCOMMANDS:

    help    Print this message or the help of the given subcommand(s)

    run     Runs the aardvark dns server with the specified configuration directory

```

### MSRV (Minimum Supported Rust Version)

v1.76

We test that Netavark can be build on this Rust version and on some newer versions.

All newer versions should also build, and if they do not, the issue should be

reported and will be fixed. Older versions are not guaranteed to build and issues

will not be fixed.

### Build

```console

make

```

### Run Example

```console

RUST_LOG=trace ./bin/aardvark-dns --config src/test/config/podman/ --port 5533 run

```

### [Configuration file format](./config.md)