maxhoesel.ddclient

Eine sehr minimale Rolle, um ddclient von GitHub zu installieren und zu konfigurieren. Richtet auch einen systemd-Dienst ein, um den Daemon-Modus für ddclient zu aktivieren.

Anforderungen

Eine aktuelle Ansible-Version. Diese Rolle unterstützt die zwei neuesten Hauptversionen von Ansible. Ältere Versionen könnten noch funktionieren, werden jedoch nicht unterstützt.
Ein Host, der Folgendes ausführt:
- Ubuntu 18.04 LTS oder neuer
- Debian 10 oder neuer
- Andere Distributionen können funktionieren, werden jedoch nicht unterstützt (fühlen Sie sich frei, Unterstützung mit einem PR hinzuzufügen!)

Rollenvariablen

Installation

`ddclient_version`

Version von ddclient, die installiert werden soll
Kann ein Branch, Tag, Commit oder ein anderer von git unterstützter Wert sein.
Standard: develop

`ddclient_executable_path`

Wo die ddclient-Ausführungsdatei platziert werden soll
Standard ist /usr/local/sbin/ddclient, um keine Konflikte mit Paketversionen der Distribution zu verursachen.

`ddclient_configfile`

Konfigurationsdatei, die für die ddclient-Installation verwendet werden soll
Standard: /etc/ddclient.conf

`ddclient_pidfile`

PID-Datei, die für den ddclient-Daemon verwendet werden soll
Standard: /var/run/ddclient.pid

`ddclient_systemd_unit`

Name der Einheitendatei für den ddclient-Daemon
Standard: ddclient

Konfiguration

`ddclient_interval`

Anzahl der Sekunden zwischen DynDNS-IP-Prüfungen
Standard: 300

`ddclient_mail`

Alle Updates an diese Benutzer-/E-Mail-Adresse senden
Standard: root

`ddclient_mail_failure`

Alle Fehler an diese Benutzer-/E-Mail-Adresse senden
Standard: root

`ddclient_entries`

Liste der Konfigurationseinträge für ddclient
Jeder Eintrag enthält eine Liste von Optionen und eine Liste von Domains
- Optionen entsprechen 1:1 den ddclient-Parametern

Beispiel:

- options:
    protocol: cloudflare
    zone: domain.tld
    ttl: 60
    login: your-login-email
    password: APIKey
  domains:
    - domain.tld
    - my.domain.tld

IP-Abfrage

Konfigurationsoptionen zur Bestimmung, wie ddclient die IP-Adressen erhält, die er für die Updates über DynDNS benötigt. Standardmäßig sind alle diese Parameter nicht gesetzt, was bedeutet, dass ddclient seine integrierten Standardwerte verwendet.

HINWEIS: Die meisten der folgenden Parameter können sowohl für IPv4 als auch für IPv6 gesetzt werden.

`ddclient_strategy_usev[4/6]`

Strategie festlegen, um die IPv4/6-IP-Adresse für DynDNS-Updates zu bestimmen
Optionen sind webv[4/6], if[4/6], ip[4/6], fw, cmd
Standard: nicht definiert

`ddclient_strategy_ipv[4/6]`

Eine statische IP festlegen, wenn die ip-Strategie verwendet wird
Standard: nicht definiert

`ddclient_strategy_ifv[4/6]`

Die IP-Adresse von einer gegebenen Schnittstelle abrufen, wenn die if-Strategie verwendet wird
Standard: nicht definiert

`ddclient_strategy_webv[4/6]`

IPv4-Adresse von einem web-basierten IP-Entdeckungsdienst abrufen, entweder von einem bekannten Dienst oder einer benutzerdefinierten URL
Standard: nicht definiert

`ddclient_strategy_webv[4/6]_skip`

Siehe ddclient-Dokumentation
Standard: nicht definiert

`ddclient_strategy_fwv[4/6]`

IP-Adresse von einem Gerät mit dieser IP-Adresse oder URL abrufen
Standard: nicht definiert

`ddclient_strategy_fwv[4/6]_skip`

Alle IP-Adressen vor diesem Muster im vom Gerät zurückgegebenen Text überspringen
Standard: nicht definiert

`ddclient_strategy_fw_login`

Dieses Login verwenden, wenn die IP vom Gerät abgerufen wird
Standard: nicht definiert

`ddclient_strategy_fw_password`

Dieses Passwort verwenden, wenn die IP vom Gerät abgerufen wird
Standard: nicht definiert

`ddclient_strategy_cmdv[4/6]`

IPv4-Adresse aus der Ausgabe dieses Befehls abrufen
Standard: nicht definiert

Beispiel-Playbook

- hosts: all
  tasks:
    - name: Installiere ddclient
      include_role:
        name: maxhoesel.ddclient
      vars:
        ddclient_entries:
        - options:
            protocol: cloudflare
            zone: domain.tld
            ttl: 1 # automatisch
            login: your-login-email
            password: APIKey
          domains:
            - domain.tld
            - my.domain.tld
        # Bestimme die IPv4-Adresse mit dyndns
        ddclient_strategy_usev4: webv4
        ddclient_strategy_webv4: dyndns
        # Hole die IPv6-Adresse von eth0
        ddclient_strategy_usev6: ifv6
        ddclient_strategy_ifv6: eth0