Linux DNS-resolution is done by the standard library (through functions like getaddrinfo or gethostbyname), unfortunately musl (used by Alpine Linux) doesn't support mdns out-of-the-box.
avahi2dns is a small DNS server which interfaces with avahi (through D-Bus) and forwards (perfect for Alpine Linux and musl)
Requires go 1.26 or later
go build$ ./avahi2dns -h
Usage: avahi2dns [--domains DOMAINS] [--addr ADDR] [--port PORT] [--debug] [--v6only] [--timeout TIMEOUT]
Options:
--domains DOMAINS, -d DOMAINS
list of domains to resolve (e.g. '-d local -d home')
--addr ADDR, -a ADDR address to bind on [default: localhost]
--port PORT, -p PORT port to bind on [default: 53]
--debug, -v also include debug information [default: false]
--v6only, -6 only resolve AAAA records [default: false]
--timeout TIMEOUT, -t TIMEOUT
timeout for the Avahi request, 0 meaning none, see https://pkg.go.dev/time#ParseDuration for units and format [default: 0s]
--help, -h display this help and exitTip
You can also configure the server through environment variables.
By default the server will bind to port 53 on localhost (not accessible outside your computer)
and resolve any domain with the following extensions: home, internal, intranet, lan, local, private, test
$ sudo ./avahi2dns
INFO[0000] starting DNS server addr="localhost:53"
...Settings can be changed through command-line arguments or environment variables:
$ ./avahi2dns -p 5454 -a '0.0.0.0' -d local -d home
or
$ BIND='0.0.0.0' PORT=5454 ./avahi2dns -d local -d homeYou can also use the debug flag if you need more information about what the server is doing (probably overkill):
$ ./avahi2dns -v -p 5454
DEBU[2025-04-07T23:27:41Z]/src/server.go:31 main.NewForwarder() connection to dbus...
DEBU[2025-04-07T23:27:41Z]/src/server.go:37 main.NewForwarder() connection to avahi through dbus...
DEBU[2025-04-07T23:27:41Z]/src/server.go:44 main.NewForwarder() adding dns handler domain=home
...In this example, avahi2dns is run as a background job for the sake of demonstration, don't do that in production (use OpenRC, systemd or similar).
$ sudo ./avahi2dns &
INFO[0000] starting DNS server addr="localhost:53"
$ docker run --rm --entrypoint ash --dns=127.0.0.1 --net=host alpine -c 'apk add iputils && ping your-name-host.local'
fetch https://dl-cdn.alpinelinux.org/alpine/v3.14/main/armv7/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/v3.14/community/armv7/APKINDEX.tar.gz
(1/2) Installing libcap (2.50-r0)
(2/2) Installing iputils (20210202-r0)
Executing busybox-1.33.1-r3.trigger
OK: 4 MiB in 16 packages
INFO[0006] forwarding query to avahi component=main name=your-name-host.local. protocol=0 type=A
INFO[0006] forwarding query to avahi component=main name=your-name-host.local. protocol=1 type=AAAA
PING your-name-host.local (172.16.16.2) 56(84) bytes of data.
64 bytes from 172.16.16.2 (172.16.16.2): icmp_seq=1 ttl=64 time=0.456 ms
64 bytes from 172.16.16.2 (172.16.16.2): icmp_seq=2 ttl=64 time=0.426 ms
64 bytes from 172.16.16.2 (172.16.16.2): icmp_seq=3 ttl=64 time=0.429 ms
64 bytes from 172.16.16.2 (172.16.16.2): icmp_seq=4 ttl=64 time=0.418 msImportant
If you are running avahi2dns within Docker, you will need to run your container with the host network mode (i.e. --net=host) instead of the bridge default.
Feel free to check the Alpine wiki directly for their recommended setup.
Note
Thanks to Willow Barraco, avahi2dns is available through the testing repository of Alpine.
# all those steps require you to be root# add the testing repository, skip if you already have it enabledecho"@testing https://dl-cdn.alpinelinux.org/alpine/edge/testing">> /etc/apk/repositories
apk add avahi2dns@testing
# if you are using openrc
apk add avahi2dns-openrc@testing
# automatically starts avahi2dns at boot
rc-update add avahi2dns
# start it right now as well
rc-service avahi2dns startCheckout the latest release and download the binary corresponding to your architecture.
# make sure to match your system architecture
wget https://github.com/LouisBrunner/avahi2dns/releases/latest/download/avahi2dns-linux-arm64
mv avahi2dns-linux-arm64 /usr/bin/avahi2dnsYou can then setup avahi2dns through OpenRC, systemd or similar. Check this file for an example for the former.