Computerclub Pinneberg

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Dyndns selber aufsetzen ======

WIP
  * Diese Anleitung ist noch nicht vollständig!
  * IPv6 fehlt noch
  * Weitere Details zum DNS gibt es auch im [[https://wiki.pinneberg.freifunk.net/dns|Wiki von Freifunk Pinneberg]]

Es wird ein Server im Internet mit einem laufenden Nameserver "bind" benötigt.
Zusätzlich ist ein laufender Webserver erforderlich, der für die Adreßermittlung
zuständig ist, sowie eine Domäne, für die eine Subdomäne mit NS-Records
angelegt werden kann.

===== Server =====

Der Nameserver sollte für eine neu angelegte Subdomain eingerichtet
werden, z.B. ''dyn.example.com'':

In der übergeordneten Zone
<file conf /etc/bind/example.com.zone>
[...]
dyn		NS	ns1.example.com.
		NS	ns2.example.com.
</file>

Zonendatei für die Subdomain
<file conf /etc/bind/dyn.example.com.zone>
$ORIGIN dyn.example.com.
$TTL 90 ; seconds
@	IN	SOA	ns1.example.com. hostmaster.example.com. (
                        2015122401      ; serial
                        1h              ; refresh
                        20m             ; retry
                        4d              ; expire
                        15m             ; nxdomain ttl
                        )
		NS	ns1.example.com.
		NS	ns2.example.com.
		TXT	"Dynamic Domain Example/Pinneberg, Germany"
</file>

Bind muß Schreibberechtigung auf diese Datei bekommen.
<code>
chmod g+w dyn.example.com.zone
</code>

Bekanntmachen der neuen Zone für den Nameserver in ''named.conf.local'' und
Updates für die A- und AAAA-Records in der Subdomain ''dyn'' zulassen:
<file conf named.conf.local>
// DynDNS in spezieller Subdomain bereitstellen
zone "dyn.example.com" IN {
    type master;
    file "/etc/bind/dyn.example.com.zone";
    notify no;
    update-policy {
        grant ddns-key.example.com subdomain dyn.example.com. A AAAA;
    };
};
</file>

Schlüssel anlegen, daß die ''dyn''-Subdomain hier nicht enthalten ist, soll wirklich so sein!
<code>
  ddns-confgen -z example.com
</code>

Den ersten Teil der Ausgabe in eine Datei namens ''dyndns.keys'' eintragen.
Werden für verschiedene Clients unterschiedliche Schlüssel verwendet, kann
die Datei dann entsprechend erweitert werden.
  chmod 640 dyndns.keys

Die Datei mit den Schlüsseldefinitionen muß vom Nameserver gelesen werden, dazu
muß in der Datei ''named.conf'' folgende Anweisung enthalten sein:
  include "/etc/bind/dyndns.keys";


Damit die Clients ihre Adresse ermitteln können ist auf unter der Adresse
[[http://www.example.com/myip.php]] ein entsprechendes Programm 
abgelegt. Die Funktion ist ''checkip.dyndns.org'' nachempfunden.
<file php /var/www/myip.php>
<html><head><title>Current IP Check</title></head><body><?php
echo "Current IP Address: ", $_SERVER['REMOTE_ADDR'];
?></body></html>
</file>

==== Protokollierung ====

Zur Verbesserung der Übersicht können die Änderungsanforderungen in eine 
spezielle Logdatei geschrieben werden: ''var/log/named/update.log''.

<file conf /etc/bind/named.conf.local>
logging {
[...]
        channel update_file {
                file "/var/log/named/update.log" versions 3 size 30m;
                severity info;
                print-time yes;
        };
[...]
        category update {
                update_file; 
        };
        category update-security {
                update_file;   
        };
[...]
}
</file>


===== Client =====

Der Client besteht lediglich aus einem Bash-Script, welches aufgrund Informationen
aus verschiedenen Quellen zusammengestellt wurde.
Die Funktionsweise ist ähnlich dem Programm ''ddclient'', es wird eine Cache-Datei
mit (hoffentlich) kompatiblem Aufbau verwendet.

Voraussetzungen
  * ''curl'' 
  * ''nsupdate''  aus dem paket ''dnsutils''
  * Programm: ''/usr/local/bin/ddns-update'' (Bash-Script)

Die Konfiguration erfolgt über das Verzeichnis ''/etc/dyndns''
  * Konfiguration: ''/etc/dyndns/ddns.key'' -> Ausgabe von ''ddns-confgen -z'', wie auf dem Server ausgeführt
  * ''chmod 600 /etc/dyndns/ddns.key''
  * Hauptkonfigurationsdatei:<file conf /etc/dyndns/ddns.conf>
#
# Configuration for ddns-update script
#
KEYFILE=/etc/dyndns/ddns.key
HOST=homeserver
ZONE=example.com
TIMEOUT=90
MAXAGE=86400
IPV4=1
IPV6=0
MYIPURL=https://www.example.com/myip.php
CACHEFILE=/var/cache/ddclient/ddclient.cache
</file>
  * Die Aktualisierung sollte regelmäßig, aber nicht zu oft stattfinden, wir realisieren das über einen  Cronjob:<file conf /etc/cron.d/dyndns>
# /etc/cron.d/ddns: crontab fragment for ddns-update

# Renew dynamic IP address every 15 minutes
05,20,35,50 *     * * *     root   /usr/local/bin/ddns-update > /dev/null 2>&1
</file>