LuCI App AdGuard Home

发表于 分类于 阅读次数： Disqus： 本文字数： 591 阅读时长 ≈ 2 分钟

AdGuard Home 是一个自托管的广告拦截器，旨在 DNS 层面通过拦截跟踪域名和广告域名来提升用户隐私和网络体验。它可以运行在本地网络的网关或旁路由上，无需在每个终端设备上单独安装插件。AdGuard Home 提供了多个平台的二进制文件和安装指引，方便用户部署。

OpenWrt 默认的软件源提供了 AdGuard Home 的软件包，用户可以通过 opkg 安装。但是，要提升使用体验，还需要配合防火墙等设置。为了让 AdGuard Home 更好地融入 OpenWrt 的生态，社区开发了 LuCI 插件来提供图形化界面。

插件的发展历史

最早由 rufengsuixing 开发的 luci-app-adguardhome，在 LuCI 界面中实现了安装 / 更新核心、端口与重定向策略、日志查看、YAML 配置编辑、计划任务等选项，可一键进行部署。这一版本在 2020 年后停止了更新。
随后，社区分支由 kongfl888 延续维护，功能框架基本一致，持续发版至 2022 年，方便了众多固件集成打包。

我的 fork

我在 kongfl888 的基础上继续了 luci-app-adguardhome 的开发，主要聚焦以下改进：

  1. 兼容性与可视化
    将「重定向 53 端口」的功能直接通过系统防火墙进行配置，对 fw4 / nftables 友好，并可以支持 IPv6 重定向；更新界面布局、提示，让运行状态与问题原因更直观。

  2. 配置与运维体验
    将诸多的配置选项按照功能分页展示，默认配置更加精简和清晰；把「系统升级保留文件」的表单重构为更优雅的动态列表并兼容旧配置格式；清理历史遗留代码并进行重构。

  3. 账号与日志
    完善 Web 口令变更流程与提示，避免误操作；统一临时文件命名与读取游标；在 YAML 配置校验失败时给出更清晰的错误信息，便于排错。

目前在我的仓库 README 中，对上述功能与组合使用方式（例如与 OpenClash/代理类插件并用时的上游/重定向关系）也做了集中说明，并提供可直接安装的发布包。欢迎使用：stevenjoezhang/luci-app-adguardhome。