Skip to content

Releases: liuzq2002/AdguardHome-Mod

AdGuard Home Mod v2026-09-27

Choose a tag to compare

@github-actions github-actions released this 27 Sep 06:03

这是 AdGuard Home 的修改版(Mod)。

tag 带 -beta、-rc.1 这类后缀时是预发布,供测试使用,不会抢占「最新版本」。

发版只提供 Linux arm64 的发布包,解压后替换可执行文件即可。amd64 只用于本地测试,不随发版提供,需要的话到 Actions 页面下载 AdGuardHome-linux 产物。

  • AdGuardHome_linux_arm64.tar.gz — arm64
  • checksums.txt — 压缩包的 SHA-256 校验和

解压与校验:

tar -xzf AdGuardHome_linux_arm64.tar.gz
sha256sum -c --ignore-missing checksums.txt

主要为 Adguard-Home-For-Magisk-Mod 适配。改动内容、构建方式与上游同步方法见仓库首页的 README。

What's Changed

  • 新增维护手册:日常流程、发版、在线更新与排错 by @herta0426 in #13

Full Changelog: v2026-09-25-beta-1...v2026-09-27

AdGuard Home Mod v2026-09-25-beta-1

Pre-release

Choose a tag to compare

@github-actions github-actions released this 25 Sep 07:43
d1cffe2

这是 AdGuard Home 的修改版(Mod)。

tag 带 -beta、-rc.1 这类后缀时是预发布,供测试使用,不会抢占「最新版本」。

发版只提供 Linux arm64 的发布包,解压后替换可执行文件即可。amd64 只用于本地测试,不随发版提供,需要的话到 Actions 页面下载 AdGuardHome-linux 产物。

  • AdGuardHome_linux_arm64.tar.gz — arm64
  • checksums.txt — 压缩包的 SHA-256 校验和

解压与校验:

tar -xzf AdGuardHome_linux_arm64.tar.gz
sha256sum -c --ignore-missing checksums.txt

主要为 Adguard-Home-For-Magisk-Mod 适配。改动内容、构建方式与上游同步方法见仓库首页的 README。

What's Changed

  • README 改成中文优先,排版对齐上游 by @herta0426 in #7
  • 把「精简版」改成「修改版 / Mod」 by @herta0426 in #8
  • 整理配置层:新增 mod 配置模板、清理迁移里的死键 by @herta0426 in #9
  • 彻底删除 DHCP:后端、接口、配置与依赖 by @herta0426 in #10
  • 发版流程:支持 -beta 预发布、只发布 arm64、更新源改为仓库里的 version.json by @herta0426 in #11
  • 版本号支持带连字符的预发布后缀(v2026-09-25-beta-1) by @herta0426 in #12

Full Changelog: v2026-09-24...v2026-09-25-beta-1

预览版 v2026-09-24

预览版 v2026-09-24 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 24 Sep 14:06
66983e6

预览版:修改版(Mod)的改动已合并到 main(PR #6、#7、#8,合并提交 bf485a1),只发 Linux x86_64 与 arm64。

仓库定位:AdGuard Home 的非官方修改版(Mod),主要为 Adguard-Home-For-Magisk-Mod 适配。去掉用不到的部分只是第一步,后续会继续加入本项目自己的功能。

下载

文件 架构
AdGuardHome_linux_amd64.tar.gz x86_64
AdGuardHome_linux_arm64.tar.gz arm64
checksums.txt 校验和

sha256(与 checksums.txt 一致):

amd64  8e5981733643f978171f30b900b7a20ae608a30f2705279ad307867157d861ff
arm64  ea12b913fd9a741c329f3a6965e3d470694e335ec3f76e89bba291112f0e48fe

checksums.txt 里还有一行 AdGuardHome_frontend.tar.gz,那是 CI 内部的中间产物,没有随本预览发布,所以直接对整个文件跑 sha256sum -c 会提示缺这一个文件,按架构比对上面两行即可。

本次改动

  • 删除「加密设置」选项卡及全部功能:页面、路由、action/reducer、HTTP 调用。
  • 删除查询日志筛选里的「已阻止的服务 / 拦截的威胁 / 被家长控制阻止 / 安全搜索」;筛选下拉现在只剩:所有查询记录、已过滤、已处理、已阻止、允许项、重写项。
  • 删除首页对应的统计卡片(被拦截的恶意/钓鱼网站、被拦截的成人网站、强制安全搜索、0 / 0%)以及底部的客户端排行。
  • 删除「安全搜索」功能本身:前后端代码、各搜索引擎规则文件、HTTP API。
  • 删除「已阻止的服务」功能本身:3415 行服务清单、服务图标接口、客户端与统计里的相关字段。
  • 查询日志的「放行 / 拦截」按钮旁只保留单个按钮,去掉「仅对此客户端拦截」「仅解除对此客户端的拦截」「不允许这个客户端」「添加为持久客户端」。

有意保留的部分

  • 查询日志和统计文件里的 reason / result 编号(7、8、9、10、11 与 RSafeSearch)保留为占位常量,老日志、老统计文件升级后仍能正常读取。
  • internal/configmigrate 的历史迁移里仍会出现 safe_search / blocked_services 字样,那是给老版 AdGuardHome.yaml 升级用的,删掉会导致老配置无法迁移。

安装

tar -xzf AdGuardHome_linux_arm64.tar.gz

替换原来的可执行文件后重启。面板「更新」处应显示版本 v2026-09-24;若显示 v0.107.x 之类,说明装的仍是官方原版。浏览器建议强刷一次,避免缓存到旧的 JS。