Rola Ansible dla Pihole na Raspberry Pi

Rola instaluje i konfiguruje Pihole https://pi-hole.net/ z automatyczną konfiguracją.

Dokumenty związane z Pihole znajdują się pod adresem https://docs.pi-hole.net/.

Wymagania

Użytkownik z dostępem sudo do maszyny.

Inne wymagania wstępne.

Wymagane zmienne

pihole_setupvars_webpassword

Musisz wygenerować hasło administratora dla zmiennej pihole_setupvars_webpassword. Hasło jest haszowane dwukrotnie algorytmem sha256. Hasło można wygenerować za pomocą poniższego polecenia shell.

Z hasłem w pliku (zalecane).

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

Z hasłem w poleceniu shell (niezalecane).

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

Zaleca się przechowywanie tej zmiennej w skarbczyku Ansible.

pihole_setupvars_ipv4_address

Adres IPv4 Pihole'a.

pihole_setupvars_pihole_dns_1/2

Serwery DNS, które ma używać Pihole.

DNS

Alternatywni dostawcy DNS

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

Zmienne roli

defaults/main.yml dla wartości domyślnych.

Przykładowy 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