AdGuard Home 是一款开源的网络级广告拦截和 DNS 管理工具，它通过 DNS Sinkhole 技术，在网络层拦截广告、追踪器和恶意域名。相比传统浏览器插件，它能够保护整个家庭网络中的所有设备，包括：手机、平板、PC、智能电视、游戏主机、设备。

AdGuard Home 还提供了丰富的高级功能，包括：

• DNS-over-HTTPS（DoH）
• DNS-over-TLS（DoT）
• DNSCrypt
• DNS 重写
• 家长控制
• 恶意域名拦截
• 客户端独立配置
• 查询日志与统计分析

官方项目已经支持 FreeBSD 平台，并提供自动安装脚本和 REST API，为集成到 pfSense 提供了良好的基础。

pfSense 在网络管理、安全控制和扩展性方面表现十分出色。但在广告拦截和现代 DNS 管理方面，很多用户仍然需要额外折腾，尤其是国内用户，因为pfSense插件 pfBlockerNG 自带列表规则大多是国外的，不适合国内的应用场景。如果要使用 AdGuard Home，需要手动下载二进制文件，配置SSH 服务，修改 DNS Resolver 配置，手动编写启动脚本，升级和维护成本较高。

本项目让 AdGuard Home 像 pfSense 原生插件一样工作。通过 WebUI 即可完成整个生命周期管理。一键安装，自动完成文件下载、目录创建、权限设置、服务注册。所有操作均可在 pfSense WebUI 中完成。可以备份配置，即使升级 pfSense，也能够最大程度保证配置安全。如下图所示：

该插件在 pfSense CE 2.8.1 、pfSense plus 26.03.1 上测试通过。

安装方法

通过加入社区存储库来安装，在终端运行以下命令：

pfSense CE

fetch -o /usr/local/etc/pkg/repos/opnwall.conf \https://opnwall.github.io/pfSense-repo/pfsense-ce-opnwall.conf
pkg update -f

pfSense Plus

fetch -o /usr/local/etc/pkg/repos/opnwall.conf \https://opnwall.github.io/pfSense-repo/pfsense-plus-opnwall.conf
pkg update -f

补丁安装

fetch -qo - https://opnwall.github.io/pfSense-repo/enable-opnwall-gui.sh | sh

安装完成后，刷新浏览器，即可在 pfSense 的插件列表发现 AdGuard Home 插件。