Unifi USG – DNS Namen

Obgleich die USG mit dem DNSMASq einen vollwertigen DNS Server hat, kann man mit der Oberfläche keine DNS Einträge erzeugen.

Auch hier ist man (wieder einmal) auf die config-Datei angewiesen, wenn man statische oder zusätzliche DNS Einträge (oder weitere CNAMEs) lokal nutzen möchte.

Für die entsprechenden Regeln muss man sich wieder auf dem UniFi Controller per SSH einloggen und dann im Basis-Pfad für die zu konfigurierende „Site“ eine Datei config.gateway.json anlegen/pflegen. Auf meinem Unifi CloudKey Gen2+ ist das die default-Site, so dass das Verzeichnis dafür /srv/unifi/data/sites/default ist.

Um die entsprechenden Regeln zu hinterlegen braucht man die IP-Adresse des Gerätes im Netzwerk und den gewünschten Domain-Namen. In dem hier gezeigten Fall sind das für mein Netzwerk 10.0.0.99 (die IP meines Beispiel-Devices) und sample.my.lan als Domainnamen. Die DNS-Regeln werden unter „Syste,“ -> „static-host-mapping“ -> „host-name“ eingerichtet und sehen bei mir wie folgt aus:

{"system": {
        "static-host-mapping": {
              "host-name": {
                      "sample.my.lan": {
                              "alias": [
                                      "sample"
                              ],
                              "inet": [
                                      "10.0.0.99"
                              ]
                      }
              }
}

Die Regel sorgt nun (nach expliziter Provisionierung an die USG über die Oberfläche) dafür, dass alle DNS Anfragen für sample.my.lan auf die IP-Adresse 10.0.0.99 aufgelöst werden.