Verwalten der Zonendaten: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
KKeine Bearbeitungszusammenfassung
 
(58 dazwischenliegende Versionen von 11 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{HSDoku-Links}}
{{Kerndoku|https://www.hostsharing.net/doc/managed-operations-platform/zonefile/}}


Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service ([[DNS]]), d.h. der [[Nameserver]] der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen. Für einfache und unkomplizierte Änderungen bitte in [[Simple Zonefile Howto]] schauen.


Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.
{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}
 
== Aktives Zonefile ==
 
Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden ([[Zonefile]]).
 
Im Standardfall sieht es vollständig expandiert wie folgt aus:
 
<syntaxhighlight lang=shell line>
example.com.    IN    SOA        h00.hostsharing.net. hostmaster.hostsharing.net. (
                1303649373      ; serial secs since Jan 1 1970
                6H              ; refresh (>=10000)
                1H              ; retry (>=1800)
                1W              ; expire
                1H              ; minimum
)
 
example.com.    IN      NS      dns1.hostsharing.net.
example.com.    IN      NS      dns2.hostsharing.net.
example.com.    IN      NS      dns3.hostsharing.net.
 
example.com.    IN      MX      30 mailin1.hostsharing.net.
example.com.    IN      MX      30 mailin2.hostsharing.net.
example.com.    IN      MX      30 mailin3.hostsharing.net.
 
example.com.    IN      A      83.223.95.160
example.com.    IN      AAAA    2a01:37:1000::53df:5fa0:0
 
example.com.    IN      TXT    "v=spf1 include:spf.hostsharing.net ?all"
 
*.example.com.  IN      MX      30 mailin1.hostsharing.net.
*.example.com.  IN      MX      30 mailin2.hostsharing.net.
*.example.com.  IN      MX      30 mailin3.hostsharing.net.
 
*.example.com.  IN      A      83.223.95.160
*.example.com.  IN      AAAA    2a01:37:1000::53df:5fa0:0
 
*.example.com.  IN      TXT    "v=spf1 include:spf.hostsharing.net ?all"
</syntaxhighlight>
 
== Logfile und Kontrolle==
 
Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:
 
<syntaxhighlight lang=output>
Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN':
AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN':
AXFR-style IXFR started
</syntaxhighlight>
 
Die Zeilen bedeuten jeweils:
 
* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
 
Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.
 
<syntaxhighlight lang=output line>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100


{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}
Moin Moin,
 
aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.
 
Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!
 
Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:
 
tail -f /var/log/named/named.log
 
oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:
 
tail -f /var/log/named/named.log | grep example.com


Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.


{{Textkasten|rot|Achtung|Das Standardzonefile und die gültigen Platzhalter ändern sich in Kürze. Die Dokumentation wird derzeit aktualisiert.}}
Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:


dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'


== aktives Zonefile ==
grep serial /etc/bind/pri.example.com | awk '{ print $1 }' 
</syntaxhighlight>


Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).
== Eigenes Zonenfile ==


Es sieht standardmäßig in etwa wie folgt aus:
Wer ein eigenes Zonefile installieren möchte, um diverse Anwendungsfälle zu realisieren (Verweise auf extern gelagerte Subdomains, Anbindung externer Server, Verwendung eigener Mailserver), kann '''pro Domain''' ein eigenes Zonefile erstellen. Dieses befindet sich im Verzeichnis '''~/doms/example.com/etc''' mit den Namen '''pri.example.com''' (example.com steht hier als Beispiel für den wahren Domainnamen). Ein Neuanlegen oder eine Änderung dieser Datei führt zu einer baldigen Änderung der Nameservereinträge für die Domain.


<pre><nowiki>
{{Textkasten|rot|Warnung!|Das nicht sachgemäße Erstellen eines eigenen Zonefiles kann zur Nichterreichbarkeit der eigenen Domain und zum Verlust von Mails führen!}}
$TTL 6H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
1242748945 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)


IN NS dns1.hostsharing.net.
Eine Anleitung für die eher einfachen und oft gewünschten Änderungen findet sich in [[Simple Zonefile Howto]].
IN NS dns2.hostsharing.net.
IN NS dns3.hostsharing.net.


