Home

AdGuard Home 助手

OpenWrt / ImmortalWrt / iStoreOS 轻量级 AdGuard Home LuCI 管理插件。把「装内核、接 DNS、看状态」收进一个页面，三步完成，不需要手改配置。

当前版本：1.3.1 ｜ 许可证：GPL-3.0-or-later ｜ Releases ｜ Issues

---

三步开始

1. 安装插件：下载安装包，或在 25.12 / apk 系统运行 install.sh；
2. 安装内核：服务 → AdGuard Home 助手 → 概览 → 「安装/更新内核」；
3. 一键启用：概览 → 「一键启用」，然后用 admin / admin123 打开控制台。

首次登录后请到「基础设置 → 插件配置」改掉默认密码。

---

文档导航

页面	内容
安装与升级	固件与安装包对应关系、ipk / run / 脚本安装、安装后检查、升级方式
快速上手	三步启用、默认配置、界面地图、首次使用建议
DNS 接管方式	四种接管方式怎么选、接管 53 + Clash 组合、排除接口与客户端、启动顺序
功能说明	概览、插件配置、DNS 解析、过滤规则、高级配置、运行日志逐项说明
常见问题	安装、DNS、过滤、统计相关高频问题
排障手册	断网、解析失败、面板打不开、规则更新失败的症状与命令
卸载与回滚	卸载、彻底清理、恢复 DNS、回滚旧版插件
版本记录	各版本主要变化

---

能力概览

• 三步安装：内核自动识别架构并下载，国内网络可走 GitHub 反代，fake-IP 环境自动处理。
• 四种 DNS 接管：接管 53 端口（默认）、DNSMasq 上游、Clash 前置、仅面板，切换时自动恢复原设置。
• Clash 共存：自建 agh_dns_redirect 链，在 Clash 劫持之前收回设备的 53 查询，过滤与逐设备统计同时保留。
• 页面内管理：过滤订阅（黑名单 / 白名单）、自定义规则、安全搜索、浏览安全、成人内容拦截、DNS 缓存、上游 DNS、加密上游，修改立即生效。
• 可回滚：停止服务或卸载时只还原自己改过的 DNSMasq 项，不写入公共 DNS。

---

默认配置

项目	默认值
管理面板	0.0.0.0:13800
账号 / 密码	admin / admin123
DNS 接管	接管 53 端口，DNSMasq 移到 1745
上游 DNS	127.0.0.1:1745
过滤规则	11 个订阅，默认按 512MB 档启用 6 个；白名单默认关闭
统计 / 查询日志	保留 30 天，查询日志只存内存
DNS 缓存	开启，16MB，最小 TTL 0，乐观缓存关闭
加密上游	关闭（仅「Clash 前置」可开启）
DNSSEC / fallback	关闭

---

适用范围

适用：OpenWrt 23.05 / 24.10、ImmortalWrt、iStoreOS 及基于新版 LuCI 的衍生固件；旧固件使用 legacy 包。

不适用：Docker、NAS、普通 Linux 发行版；LoongArch 架构暂不支持。

与旧版 luci-app-adguardhome 冲突，安装前请先卸载旧插件及 luci-i18n-adguardhome-zh-cn。