跳到主要内容
KernelSU 模块

AD Killer (by NFQUEUE)

不可变 Release 已同步

基于 NFQUEUE 的 Android 本地去广告模块,提供规则管理、应用名单和离线 WebUI。需要内核支持 NFQUEUE。

介绍

AD_Killer_By_NFQUEUE

Important

本项目主要参考月虹分享页中的 YH_Hosts,是基于其产品与功能思路完成的独立开源实现。项目代码主要由大模型辅助,以 Vibe Coding 方式完成。本项目与 YH_Hosts 原作者无隶属或官方合作关系,仅供个人学习、研究与技术交流使用。不保证适用于任何生产环境,也不对误拦截、断网、数据损失、设备异常或其他直接/间接损失承担责任。使用前请自行审查代码、规则源及许可证,并做好备份。

基于 Linux 内核 NFQUEUE 的 Android 系统级去广告模块。核心引擎使用 C++ 实现,支持 KernelSU、Magisk 和 APatch,并提供离线 WebUI。

核心特性

  • 非 VPN 方案:通过 NFQUEUE 处理 DNS、HTTP、TLS 和 QUIC 流量。
  • 纯本地引擎:运行时无外部服务依赖,支持自定义 Hosts / AdGuard 规则。
  • 快速失败:命中后返回 NXDOMAIN、TCP reset 或 ICMP 不可达,减少应用等待超时。
  • 原子更新:规则下载、校验、去重和发布失败时保留当前可用规则。
  • 并发同步:默认同时下载 10 个来源,可在“设置 → 规则同步”调整为 1–20。
  • 灵活范围:支持全局拦截、按应用拦截、应用白名单和 QUIC 开关。
  • 防断网设计:队列冲突拒绝启动,并使用 fail-open、queue-bypass 和链尾兜底。
  • 可视化管理:WebUI 支持状态、规则源、应用范围、日志和单源测试。

界面预览

手机尺寸截图,使用演示数据。

概览应用名单
手机界面:概览,展示守护状态与本地规则库 手机界面:应用名单,展示应用放行选择
规则管理设置
手机界面:规则管理,展示开源规则来源 手机界面:设置,展示检查更新、更新日志等入口

环境要求

  • Android 12(API 31)及以上。
  • arm64-v8a 设备。
  • KernelSU、Magisk 或 APatch。
  • 内核需支持 NFQUEUE、conntrack、mangle、owner 和 queue-bypass。

Warning

NFQUEUE 0/1 被其他程序占用时,模块会拒绝启动。如已安装 YH_Hosts 或其他同类模块,请先停用、卸载并重启设备。

安装与使用

  1. 从 Releases 下载最新 ZIP。
  2. 在根权管理器中刷入模块并重启。
  3. 打开 WebUI,在“规则”中保存来源,回到概览页执行同步。
  4. 确认规则正常后手动启动引擎;首次安装默认暂停且不开机自启。

运行数据保存在 /data/adb/AD_Killer_By_NFQUEUE/。规则源最多支持 64 个普通 HTTP(S) 地址,默认启用 HaGeZi Pro − Fake 内置来源,可手动停用。

升级保留数据;卸载默认清空本模块规则、名单、日志与下载缓存。卸载失败请按 ADB 手册核实残留。

在“设置 → 检查更新”中下载校验并确认安装,可选预览版与自动检查;自动检查默认关闭,不自动安装。更新日志读取 GitHub 最新 Release。安装后需手动重启,v1.0 首次升级需在根管理器中手动刷入完整 ZIP。

也可直接在 KernelSU 模块页检查正式版更新,无需打开 WebUI,详见原生更新说明。

本地构建

需要 Android NDK r26+、Node.js 22.12+ / 24 LTS、npm 和 Python 3:

NDK=/path/to/android-ndk ./build.sh
python3 tests/verify_checksum.py dist/AD_Killer_By_NFQUEUE-v1.2.7.zip

构建产物位于 dist/。版本号仅在 module/module.prop 中维护。 CI 保留正式/预览两套构建产物;公开发布需手动选择全绿 CI 的对应产物,并一次性发布到未使用的新标签,不再覆盖预览附件。详见模块仓库收录与发布。

测试

npm --prefix frontend ci --include=dev
make test

主机测试不会修改本机防火墙。需要 root 的真实 NFQUEUE 测试仅应在一次性 Linux 环境执行。

文档

许可证

项目自有代码使用 MIT License。第三方库与规则源仍需遵守各自的许可条款。

历史版本

v1.2.14

最新

版本代码 13401 v1.2.14

下载

v1.2.14 · 规则同步进度与更新体验

  • 模块更新改为确认目标版本后,连续完成下载、校验和安装;全程显示状态,完成后提示手动软重启。
  • 概览显示并发同步进度、逐源结果与重试次数;来源列表精简状态说明,增加“需要处理”筛选和详细原因。
  • 设置新增同步时间间隔,默认 30 分钟:再次手动同步复用有效成功缓存,失败来源继续下载;不会自动定时同步。
  • 设置新增每源失败重试次数,默认 2 次(首次失败后额外重试),支持 0–5 次;并发数仍默认 10、最高 20。
  • 失败来源不再阻止其余来源准备缓存;继续保持全部启用来源通过后整体更新,失败时保留完整旧规则。

升级保留规则、来源、应用名单和设置;卸载默认删除本模块全部数据,包括日志和下载缓存。 安装后请自行软重启,再检查守护和规则生效状态。

文件 1

AD_Killer_By_NFQUEUE-v1.2.14.zip 794.0 KiB

SHA-256 ae28e823c2e5d3cee30b833dcb7ec98bc433dc28d63efac7099ac8f0656ce88b · Attestation

透明度

Tag
v1.2.14 不可变 Release
Tag commit
0d9fb31d3aef
内容 commit
f331523d9ec3
SHA-256
ae28e823c2e5d3cee30b833dcb7ec98bc433dc28d63efac7099ac8f0656ce88b
最近同步到变更

自行复核

KernelSU 模块不对模块签名,也不审计模块代码。SHA-256 只证明下载内容与本索引一致。可使用 GitHub CLI 自行复核:

gh release verify v1.2.14 -R fengwenhua/AD_Killer_By_NFQUEUE
gh release verify-asset v1.2.14 AD_Killer_By_NFQUEUE-v1.2.14.zip -R fengwenhua/AD_Killer_By_NFQUEUE