IN MX 30 mailin.hostsharing.net.
Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern der DNS-Konfiguration, ohne dass der Domain-Admin sein Zonefile anpassen muss.
* IN MX 30 mailin.hostsharing.net.


IN A 83.223.95.30
=== Komplexe Platzhalter ===
*              IN A 83.223.95.30


</nowiki></pre>
<syntaxhighlight lang="shell" line>
{DEFAULT_ZONEFILE} :=
{HEADER}
{SOA_RR}
{NS_RR}
{MX_RR}
{A_RR}
{WILDCARD_MX_RR}
{WILDCARD_A_RR}


Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} (s. unten) eingetragen wird.
{HEADER} :=
$TTL {TTL}


== Änderungen ==
{SOA_RR} :=
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)


Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis <tt>etc</tt> der Domain abzulegen.
{NS_RR} :=
{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.


Am besten man beginnt mit der folgenden universellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatisch durch die aktuellen Werte ersetzt werden:
{MX_RR} :=
{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.


<pre>
{A_RR} :=
$TTL {TTL}
{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
                {SIO} ; serial secs since Jan 1 1970
                6H              ; refresh (>=10000)
                1H              ; retry (>=1800)
                1W              ; expire
                1H              ; minimum
                        )


                        IN     NS      {HS_DNS1_HOSTNAME}.
{WILDCARD_MX_RR} :=
                        IN     NS      {HS_DNS2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
                        IN     NS      {HS_DNS3_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.


                        IN      MX  30  {MX_HOSTNAME}.
{WILDCARD_A_RR} :=
*                       IN     MX  30  {MX_HOSTNAME}.
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</syntaxhighlight>


                        IN      A      {DOM_IPNUMBER}
=== Atomare Platzhalter ===
*                      IN      A      {DOM_IPNUMBER}
</pre>


Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.
<syntaxhighlight lang="shell" line>
{TTL} := 6H
{SOA_HOSTNAME} := <HIVE>.hostsharing.net
{SOA_EMAIL}:= hostmaster.hostsharing.net
{SIO} := <SEKUNDEN>
{REFRESH} := 6H
{RETRY} := 1H
{EXPIRE} := 1W
{MINIMUM} := 1H


Beispiele:
{DNS1_HOSTNAME} := dns1.hostsharing.net
; externe Server per "CNAME Record" eintragen
{DNS2_HOSTNAME} := dns2.hostsharing.net
wackelserver          IN    CNAME    server0815.massenhoster-domain.tld
{DNS3_HOSTNAME} := dns3.hostsharing.net
homeip                IN    CNAME    mein-nick.dyn-ip-service.tld


; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
{MX1_HOSTNAME} := mailin1.hostsharing.net
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
{MX2_HOSTNAME} := mailin2.hostsharing.net
www                      IN      NS      {HS_DNS1_HOSTNAME}.
{MX3_HOSTNAME} := mailin3.hostsharing.net
www                      IN      NS      {HS_DNS2_HOSTNAME}.
www                      IN      NS      {HS_DNS3_HOSTNAME}.


soll statt www eine subdomain deligiert werden muss dieser Eintrag am Ende der pri.example.com Datei stehen, also nach:
{DOM_HOSTNAME} := <FQDN>
*.{DOM_HOSTNAME}.      IN      A      {DOM_IPNUMBER}
{DOM_IPNUMBER} := <IP>


Danach legt man im Zielpaket die Subdomain an:
{DKIM_RR}      :=      <siehe https://wiki.hostsharing.net/index.php?title=DKIM>
hsadmin -c domain.add -s name=subdomain.example.tld -s user=xyz12
{SPF_RR}      :=      "v=spf1 include:spf.hostsharing.net ?all"
</syntaxhighlight>


Nach einer Änderung an einem selbstverwalteten Zonefile dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)
Hierbei stehen
* <Sekunden> für die Anzahl der Sekunden, welche seit dem 01.01.1970 vergangen sind
* <FQDN> für den vollständigen, qualifizierten Domainnamen der Domain
* <IP> für die der Domain zugewiesene IP-Adresse


'''Hinweis:'''
Diese Werte werden von Hostsharing verwaltet.


Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:
=== Expansion der Platzhalter ===


echo -n >  /home/doms/example.org/etc/pri.example.org
Der Platzhalter für das Gesamtzonefile {DEFAULT_ZONFILE} wird folgermaßen expandiert.


Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!
Zunächst werden die komplexen Platzhalter ersetzt:


== Logfile und Kontrolle==
<syntaxhighlight lang="shell" line>
$TTL {TTL}


Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)


  Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
  Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
  Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN':
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.
  AXFR-style IXFR started
  Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN':
  AXFR-style IXFR started


Die Zeilen bedeuten jeweils:
{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.


* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)


Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.
*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.


<code>
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
  -------- Original-Nachricht --------
</syntaxhighlight>
  Betreff: [Global] DNS Zonenfile Änderungen
  Datum: Thu, 4 Mar 2010 08:30:34 +0100
 
  Moin Moin,
 
  aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
  Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
  später dann sind die Domains nicht mehr erreichbar und es heißt "in den
  letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
  auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
  "mal eben schnell noch ... " ging.
 
  Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
  die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
  noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
  sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!
 
  Was also tun? Zunächst kann man nach einer Änderung in einer
  Shell beobachten, ob es zu Fehlermeldungen kommt:
 
  tail -f /var/log/named/named.log
 
  oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
  vorkommt:
 
  tail -f /var/log/named/named.log | grep example.com
 
  Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
  Server lesbar.
 
  Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
  aktuellen in der Zonendatei verglichen werden:
 
  dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'
 
  grep serial /etc/bind/pri.example.com | awk '{ print $1 }
</code>


== Platzhalter für eigene Zonenfiles ==
Anschließend werden die atomaren Platzhalter ersetzt:


Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP-Adressen und Hostnamen, ohne daß jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.
<syntaxhighlight lang="shell" line>
$TTL 6H


<FQDN>. IN SOA <HIVE>.hostsharing.net. hostmaster.hostsharing.net. (
<SEKUNDEN> ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)


; {PAC_IPNUMBER} : IP-Nummer des [[Paket]]s
<FQDN>. IN NS dns1.hostsharing.net.
; {PAC_HOSTNAME} : Hostname des ([[Paket]])s
<FQDN>. IN NS dns2.hostsharing.net.
; {DOM_IPNUMBER} : IP-Nummer der [[Domain]]
<FQDN>. IN NS dns3.hostsharing.net.
; {DOM_HOSTNAME} : Hostname der [[Domain]]
; {PAC_DNS_MASTER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}


; {TTL}
<FQDN>. IN MX 30 mail1.hostsharing.net.
; {SIO} : Timestamp (Millisekunden)
<FQDN>. IN MX 30 mail2.hostsharing.net.
<FQDN>. IN MX 30 mail3.hostsharing.net.


; {MX_HOSTNAME}
<FQDN>. IN A <IP>


Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.  
*.<FQDN>. IN MX 30 mail1.hostsharing.net.
*.<FQDN>. IN MX 30 mail2.hostsharing.net.
*.<FQDN>. IN MX 30 mail3.hostsharing.net.


Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.
*.<FQDN>. IN A <IP>
</syntaxhighlight>


== Beispiele ==
== Das Zonefile deaktivieren/zurücksetzen ==


=== Domain Delegation ===
In ~/doms/example.com/etc das vorhandene Zonefile (pri.example.com) komplett leeren (ist dann 0 Bytes groß). Dann kommt der Robot vorbei, löscht pri.example.com und setzt alles auf Standardwerte zurück.
HowTo: erläutern.


<pre>
[...]
pic.example.org. IN NS {HS_DNS1_HOSTNAME}.
pic.example.org. IN NS {HS_DNS2_HOSTNAME}.
pic.example.org. IN NS {HS_DNS3_HOSTNAME}.
</pre>
----
----
[[Kategorie:HSDoku]]
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Domains]]
[[Kategorie:ToDo-Kerndoku]]
[[Kategorie:Zonefile]]
[[Kategorie:DNS]]

