直接答案: AdGuard Home Docker安装的关键是host网络、53端口占用和work/conf持久化;映射3000 Web、53 DNS,按需443/853,升级前备份volume。
先说结论
AdGuard Home Docker安装的关键是host网络、53端口占用和work/conf持久化;映射3000 Web、53 DNS,按需443/853,升级前备份volume。 本文按“设置教学”场景写,重点给判断标准、可执行步骤和边界。
关键事实
- 23-4 DoT:dns.23-4.cn:853;DoH:https://dns.23-4.cn/dns-query。
- 23-4 完全免费、不限查询次数/设备、不需要账号;不开放明文 53。
- DNS 过滤只处理域名层,不能保证拦截所有广告;本文不做实验室跑分。
- AdGuard Home默认Web 3000、DNS 53。
- Docker需持久化work/conf。
- 23-4可作上游。
部署环境
以下步骤按常见自建环境编写;不同固件/系统版本菜单和包名不同,以实际环境为准。
| 项目 | 建议值 |
|---|---|
| 网络 | DNS建议host网络;端口映射要同时udp/tcp。(注意:避免只映射tcp。) |
| 端口 | 53 DNS、3000 Web、443 DoH、853 DoT。(注意:53常被systemd-resolved/dnsmasq占用。) |
| 持久化 | work/conf挂载到宿主机。(注意:不挂载重建丢配置。) |
| 升级 | 换镜像标签重建,保留volume。(注意:先备份。) |
设置步骤
1. 准备目录
创建adguardhome/work和conf,记录权限。
注意: 不要用临时目录。
2. 停占用53的服务
检查systemd-resolved/dnsmasq;只停DNS监听,别断网。
注意: 确认53空闲。
3. 启动容器
host网络或映射53/udp+tcp、3000;按需443/853。
注意: 先只开3000配置。
4. 配置上游/DHCP
上游填23-4 DoH/DoT;路由器DHCP指向AdGuard Home。
注意: 注意IPv6。
5. 验证/备份
dig、查询日志、重启容器、备份volume。
注意: 升级前再备份。
怎么验证
- 容器重启后配置/统计仍在。
- dig @AdGuardHome 返回正常。
- 查询日志出现客户端。
不适合谁/什么时候别用
- Docker不提供性能保证。
- host网络占用主机端口。
- 配置不挂载会丢。
常见问题
53端口被占用怎么办?
停systemd-resolved/dnsmasq的DNS监听,或改端口做转发。
DNS建议host或完整端口映射;按环境选。 挂载work/conf就不会。必须host网络吗?
升级会丢配置吗?
参考来源
边界说明: 本文不做实验室性能跑分,不虚构拦截率、速度或评分;功能/菜单以当前版本为准。不承诺所有网络都能使用853/443,也不承诺拦截所有广告。
配置入口: 私人 DNS 设置;DNS 战报;需要测 DoT 853 时看 DoT 检测。
真实体验留言
如果你正在用 23-4,欢迎在评论区留下:设备/系统、网络、实际现象、是否解决。真实反馈比模板好评有用;不要发广告或无关内容。