maxhoesel.ddclient

Bardzo minimalna rola do instalacji i konfiguracji ddclient z GitHub. Tworzy również usługę systemd, aby włączyć tryb demona dla ddclient.

Wymagania

Niedawna wersja Ansible. Ta rola wspiera 2 najnowsze major wersje Ansible. Starsze wersje mogą działać, ale nie są wspierane.
System działa na:
- Ubuntu 18.04 LTS lub nowszym
- Debian 10 lub nowszym
- Inne dystrybucje mogą działać, ale nie są wspierane (możesz dodać wsparcie przez PR!)

Zmienne roli

Instalacja

`ddclient_version`

Wersja ddclient do zainstalowania
Może być gałęzią, tagiem, wersją commit lub inną wartością wspieraną przez git.
Domyślnie: develop

`ddclient_executable_path`

Gdzie umieścić plik wykonywalny ddclient
Domyślnie: /usr/local/sbin/ddclient, aby nie kolidować z żadnymi pakietami dystrybucji.

`ddclient_configfile`

Plik konfiguracyjny do użycia dla instalacji ddclient
Domyślnie: /etc/ddclient.conf

`ddclient_pidfile`

Plik PID do użycia dla demona ddclient
Domyślnie: /var/run/ddclient.pid

`ddclient_systemd_unit`

Nazwa pliku jednostki dla demona ddclient
Domyślnie: ddclient

Konfiguracja

`ddclient_interval`

Liczba sekund pomiędzy sprawdzeniami IP DynDNS
Domyślnie: 300

`ddclient_mail`

Wysyłaj wszystkie aktualizacje na ten adres użytkownika/pocztowy
Domyślnie: root

`ddclient_mail_failure`

Wysyłaj wszystkie błędy na ten adres użytkownika/pocztowy
Domyślnie: root

`ddclient_entries`

Lista wpisów konfiguracyjnych ddclient
Każdy wpis zawiera listę opcji i listę domen
- Opcje są mapowane 1:1 do parametrów ddclient

Przykład:

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

Wyszukiwanie IP

Opcje konfiguracyjne do określenia, jak ddclient uzyskuje adresy IP, które musi zaktualizować przez DynDNS. Domyślnie wszystkie te parametry są niezdefiniowane, co oznacza, że ddclient użyje swoich wbudowanych domyślnych wartości.

UWAGA: Większość poniższych parametrów może być ustawiona dla IPv4 lub IPv6.

`ddclient_strategy_usev[4/6]`

Ustaw strategię do określenia adresu IP IPv4/6 do użycia dla aktualizacji DynDNS
Opcje to webv[4/6], if[4/6], ip[4/6], fw, cmd
Domyślnie: niezdefiniowane

`ddclient_strategy_ipv[4/6]`

Ustaw statyczny adres IP przy użyciu strategii ip
Domyślnie: niezdefiniowane

`ddclient_strategy_ifv[4/6]`

Uzyskaj adres IP z określonego interfejsu przy użyciu strategii if
Domyślnie: niezdefiniowane

`ddclient_strategy_webv[4/6]`

Uzyskaj adres IPv4 z usługi wykrywania IP opartej na sieci WWW, z znanej usługi lub własnego adresu URL
Domyślnie: niezdefiniowane

`ddclient_strategy_webv[4/6]_skip`

Zobacz dokumentację ddclient
Domyślnie: niezdefiniowane

`ddclient_strategy_fwv[4/6]`

Uzyskaj adres IP z urządzenia o tym adresie IP lub URL
Domyślnie: niezdefiniowane

`ddclient_strategy_fwv[4/6]_skip`

Pomiń wszystkie adresy IP przed tym wzorcem w tekście zwróconym z urządzenia
Domyślnie: niezdefiniowane

`ddclient_strategy_fw_login`

Użyj tego loginu, gdy uzyskujesz IP z urządzenia
Domyślnie: niezdefiniowane

`ddclient_strategy_fw_password`

Użyj tego hasła, gdy uzyskujesz IP z urządzenia
Domyślnie: niezdefiniowane

`ddclient_strategy_cmdv[4/6]`

Uzyskaj adres IPv4 z wyniku tego polecenia
Domyślnie: niezdefiniowane

Przykładowy Playbook

- hosts: all
  tasks:
    - name: Zainstaluj ddclient
      include_role:
        name: maxhoesel.ddclient
      vars:
        ddclient_entries:
        - options:
            protocol: cloudflare
            zone: domain.tld
            ttl: 1 # automatycznie
            login: twój-login-email
            password: APIKey
          domains:
            - domain.tld
            - my.domain.tld
        # Ustal adres IPv4 przy użyciu dyndns
        ddclient_strategy_usev4: webv4
        ddclient_strategy_webv4: dyndns
        # Uzyskaj adres IPv6 z eth0
        ddclient_strategy_usev6: ifv6
        ddclient_strategy_ifv6: eth0