Aktuelle Version vom 20. Juni 2024, 13:26 Uhr




Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen. Für einfache und unkomplizierte Änderungen bitte in Simple Zonefile Howto schauen.

Achtung

Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!


Aktives Zonefile

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Im Standardfall sieht es vollständig expandiert wie folgt aus:

example.com.    IN     SOA        h00.hostsharing.net. hostmaster.hostsharing.net. (
                1303649373      ; serial secs since Jan 1 1970
                6H              ; refresh (>=10000)
                1H              ; retry (>=1800)
                1W              ; expire
                1H              ; minimum
)

example.com.    IN      NS      dns1.hostsharing.net.
example.com.    IN      NS      dns2.hostsharing.net.
example.com.    IN      NS      dns3.hostsharing.net.

example.com.    IN      MX      30 mailin1.hostsharing.net.
example.com.    IN      MX      30 mailin2.hostsharing.net.
example.com.    IN      MX      30 mailin3.hostsharing.net.

example.com.    IN      A       83.223.95.160
example.com.    IN      AAAA    2a01:37:1000::53df:5fa0:0

example.com.    IN      TXT     "v=spf1 include:spf.hostsharing.net ?all"

*.example.com.  IN      MX      30 mailin1.hostsharing.net.
*.example.com.  IN      MX      30 mailin2.hostsharing.net.
*.example.com.  IN      MX      30 mailin3.hostsharing.net.

