Repository navigation
Releases
v1.3.2-B3
v1.3.2-B3
更新内容
- 插件更新提示不再区分稳定版 / 测试版:仓库里的 Release 都是正式版,提示直接按版本号比较
- 稳定版 / 测试版只用于 AdGuard Home 内核安装通道,本次不改动
- 概览的插件更新提示去掉「(测试版)」后缀,更新检查缓存只记录最新版本与时间
安装方式
1. 一键脚本(推荐)
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B3国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B3 -m https://gh-proxy.org2. 离线脚本(.run)
sh luci-app-adguardhome-lite_1.3.2-B3.run3. ipk(opkg 固件)
opkg install luci-app-adguardhome-lite_1.3.2-B3_all.ipkOpenWrt 22.03 及更早的 Lua LuCI 固件使用 legacy 包:
opkg install luci-app-adguardhome-lite_1.3.2-B3-legacy_all.ipk说明
- 本版本为正式版,
-v latest即指向此版本 - 文件校验值见
SHA256SUMS,安装脚本可单独下载install.sh使用
v1.3.2-B2
v1.3.2-B2
更新内容
- 新增「PassWall 前置」接管方式:不用关闭 PassWall 的 DNS 劫持,AdGuard Home 占 53 后把查询交给 PassWall 自己的 DNS(端口从
11400起动态分配),过滤、逐设备统计与国内外分流同时保留 - 该模式下插件自建的
agh_dns_redirect链使用priority -102,比 PassWall 的劫持更靠前,设备指向8.8.8.8这类 DNS 也会被收回 - 上游 DNS 自动指向 PassWall 运行时端口(读
/tmp/etc/passwall/var);PassWall 未启用时回退到本机 DNSMasq1745,不会因上游端口不存在而断网 - 概览新增 PassWall 提示:未启用、上游端口已过期(PassWall 重启换了端口)时可直接重新保存接管方式
- 该模式不支持「排除接口 / 客户端」:被排除的设备会直接落到 PassWall 的劫持,仍有分流,但不经过 AdGuard Home
安装方式
1. 一键脚本(推荐)
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B2国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B2 -m https://gh-proxy.org2. 离线脚本(.run)
sh luci-app-adguardhome-lite_1.3.2-B2.run3. ipk(opkg 固件)
opkg install luci-app-adguardhome-lite_1.3.2-B2_all.ipkOpenWrt 22.03 及更早的 Lua LuCI 固件使用 legacy 包:
opkg install luci-app-adguardhome-lite_1.3.2-B2-legacy_all.ipk说明
- 本版本为正式版,
-v latest即指向此版本 - 文件校验值见
SHA256SUMS,安装脚本可单独下载install.sh使用
v1.3.2-B1
v1.3.2-B1
更新内容
- 新增暗黑主题,概览页右上角一键切换暗色 / 浅色
- 概览新增旧版残留检测,可一键清理旧版 luci-app-adguardhome 与旧内核;
install.sh新增--keep-old/--purge-old - 测试版内核改为从 GitHub 预发布标签下载(可走反代),失败依次回退官方测试通道与稳定版
- 测试版升级前自动备份
/etc/AdGuardHome.yaml,概览页内核版本旁显示「测试版」标识 - 修复预发布内核版本号被截断(如
v1.0.0-b.2显示为v1.0.0)
安装方式
1. 一键脚本(推荐)
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B1国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -v 1.3.2-B1 -m https://gh-proxy.org2. 离线脚本(.run)
sh luci-app-adguardhome-lite_1.3.2-B1.run3. ipk(opkg 固件)
opkg install luci-app-adguardhome-lite_1.3.2-B1_all.ipkOpenWrt 22.03 及更早的 Lua LuCI 固件使用 legacy 包:
opkg install luci-app-adguardhome-lite_1.3.2-B1-legacy_all.ipk说明
- 本版本为正式版;
-v latest指向最新发布(当前为v1.3.2-B2) - 文件校验值见
SHA256SUMS,安装脚本可单独下载install.sh使用
v1.3.1
v1.3.1
新增
- 过滤规则页新增「家长控制」开关,五个开关改为一行排列
- 新增「按设备内存精简规则」按钮:512MB / 1GB / 2GB 及以上,自动启停黑名单订阅
- 预置黑名单默认按 512MB 档启用(6 个列表,约 24 万条),白名单默认关闭
- 内置 GitHub 订阅地址统一加
gh-proxy.org前缀,国内规则更新更稳定
修复
- 运行状态卡片在服务停止时不再显示「GitHub 反代」
升级说明
- 安装方式与 1.3.0 相同,ipk / run / install.sh 均可直接覆盖升级
- 升级会保留
/etc/config/adguardhome_lite与/etc/AdGuardHome.yaml,已有订阅状态不变 - 新安装(首次生成配置)才会应用 512MB 默认档与加速订阅地址
安装
LuCI 上传安装(推荐,23.05 / 24.10 / iStoreOS 24.10,使用新版 LuCI):
luci-app-adguardhome-lite_1.2.0-1_all.ipk
OpenWrt 22.03 及更早的原生 Lua LuCI 固件:
legacy/luci-app-adguardhome-lite_1.2.0-1-legacy_all.ipk
25.12 及 apk 系统(脚本安装,无需安装包):
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -m https://gh-proxy.org# ipk(OpenWrt / iStoreOS 24.10 及更早)
opkg install --force-reinstall luci-app-adguardhome-lite_1.3.0-1_all.ipk
# 脚本安装(25.12 / apk 系统)
sh luci-app-adguardhome-lite_1.3.0-1.run校验
见 SHA256SUMS。
v1.3.0
v1.3.0
界面
- 基础设置改为二级导航:插件配置 / DNS 解析 / 过滤规则
- 概览页重排:过滤统计 → 运行状态 → 服务控制 → 初始化配置 → 新手提示
- 初始化配置支持折叠,收起时仅保留「打开 AdGuard Home 面板」;未安装内核或服务未运行时自动展开
- 查询日志从概览迁入「运行日志」,与系统日志用二级导航区分
- 所有开关增加「已开启 / 已关闭 / 已生效 / 未生效」状态文字
DNS
- 新增上游 DNS 编辑器:自动 / 自定义、条件转发、DoH / DoT / DoQ / sdns
- 「接管 53」+ 自定义上游时提示
.lan等本地域名解析会失效 - 加密上游与 DNS 缓存归入「DNS 解析」二级页
过滤
- 白名单订阅现在可见、可启停、可删除
- 修复过滤开关状态读取错误(AGH 返回
enabled,此前被读成不存在的filtering_enabled) - 开关操作失败时自动按服务端真实状态回滚,不再出现「显示已开、实际未生效」
- 订阅地址校验与 AGH 对齐(仅接受 http/https)
- 移除无效的「家长控制」开关;成人内容拦截统一由 HaGeZi NSFW 订阅管理
其它
- 新装模板
ratelimit20 → 100,降低多设备场景丢查询概率 - 统计与日志保留周期、面板密码入口并入「插件配置」
- 文档、使用引导与官网同步新导航结构
安装
LuCI 上传安装(推荐,23.05 / 24.10 / iStoreOS 24.10,使用新版 LuCI):
luci-app-adguardhome-lite_1.2.0-1_all.ipk
OpenWrt 22.03 及更早的原生 Lua LuCI 固件:
legacy/luci-app-adguardhome-lite_1.2.0-1-legacy_all.ipk
25.12 及 apk 系统(脚本安装,无需安装包):
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -m https://gh-proxy.org# ipk(OpenWrt / iStoreOS 24.10 及更早)
opkg install --force-reinstall luci-app-adguardhome-lite_1.3.0-1_all.ipk
# 脚本安装(25.12 / apk 系统)
sh luci-app-adguardhome-lite_1.3.0-1.runRelease 附件包含 modern / legacy 两个 ipk、离线 .run 与 SHA256SUMS。
v1.2.0
重新打包(2026-11-13)
- 概览「过滤统计」的无拦截数据提示移至标题行显示
- 未升版本号,安装包以本页附件及 SHA256SUMS 为准
更新内容
- 「接管 53 端口」新增 不参与接管的接口:下拉多选,自动列出当前网卡(排除
lo/dummy/sit等内核占位接口),勾选后从该接口进入的 DNS 查询交给系统 DNSMasq(1745)应答,不进入 AdGuard Home - 「接管 53 端口」新增 不参与接管的客户端 IP / CIDR:支持 IPv4、IPv6 与网段,命中的设备查询路由器 DNS 时由 DNSMasq 直接应答,不计入 AdGuard Home 统计
- 按 DNS 接管方式 自动置灰无效项:排除项仅在「接管 53 端口」可用;未安装 OpenClash 时「OpenClash 前置」不可选;「DNSMasq 上游」+ OpenClash 时提示上游可能被覆盖
- 「成人内容拦截」移入开关区,与「启用 AdGuard Home」同宽;基础设置恢复三列布局
- 修复排除规则生成时换行被命令替换吞掉、导致 nft 规则粘连的问题;规则写入前仍用
nft -c校验,失败保持原规则不动
文档
- 安装与使用说明:安装验证清单、DNS 接管详解、OpenClash 排查、卸载回滚与常见问题。
- 插件内「使用引导」标签包含三步说明与常见问题入口。
安装方式
LuCI 上传安装(推荐,23.05 / 24.10 / iStoreOS 24.10,使用新版 LuCI):
luci-app-adguardhome-lite_1.2.0-1_all.ipk
OpenWrt 22.03 及更早的原生 Lua LuCI 固件:
legacy/luci-app-adguardhome-lite_1.2.0-1-legacy_all.ipk
25.12 及 apk 系统(脚本安装,无需安装包):
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh国内网络:
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -m https://gh-proxy.org强制更新到 main 最新代码(不升版):sh install.sh -f
离线自解压包:
sh luci-app-adguardhome-lite_1.2.0-1.run同版本重装:opkg install --force-reinstall /tmp/luci-app-adguardhome-lite_1.2.0-1_all.ipk
SHA256 校验见 SHA256SUMS。
v1.1.8
安装 / 更新
脚本安装(推荐,自动识别架构与包管理器):
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh强制更新到最新代码(不升版也能覆盖同版本文件):
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -f国内网络(脚本与源码都走反代):
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -f -m https://gh-proxy.orgipk 安装(OpenWrt 24.10 及更早、iStoreOS 24.10 等 opkg 系统):
opkg install --force-reinstall /tmp/luci-app-adguardhome-lite_1.1.8-1_all.ipk.run 自解压安装(会自动选择 modern / legacy 包):
sh /tmp/luci-app-adguardhome-lite_1.1.8-1.run安装完成后:LuCI → 服务 → AdGuard Home 助手 → 安装内核 → 一键启用。
更新内容
- 页面标题下显示插件版本,发现新版本时提示「前往更新」;每 24 小时后台检测一次
install.sh新增-f/--force强制更新:忽略版本标签,直接用 main 分支最新代码覆盖同版本文件- 修复「接管 53 端口」下 DNSMasq 端口未强制为 1745 的抢端口/断网风险:写入后回读校验,失败即回滚并标记未接管
- 「DNSMasq 上游」与「OpenClash 前置」强制 DNSMasq 回到 53,模式判定改为校验实际端口
- 「仅面板」上游跟随 DNSMasq 实际端口,不再写死
127.0.0.1 - IPv6 收回规则改为排除 WAN 接口,覆盖访客/IoT 网络;规则不完整或内容变化时强制重载
- 修正引导中「装了 OpenClash 必须改前置模式」的误导文案
v1.1.7
v1.1.6
新增
- 脚本安装
install.sh:不用构建、不用下载安装包,一条命令装好插件- 支持
curl与wget - 自动选择依赖安装方式(
apk/opkg) - 内置国内加速:依次尝试
gh-proxy.org、ghfast.top、gh-proxy.com,失败回退 GitHub 直连 - 参数:
-v VERSION(支持latest)、-m URL(可重复)、--no-deps、--src DIR、--uninstall、--purge
- 支持
- 适配 OpenWrt / iStoreOS 25.12(apk 包管理):这类系统无法安装
.ipk,直接用脚本安装即可
# curl
curl -fsSL https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh
# wget
wget -qO- https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh
# 国内网络(脚本与源码都走反代)
curl -fsSL https://gh-proxy.org/https://raw.githubusercontent.com/Ozero-top/luci-app-adguardhome-lite/main/install.sh | sh -s -- -m https://gh-proxy.org修复
- 25.12 首次安装后服务无法启动:配置模板把
ratelimit_whitelist写成 CIDR(127.0.0.0/8、::1/128),AdGuard Home 只接受单个 IP,导致--check-config失败。现已改为127.0.0.1、::1,旧配置在应用设置时自动修正 - 脚本安装不会在
apk的已安装列表里留下记录;升级、卸载请继续使用install.sh
安装包
| 文件 | 适用固件 |
|---|---|
luci-app-adguardhome-lite_1.1.6-1_all.ipk |
OpenWrt 23.05 / 24.10、ImmortalWrt 24.10、iStoreOS 24.10 等新版 LuCI |
luci-app-adguardhome-lite_1.1.6-1-legacy_all.ipk |
OpenWrt 22.03 及更早的原生 Lua LuCI |
luci-app-adguardhome-lite_1.1.6-1.run |
离线自解压包,自动选择版本 |
校验:sha256sum -c SHA256SUMS
实测
- iStoreOS 25.12.6 x86_64:脚本安装、DNS 接管(53 端口)、解析、卸载与重装均正常
- 内核:AdGuard Home v0.107.80
v1.1.5
新增
- 概览「过滤统计」卡片:DNS 查询、已拦截(广告/跟踪)、恶意·钓鱼、成人内容四项数据直接读取 AdGuard Home 统计接口,随状态每 10 秒刷新,不需要打开控制台
- 成人内容拦截开关:基础设置中一键开关,开启自动追加 HaGeZi NSFW 规则(实测 7.4 万条),关闭自动移除,不影响原有过滤规则;规则命中计入「已拦截」
- 规则下载走代理:自动检测 OpenClash 的 HTTP 代理并写入 AdGuard Home 的
http_proxy,解决国内直连 GitHub 导致规则更新失败(rules_count恒为 0)
优化
- 统计合并进
/status接口,前端由两次请求变一次;内核版本与统计数据本地缓存- 首屏:约 535 ms → 150 ms
/stats:365 ms → 81 ms
- 仅「接管 53」模式才检查 nft 收回规则,其它模式跳过额外调用
- 保存接管方式时自动关闭缓存与 DNSSEC、改用并行上游,省去进面板逐项设置
- 概览「快捷操作」更名为「服务控制」,移除四个跳转按钮
注意
- 「安全浏览」(恶意/钓鱼)默认关闭:它依赖境外在线服务,国内不可达时会拖慢甚至阻塞解析
- 新增依赖
luci-lib-jsonc(解析统计接口用,LuCI 通常已自带)
安装包
| 文件 | 适用固件 |
|---|---|
luci-app-adguardhome-lite_1.1.5-1_all.ipk |
OpenWrt 23.05 / 24.10、ImmortalWrt 24.10、iStoreOS 24.10 等新版 LuCI |
luci-app-adguardhome-lite_1.1.5-1-legacy_all.ipk |
OpenWrt 22.03 及更早的原生 Lua LuCI |
luci-app-adguardhome-lite_1.1.5-1.run |
离线自解压包,自动选择版本 |
校验:sha256sum -c SHA256SUMS