如何无交互安装Pi-Hole？求Vagrant环境自动化部署实现方案

绝对可以实现无交互安装Pi-Hole！Pi-Hole官方早就考虑到了自动化部署的需求，提供了一套通过环境变量跳过所有交互步骤的方案，结合Vagrant的provision功能，就能让虚拟机启动时自动完成Pi-Hole的部署。下面我给你详细拆解具体实现步骤和代码：

Pi-Hole的官方安装脚本install.pi-hole.net支持通过预设环境变量替代所有手动交互的回答，比如IPv4/IPv6选择、静态IP配置、上游DNS设置、后台密码等。只要在运行安装脚本前设置好这些变量，就能全程无干预完成安装。

创建一个名为install-pihole.sh的脚本，内容如下：

#!/bin/bash

# 关闭Pi-Hole的系统检查（可选，适配部分Vagrant镜像的小兼容性问题）
export PIHOLE_SKIP_OS_CHECK=true

# 指定Pi-Hole监听的网卡（Vagrant默认网卡通常为eth0）
export PIHOLE_INTERFACE="eth0"

# 设置Pi-Hole的静态IPv4地址（必须和Vagrantfile里的虚拟机IP一致，格式为IP/子网掩码）
export IPV4_ADDRESS="192.168.56.10/24"

# 跳过IPv6配置（不需要IPv6支持时设为none，避免交互提问）
export IPV6_ADDRESS="none"

# 设置上游DNS服务器（示例用Google DNS，可替换为Cloudflare 1.1.1.1等）
export PIHOLE_DNS_1="8.8.8.8"
export PIHOLE_DNS_2="8.8.4.4"

# 关闭查询日志（可选，根据需求开启/关闭）
export QUERY_LOGGING=false

# 安装Web管理界面及依赖的Web服务器
export INSTALL_WEB_SERVER=true
export INSTALL_WEB_INTERFACE=true
export LIGHTTPD_ENABLED=true

# 设置Web后台的登录密码（可选，不设置则生成随机密码，可在安装日志查看）
export PASSWORD="your-secure-password-here"

# 执行无交互安装
curl -sSL https://install.pi-hole.net | bash -s -- --unattended

关键变量说明： #

• IPV4_ADDRESS：必须与Vagrant虚拟机的静态IP完全匹配，确保Pi-Hole能稳定提供DNS服务
• IPV6_ADDRESS：设为none直接跳过IPv6配置，彻底避免相关交互
• PASSWORD：删除该变量则安装后生成随机密码，可通过cat /var/log/pihole/install.log | grep "password"获取

创建一个Vagrantfile，将脚本整合进去（支持引用外部脚本或内联代码），完整示例如下：

Vagrant.configure("2") do |config|
  # 使用Ubuntu 20.04镜像（Pi-Hole对Debian/Ubuntu系支持最优）
  config.vm.box = "ubuntu/focal64"

  # 设置虚拟机静态私有网络IP（必须与脚本中的IPV4_ADDRESS一致）
  config.vm.network "private_network", ip: "192.168.56.10"

  # 配置VirtualBox虚拟机参数（512MB内存足够Pi-Hole运行）
  config.vm.provider "virtualbox" do |vb|
    vb.memory = "512"
    vb.name = "Pi-Hole-Server"
  end

  # 引用外部脚本完成自动化部署
  config.vm.provision "shell", path: "install-pihole.sh"

  # 若不想单独创建脚本，也可使用内联shell：
  # config.vm.provision "shell", inline: <<-SHELL
  #   # 把上面的脚本内容复制到此处即可
  # SHELL
end

1. 将Vagrantfile和install-pihole.sh放在同一目录下
2. 打开终端进入该目录，执行vagrant up
3. Vagrant会自动下载镜像、创建虚拟机并完成Pi-Hole的无交互安装

安装完成后可进行以下验证：

• 在浏览器访问http://192.168.56.10/admin进入管理后台，使用设置的PASSWORD登录
• 若未设置密码，执行vagrant ssh进入虚拟机，运行cat /var/log/pihole/install.log | grep "password"获取随机密码
• 将设备DNS设置为192.168.56.10，即可体验Pi-Hole的广告拦截功能

• 确保Vagrant和VirtualBox为最新版本，避免兼容性问题
• 若虚拟机无法获取静态IP，检查VirtualBox主机网络配置，确保192.168.56.0/24网段未被占用
• 安装完成后如需修改配置，可通过vagrant ssh进入虚拟机编辑/etc/pihole/setupVars.conf，再执行sudo systemctl restart pihole-FTL重启服务

内容的提问来源于stack exchange，提问作者Kutsubato