*.example.com.  IN      A       83.223.95.160
*.example.com.  IN      AAAA    2a01:37:1000::53df:5fa0:0

*.example.com.  IN      TXT     "v=spf1 include:spf.hostsharing.net ?all"

Logfile und Kontrolle

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN': 
AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN': 
AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

  • Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
  • Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log 

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'

Eigenes Zonenfile

Wer ein eigenes Zonefile installieren möchte, um diverse Anwendungsfälle zu realisieren (Verweise auf extern gelagerte Subdomains, Anbindung externer Server, Verwendung eigener Mailserver), kann pro Domain ein eigenes Zonefile erstellen. Dieses befindet sich im Verzeichnis ~/doms/example.com/etc mit den Namen pri.example.com (example.com steht hier als Beispiel für den wahren Domainnamen). Ein Neuanlegen oder eine Änderung dieser Datei führt zu einer baldigen Änderung der Nameservereinträge für die Domain.

Warnung!

Das nicht sachgemäße Erstellen eines eigenen Zonefiles kann zur Nichterreichbarkeit der eigenen Domain und zum Verlust von Mails führen!


Eine Anleitung für die eher einfachen und oft gewünschten Änderungen findet sich in Simple Zonefile Howto.

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern der DNS-Konfiguration, ohne dass der Domain-Admin sein Zonefile anpassen muss.

Komplexe Platzhalter

{DEFAULT_ZONEFILE} :=
	{HEADER}
	{SOA_RR}
	{NS_RR}
	{MX_RR}	
	{A_RR}
	{WILDCARD_MX_RR}
	{WILDCARD_A_RR}

{HEADER} :=
	$TTL {TTL}

{SOA_RR} :=
	{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
		{SIO}		; serial secs since Jan 1 1970
		{REFRESH}	; refresh (>=10000)
		{RETRY}		; retry (>=1800)
		{EXPIRE}	; expire
		{MINIMUM}	; minimum
		)

{NS_RR} :=
	{DOM_HOSTNAME}.		IN	NS	{DNS1_HOSTNAME}.
	{DOM_HOSTNAME}.		IN	NS	{DNS2_HOSTNAME}.
	{DOM_HOSTNAME}.		IN	NS	{DNS3_HOSTNAME}.

{MX_RR} :=
	{DOM_HOSTNAME}.		IN	MX	30 {MX1_HOSTNAME}.
	{DOM_HOSTNAME}.		IN	MX	30 {MX2_HOSTNAME}.
	{DOM_HOSTNAME}.		IN	MX	30 {MX3_HOSTNAME}.

{A_RR} :=
	{DOM_HOSTNAME}.		IN	A	{DOM_IPNUMBER}

{WILDCARD_MX_RR} :=
	*.{DOM_HOSTNAME}.	IN	MX	30 {MX1_HOSTNAME}.
	*.{DOM_HOSTNAME}.	IN	MX	30 {MX2_HOSTNAME}.
	*.{DOM_HOSTNAME}.	IN	MX	30 {MX3_HOSTNAME}.

{WILDCARD_A_RR} :=
	*.{DOM_HOSTNAME}.	IN	A	{DOM_IPNUMBER}

