Files
small-packages/luci-app-adguardhome
2026-11-17 10:44:34 +08:00
..
2026-11-17 10:44:34 +08:00
2026-11-17 10:44:34 +08:00
2026-11-17 10:44:34 +08:00
2026-11-08 11:57:35 +08:00
2026-11-17 10:44:34 +08:00
2026-11-17 10:44:34 +08:00

luci-app-adguardhome

适用于 OpenWrt / ImmortalWrt 的 AdGuard Home LuCI 控制面板。

基于 rufengsuixing/luci-app-adguardhome 维护, 针对 ImmortalWrt 24.10+ 进行了大量 UI 重构和 Bug 修复。

兼容性

系统 状态
ImmortalWrt 24.10 / 25.12 主要测试目标,完全兼容
OpenWrt 23.05 兼容
OpenWrt 21.02 / 22.03 兼容
OpenWrt 19.07 兼容(jail 字段回退为 TextValue)
OpenWrt 18.06 基本兼容(DynamicList 自动回退)

DNS 重定向会自动选择防火墙后端:fw4(OpenWrt 22.03+ / ImmortalWrt 24.10+)使用原生 nftables 规则,fw3 使用 iptables;无需手动安装或切换 iptables 兼容包。

截图

概览

概览

基础设置

基础设置

运维

运维

日志

日志

手动配置

手动配置

功能

  • 概览面板:服务状态、重定向模式、核心版本、一键启停 + Web 控制台快捷入口
  • 基础设置:启用开关、管理端口、核心更新、重定向模式(4 种,卡片式选择 + 后端/端口/生效状态提示,自动适配 fw4/nftables 与 fw3/iptables)、路径配置、进程参数
  • 服务自检:启动/停止失败或状态异常时清理孤儿进程、恢复缺失配置、重建重定向规则(不再自动杀进程)
  • 诊断页:服务/procd、配置校验、DNS/Web 端口占用、防火墙后端、重定向规则、磁盘/内存、系统日志一览,可复制完整报告
  • 配置中心:配置备份/恢复、核心回滚(保留上一版核心)、默认 admin/admin
  • WAN 排除:可指定 WAN 侧接口,避免 53 端口劫持把路由器变成开放解析器
  • 日志增强:运行日志之外可查看 procd/AGH stderr 系统日志
  • English UI:新增 po/en 英文翻译源(编译时由 luci.mk 生成 lmo)
  • 工具与任务:改密、sysupgrade 保留文件、关机备份、Crontab 计划任务
  • 日志查看:实时轮询、反向/本地时区切换、下载、清空
  • 手动配置:YAML 编辑器(CodeMirror 可选),保存前二次确认
  • 核心自动更新:GitHub/AdGuard 多源下载 → UPX 压缩 → 重启服务
  • UPX 压缩:>8MB 二进制自动压缩(支持 x86_64 / arm64 / mips 等架构)
  • 计划任务:自动更新核心、切割日志、IPv6 hosts 同步
  • 升级保护:sysupgrade 保留文件 + 关机备份

默认 Web 登录:admin / admin。首次登录后请立即在「运维 → 修改网页管理密码」中修改。

安装

Feed 方式

echo 'src-git adguardhome https://github.com/kenzok78/luci-app-adguardhome' >> feeds.conf.default
./scripts/feeds update -a && ./scripts/feeds install -a -p adguardhome
make package/luci-app-adguardhome/compile V=s

直接编译

git clone https://github.com/kenzok78/luci-app-adguardhome.git package/luci-app-adguardhome
make menuconfig  # LuCI → Applications → luci-app-adguardhome
make -j$(nproc) V=s

重定向模式

模式 说明
不启用 仅运行,不拦截 DNS
作为 dnsmasq 上游 dnsmasq 转发到 AGH
53 端口劫持 自动使用 nftables(fw4)或 iptables(fw3)把发往路由器的 53 端口 DNS 请求重定向到 AGH
替代 dnsmasq AGH 直接监听 53

许可证

Apache-2.0