pihole Raspberry Pi Ansible Rolle

Die Rolle installiert und konfiguriert Pihole (https://pi-hole.net/) mit einer unbeaufsichtigten Einrichtung.

Dokumente zu Pi-hole finden Sie unter https://docs.pi-hole.net/

Anforderungen

Ein Benutzer mit Sudo-Zugriff auf die Maschine.

andere Voraussetzungen

Erforderliche Variablen

pihole_setupvars_webpassword

Sie müssen ein Admin-Passwort für die Variable pihole_setupvars_webpassword generieren, das Passwort wird zweimal mit sha256 gehasht. Sie können ein Passwort mit dem folgenden Shell-Befehl generieren.

Mit dem Passwort in einer Datei (empfohlen).

echo -n $(cat ~/piholepass.word) | sha256sum | awk '{printf "%s", $1}' | sha256sum

Mit dem Passwort im Shell-Befehl (nicht empfohlen)

echo -n notsosecretpassword | sha256sum | awk '{printf "%s", $1}' | sha256sum

Es wird empfohlen, diese Variable im Ansible-Vault zu speichern.

pihole_setupvars_ipv4_address

IPv4-Adresse von Pihole

pihole_setupvars_pihole_dns_1/2

DNS-Server, die Sie für Pihole verwenden möchten

DNS

Alternative DNS-Anbieter

Google: https://developers.google.com/speed/public-dns
  - 8.8.8.8
  - 8.8.4.4

OpenDNS: https://use.opendns.com/
  - 208.67.222.222
  - 208.67.220.220

Cloudflare: https://1.1.1.1/dns/
  - 1.1.1.1
  - 1.0.0.1

Rollenvariablen

defaults/main.yml für Standardwerte

Beispiel-Playbook

---
- name: pihole
  hosts: pi
  strategy: free
  become_method: sudo
  become: yes
  gather_facts: yes
  vars:
    pihole_setupvars_ipv4_address: 192.168.1.100
    pihole_setupvars_webpassword: 35030714f1136486a612d7014b739a6c7ef3be589bb14b14a3d01f521dd7ef18
    pihole_setupvars_pihole_dns_1: 1.1.1.1
    pihole_setupvars_pihole_dns_2: 1.0.0.1
  roles:
    - zfuller.pihole