pihole 树莓派 ansible 角色

该角色安装并配置 Pihole https://pi-hole.net/，并支持无人值守的设置。

有关 pi-hole 的文档可以在 https://docs.pi-hole.net/ 找到。

要求

需要一个具有 sudo 权限的用户。

其他 先决条件。

必需变量

pihole_setupvars_webpassword

您需要为 pihole_setupvars_webpassword 变量生成一个管理密码，密码需要使用 sha256 哈希两次。您可以使用以下命令生成密码。

将密码存储在文件中（推荐）。

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

将密码直接写在命令中（不推荐）。

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

建议将此变量存储在 ansible vault 中。

pihole_setupvars_ipv4_address

Pihole 的 IPv4 地址。

pihole_setupvars_pihole_dns_1/2

您希望 Pihole 使用的 DNS 服务器。

DNS

备用 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

角色变量

defaults/main.yml 中包含默认值。

示例剧本

---
- 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