LuCI App AdGuard Home

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

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

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

插件的发展历史

最早由 rufengsuixing 提供的 luci-app-adguardhome，把安装/更新核心、端口与重定向策略、路径/日志、YAML 模板编辑、计划任务等操作装进了 LuCI，可一键进行部署。
随后，社区分支由 kongfl888 延续维护，功能框架基本一致，持续发版至 2022 年，方便众多固件集成打包。

我的 fork

我在 kongfl888 的基础上继续演进，主要聚焦以下改进：

  1. 兼容性与可视化
    将「重定向 53 端口」的实现直接对齐系统防火墙配置，对 fw4 / nftables 友好，并覆盖 IPv6 重定向；更新界面布局、提示，让状态与失败原因更直观。

  2. 配置与运维体验
    把「系统升级保留文件」的表单重构为更稳健的动态列表并兼容旧格式；清理历史遗留选项与临时文件命名，精简默认配置。

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

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