项目概述
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 就已经是一道门槛。本项目将 AdGuard Home 集成到 pfSense 的 WebUI 中，让用户无需命令行即可完成安装、配置和管理。
项目特点
之前大多数用户安装 AdGuard Home 都需要参考各种教程，稍有操作不当，就可能导致DNS 服务异常，网络解析中断，远程管理失联，配置丢失。社区中也经常能看到因为端口冲突和 Resolver 配置问题导致安装失败的案例。对于家庭用户来说，使用门槛仍然偏高。
本项目让 AdGuard Home 像 pfSense 原生插件一样工作。通过 WebUI 即可完成整个生命周期管理。一键安装，自动完成文件下载、目录创建、权限设置、服务注册。所有操作均可在 pfSense WebUI 中完成。可以备份配置，即使升级 pfSense，也能够最大程度保证配置安全。如下图所示：
该插件在 pfSense CE 2.8.1 、pfSense plus 26.03.1 上测试通过。详细的配置流程，请参考项目文件。
写在最后
当前越来越多用户开始使用 pfSense 搭建家庭网络和 Homelab，而广告过滤和隐私保护已经成为网络基础设施的重要组成部分。AdGuard Home 本身已经足够优秀，但安装和维护成本依然偏高。我希望通过该项目，让它真正成为一个开箱即用、可视化管理、适合长期运行的 pfSense 原生插件。
如果这个项目对你有所帮助，欢迎 Star、提交 Issue 或参与贡献，一起把它做得更完善。