【AdGuard Home v1.0】测试完毕,稳定版正式就绪
9 月底,我们发布了 AdGuard Home v1.0 的首个 beta 版。beta 阶段经历两个公开版本、修掉 22 个问题,如今顺利收尾,产品也迈上了新的里程碑。此前好几个月,项目只有例行更新,后来我们转向积极开发。做了不少工作,现在就把成果摆给大家看。
八年的旅程
AdGuard Home 于 2018 年以 v0.1 预览版问世。不得不说,最初的界面出自一位「边写代码边学」的开发者之手。它谈不上完美,但活能干,产品也因此一步步长成了大家信得过的工具。这些年来,项目一路茁壮:我们加入了内置更新器、客户端标签等重要功能,还率先支持了 DNS-over-QUIC。关于这些,我们在近期 beta 版文章中写得很详细,想了解更多可以一读。
除了 AdGuard Home 如何变成今天这个样子,也值得看看它过去是怎么发版的,以及上个 beta 版之后有哪些变化。
版本号的新思路
过去我们的版本号多少有些随意,编号方式也和其他 AdGuard 产品对不上。比如从 v0.1 直接跳到 v0.9,接着又是 v0.91。2020 年我们改用语义化版本,一路数到 v0.107。
随着项目发展,彻底变革的必要性越来越明显。旧界面挡住了那些可能打乱现有配置的重大功能,所以很长一段时间里,我们只做针对性修补,不敢动大手术。
v1.0 把我们带上了一个新台阶:采用与其他 AdGuard 产品类似的灵活版本方案,区分补丁、次版本和重大版本。今后,次版本更新(如 v1.0.0 到 v1.1.0)也可能包含不向后兼容的改动。解除这些限制,我们就能更快交付新功能,全面翻新的界面就是明证。
这次升级不需要您做任何事:v1.0 与 v0.107.x 沿用相同的配置架构,现有
AdGuardHome.yaml和数据目录原样可用。
界面全新,逻辑照旧
界面是彻底重写的:新前端、更低的内存占用、在低功耗设备上依然流畅的界面,以及手机和桌面都能用的布局。结构刻意保持熟悉,分区没变、位置没变,切换过去不用花时间适应。

有三个页面变的不只是外观:客户端设置现在可以按设备分配配置方案和规则;查询日志的每张卡片显示更多细节,还新增了排序和筛选;「过滤器」版块把黑名单、白名单、DNS 重写和用户规则集中到一处,更新间隔可自行设置。界面其余部分则是换了新皮肤的老逻辑,仪表盘也包括在内。
带截图的完整导览请看我们的 Beta 版文章,文中描述的界面就是今天发布的这一版。
上个 Beta 版之后的改动
v1.0 的首个 Beta 版带来了全局性的界面改版,第二个 beta 版则完全围绕稳定性。下面划重点,完整列表见版本历史。
- DHCP:现在,即使网络接口兼容 IPv6,也能保存 IPv4 设置;仅配置 DHCPv6 时,DHCP 也能正常启动;子网校验按预期工作。
- 客户端与 ClientID:接受内含 IPv4 地址的 IPv6 CIDR;拒绝带前导零的畸形 MAC 地址;按客户端设置的时间表在保存后不再丢失。
- 界面:长数值不再溢出对话框;加密 DNS 地址会立即显示在设置指南中;安装向导支持 emoji 密码。
- DNS:DoH 路由为空时,DDR 会返回有效的 SVCB 记录;时间表不再随时钟调整而错位;启用私有反向 DNS 后,命令行更新可正常工作。
- 其他:
--check-config在首次启动时行为正确;log.enabled: false现在能真正关闭旧版日志记录器。
还有一项改动值得一提。客户端设置现在分得更细:「使用全局设置」只涵盖「保护」一项,已阻止的服务有独立开关,而上游和缓存设置始终可以单独编辑。想多个客户端共用一套配置,就应用全局设置;想区别对待,就逐个客户端单独设置。
总的来说,相较 v0.107.80,v1.0.0 带来 22 项稳定性改进和 1 项行为变化。真正的重头戏是界面改版,而大规模的返工都发生在 beta 阶段。
未来版本的规划
AdGuard Home v1.0 不会是最后一个带来重大变化的版本,我们计划持续打磨,直到它发挥出全部潜力。自诊断页面、过滤列表批量导入、界面内置搜索工具,以及自动签发和续期 TLS 证书的能力,都在开发之中。今后,我们会以更快的节奏推进产品。
如何更新或切换到 v1.0
注意:默认 DNS 服务商已变更
全新安装现在默认使用 Cloudflare DNS 作为上游和引导服务器,不再是 Quad9。Quad9 仍可手动选用。
现有安装会保留当前设置,我们不会自动改写配置。如果您从未改动过旧的默认值,而流量又经由法国,请在 11 月 24 日之前把上游和引导服务器一起换掉:Quad9 从那天起不再为该地区用户提供服务。具体地址见发布说明。
AdGuard Home 有多个更新通道,各有特点。这里简单回顾一下操作方法:
如果您使用的是 Beta 或 Edge 通道:无需任何操作,内置更新器会自动完成更新。
如果您使用的是稳定版:按界面提示更新即可。
如果您习惯使用 CLI:运行命令 ./AdGuardHome --update -v
如果您通过 Docker 更新:将镜像标签设为 :latest,然后重新创建并重启容器。
分享您的反馈意见
感谢大家在帮我们测试 Beta 版时提交的反馈!凡是我们收到的问题,都已定位并及时修复。如果您有建议,或发现哪里不对劲,欢迎到 GitHub 告诉我们。
小提示:先用搜索栏查一下,看是否已有人报告过该问题。如果是新的问题,请新建一个 issue,我们会立刻着手处理。










