本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
AdGuard Home 是一款网络级广告和追踪器拦截工具。部署后,它能覆盖你家中所有设备,无需在每个设备上单独安装客户端。更多信息可查看其官方 GitHub 仓库。
执行以下命令拉取最新稳定版镜像:
docker pull adguard/adguardhome
镜像需要两个持久化目录来保存数据和配置:
/my/own/workdir/my/own/confdir使用以下命令创建容器并启动 AdGuard Home(记得替换成你自己的目录路径):
docker run --name adguardhome \ --restart unless-stopped \ -v /my/own/workdir:/opt/adguardhome/work \ -v /my/own/confdir:/opt/adguardhome/conf \ -p 53:53/tcp -p 53:53/udp \ -p 67:67/udp -p 68:68/udp \ -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp \ -p 853:853/tcp \ -p 784:784/udp -p 853:853/udp -p 8853:8853/udp \ -p 5443:5443/tcp -p 5443:5443/udp \ -d adguard/adguardhome
容器启动后,打开浏览器访问 `[***] 即可进入管理界面。
端口说明:
53/tcp/udp:DNS 基础端口67/udp、68/tcp/udp:DHCP 服务(如需使用才映射)80、443、3000:管理面板及 HTTPS/DNS-over-HTTPS853/tcp:DNS-over-TLS784、853、8853/udp:DNS-over-QUIC(可只保留需要的)5443/tcp/udp:DNSCrypt 服务docker start adguardhomedocker stop adguardhomedocker rm adguardhome拉取最新镜像:
docker pull adguard/adguardhome
停止并删除当前容器(数据会保留在持久化目录):
docker stop adguardhome docker rm adguardhome
用新镜像重新创建容器(使用之前的启动命令即可)。
如需体验测试版,将镜像标签改为 edge(开发版)或 beta(测试版)。例如拉取开发版:
docker pull adguard/adguardhome:edge
其他命令(如创建容器)中的镜像名也需对应修改。
首次运行后,配置目录会生成 AdGuardHome.yaml 文件,包含默认设置。需在容器停止时修改该文件,否则运行中的程序会覆盖修改。配置参数说明可参考 官方文档。
如需使用 AdGuard Home 的 DHCP 功能,创建容器时需添加 --network host 参数(使用主机网络):
docker run --name adguardhome --network host ...(其他参数不变)
此时无需再用 -p 映射端口。注意:该参数仅支持 Linux 主机,Mac/Windows 不适用。
若系统运行 resolved 守护进程,会占用 127.0.0.53:53 导致端口冲突。解决步骤:
创建 resolved 配置文件:
新建 /etc/systemd/resolved.conf.d/adguardhome.conf(目录不存在则创建),添加:
[Resolve] DNS=127.0.0.1 # 指向 AdGuard Home DNSStubListener=no # 关闭 DNS 监听
更新 resolv.conf 链接:
mv /etc/resolv.conf /etc/resolv.conf.backup ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
重启 resolved 服务:
systemctl reload-or-restart systemd-resolved
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429