User Tools

Site Tools


docs:guide-user:network:zeroconfig:zeroconf

Zero configuration networking in OpenWrt

Zero-configuration networking (zeroconf) is a methodology and a set of special technologies that automatically creates a usable computer network based on the Internet Protocol Suite (TCP/IP) when computers or network peripherals are interconnected. It does not require manual operator intervention or special configuration servers. Zeroconf

Zeroconf (aka bonjour) can be used for ad-hoc networks and internal service announcements (mDNS) without the need to configure DHCP and DNS servers. All zeroconf enabled devices such as printers, scanners, wireless speakers, chromecast devices etc. automatically answer to zeroconf enabled clients via IPv4 or IPv6 multicast messages without a central registry. Therefore, it is only required to install a zeroconf solution on your OpenWrt router if you have one of the following use-cases:

  • publish services though zeroconf that are not zeroconf enabled
  • automatically assign a link local IP address without the need for a DHCP server
  • configure conventional DNS servers using mDNS in a DHCP-like fashion

If you cannot discover an existing zeroconf service on your local network this is typically due to a multicast issue on layer 2. Sometimes the bridge between your LAN and your WLAN will block multicast packets. Also managed Ethernet switches can limit/block multicast packets by default. Unless you have specific use-cases like multicast video-streaming it is recommended to disable IGMP-snooping as this will ensure that multicast packets are treated like broadcast packages.

OpenWrt offers several different packages supporting the different zeroconf implementations:

  • Avahi (Linux) - avahi-daemon-service-ssh, avahi-daemon-service-http, avahi-utils, avahi-autoipd, avahi-dnsconfd
  • Bonjour (Apple) - mdnsresponder, mdnsd
  • umdns (OpenWrt own package)
  • Zeroconf/UPnP SSDP (Microsoft, incompatible with mDNS)

:!: Many programs can be compiled with zeroconf support. However due to size restrictions this support is most likely deactivated by default. Compile your own image.

:!: Umdns is not only zeroconf but currently also (almost) zerodoc and work in progress.

:!: Currently there is little DNS-SD support on Windows, since it uses incompatible UPnP SSDP.

:!: The .local domain is reserved for (zeroconfig) multicast dns rfc6762, .local. Watch out for conflicts with your Dnsmasq configuration

umdns

In OpenWrt since r41345

If you want your device to be discoverable in your network, you must define a hostname for it under /etc/config/system

 option hostname 'your_openwrt_device'

Even if the service comes with the base install, it must be enabled and started:

# /etc/init.d/umdns enable
# /etc/init.d/umdns start
 umdns: add the new openwrt mdns daemon

this is still wip, you can use the following ubus calls.

ubus call umdns update # triggers a scan
ubus call umdns browse # look at the currenlty cached records
ubus call umdns hosts # look at the currenlty cached hosts

avahi

avahi-daemon: mDNS daemon avahi-utils: lookup utility avahi-browse

In order to announce http and ssh services to the network, do:

opkg update
opkg install avahi-daemon-service-ssh avahi-daemon-service-http

mdnsresponder

Install the mdnsresponder package:

# opkg update
# opkg install mdnsresponder

Edit the /etc/mDNSResponder.conf file, which contains a list of service descriptions:

"SSH Service"
_ssh._tcp. local
22
Local SSH Service

"Web Service"
_http._tcp. local
80
Local Web Service

Once all your services are configured, you can enable and start the mDNSResponder:

# /etc/init.d/mDNSResponder enable
# /etc/init.d/mDNSResponder start
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/guide-user/network/zeroconfig/zeroconf.txt · Last modified: 2020/07/26 17:27 by lorenzofh