Atomare Platzhalter

{TTL} :=		6H
{SOA_HOSTNAME} :=	<HIVE>.hostsharing.net
{SOA_EMAIL}:=		hostmaster.hostsharing.net
{SIO} :=		<SEKUNDEN>
{REFRESH} :=		6H
{RETRY} :=		1H
{EXPIRE} :=		1W
{MINIMUM} :=		1H

{DNS1_HOSTNAME} :=	dns1.hostsharing.net
{DNS2_HOSTNAME} :=	dns2.hostsharing.net
{DNS3_HOSTNAME} :=	dns3.hostsharing.net

{MX1_HOSTNAME} :=	mailin1.hostsharing.net
{MX2_HOSTNAME} :=	mailin2.hostsharing.net
{MX3_HOSTNAME} :=	mailin3.hostsharing.net

{DOM_HOSTNAME} :=	<FQDN>
{DOM_IPNUMBER} := 	<IP>

{DKIM_RR}      :=       <siehe https://wiki.hostsharing.net/index.php?title=DKIM>
{SPF_RR}       :=       "v=spf1 include:spf.hostsharing.net ?all"

Hierbei stehen

  • <Sekunden> für die Anzahl der Sekunden, welche seit dem 01.01.1970 vergangen sind
  • <FQDN> für den vollständigen, qualifizierten Domainnamen der Domain
  • <IP> für die der Domain zugewiesene IP-Adresse

Diese Werte werden von Hostsharing verwaltet.

Expansion der Platzhalter

Der Platzhalter für das Gesamtzonefile {DEFAULT_ZONFILE} wird folgermaßen expandiert.

Zunächst werden die komplexen Platzhalter ersetzt:

$TTL {TTL}

{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
	{SIO}		; serial secs since Jan 1 1970
	{REFRESH}	; refresh (>=10000)
	{RETRY}		; retry (>=1800)
	{EXPIRE}	; expire
	{MINIMUM}	; minimum
	)

{DOM_HOSTNAME}.		IN	NS	{DNS1_HOSTNAME}.
{DOM_HOSTNAME}.		IN	NS	{DNS2_HOSTNAME}.
{DOM_HOSTNAME}.		IN	NS	{DNS3_HOSTNAME}.

{DOM_HOSTNAME}.		IN	MX	30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}.		IN	MX	30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}.		IN	MX	30 {MX3_HOSTNAME}.

{DOM_HOSTNAME}.		IN	A	{DOM_IPNUMBER}

*.{DOM_HOSTNAME}.	IN	MX	30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}.	IN	MX	30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}.	IN	MX	30 {MX3_HOSTNAME}.

*.{DOM_HOSTNAME}.	IN	A	{DOM_IPNUMBER}

Anschließend werden die atomaren Platzhalter ersetzt:

$TTL 6H

<FQDN>. IN SOA <HIVE>.hostsharing.net. hostmaster.hostsharing.net. (
	<SEKUNDEN>	; serial secs since Jan 1 1970
	6H		; refresh (>=10000)
	1H		; retry (>=1800)
	1W		; expire
	1H		; minimum
	)

<FQDN>.		IN	NS	dns1.hostsharing.net.
<FQDN>.		IN	NS	dns2.hostsharing.net.
<FQDN>.		IN	NS	dns3.hostsharing.net.

<FQDN>.		IN	MX	30 mail1.hostsharing.net.
<FQDN>.		IN	MX	30 mail2.hostsharing.net.
<FQDN>.		IN	MX	30 mail3.hostsharing.net.

<FQDN>.		IN	A	<IP>

*.<FQDN>.	IN	MX	30 mail1.hostsharing.net.
*.<FQDN>.	IN	MX	30 mail2.hostsharing.net.
*.<FQDN>.	IN	MX	30 mail3.hostsharing.net.

*.<FQDN>.	IN	A	<IP>

Das Zonefile deaktivieren/zurücksetzen

In ~/doms/example.com/etc das vorhandene Zonefile (pri.example.com) komplett leeren (ist dann 0 Bytes groß). Dann kommt der Robot vorbei, löscht pri.example.com und setzt alles auf Standardwerte zurück.