Repository navigation
Releases: liuzq2002/AdguardHome-Mod
Release list
AdGuard Home Mod v2026-09-27
这是 AdGuard Home 的修改版(Mod)。
tag 带 -beta、-rc.1 这类后缀时是预发布,供测试使用,不会抢占「最新版本」。
发版只提供 Linux arm64 的发布包,解压后替换可执行文件即可。amd64 只用于本地测试,不随发版提供,需要的话到 Actions 页面下载 AdGuardHome-linux 产物。
AdGuardHome_linux_arm64.tar.gz— arm64checksums.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
这是 AdGuard Home 的修改版(Mod)。
tag 带 -beta、-rc.1 这类后缀时是预发布,供测试使用,不会抢占「最新版本」。
发版只提供 Linux arm64 的发布包,解压后替换可执行文件即可。amd64 只用于本地测试,不随发版提供,需要的话到 Actions 页面下载 AdGuardHome-linux 产物。
AdGuardHome_linux_arm64.tar.gz— arm64checksums.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
预览版:修改版(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。