Skip to content

Releases

v1.3.2-B3

Choose a tag to compare

@Ozero-top Ozero-top released this 15 Nov 19:50

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.org

2. 离线脚本(.run)

sh luci-app-adguardhome-lite_1.3.2-B3.run

3. ipk(opkg 固件)

opkg install luci-app-adguardhome-lite_1.3.2-B3_all.ipk

OpenWrt 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

Choose a tag to compare

@Ozero-top Ozero-top released this 15 Nov 19:35

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 未启用时回退到本机 DNSMasq 1745,不会因上游端口不存在而断网
  • 概览新增 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.org

2. 离线脚本(.run)

sh luci-app-adguardhome-lite_1.3.2-B2.run

3. ipk(opkg 固件)

opkg install luci-app-adguardhome-lite_1.3.2-B2_all.ipk

OpenWrt 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

Choose a tag to compare

@Ozero-top Ozero-top released this 15 Nov 14:55

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.org

2. 离线脚本(.run)

sh luci-app-adguardhome-lite_1.3.2-B1.run

3. ipk(opkg 固件)

opkg install luci-app-adguardhome-lite_1.3.2-B1_all.ipk

OpenWrt 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

Choose a tag to compare

@Ozero-top Ozero-top released this 14 Nov 17:24

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

Choose a tag to compare

@Ozero-top Ozero-top released this 14 Nov 09:28

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 订阅管理

其它

  • 新装模板 ratelimit 20 → 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.run

Release 附件包含 modern / legacy 两个 ipk、离线 .run 与 SHA256SUMS。

v1.2.0

Choose a tag to compare

@Ozero-top Ozero-top released this 13 Nov 08:14

重新打包(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

Choose a tag to compare

@Ozero-top Ozero-top released this 12 Nov 05:24

安装 / 更新

脚本安装(推荐,自动识别架构与包管理器):

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.org

ipk 安装(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

Choose a tag to compare

@Ozero-top Ozero-top released this 12 Nov 04:56

更新内容

  • 调整运行日志与高级配置框高度,修复独立页面背景无法随内容收缩的问题

v1.1.6

Choose a tag to compare

@Ozero-top Ozero-top released this 10 Nov 08:28

新增

  • 脚本安装 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

Choose a tag to compare

@Ozero-top Ozero-top released this 10 Nov 05:53

新增

  • 概览「过滤统计」卡片: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