adam9999/adguardhome

AdGuard Home Docker镜像

镜像概述和主要用途

AdGuard Home是一款网络级广告和追踪拦截软件。设置完成后，它将覆盖您所有的家庭设备，且无需任何客户端软件。

此Docker镜像基于官方adguard/adguardhome镜像构建，通过优化配置提升了性能和可用性，包括：

• 微调DNS参数
• 并行多上游服务器
• 分类拦截列表

!AdGuardHome

核心功能和特性

• 网络级拦截：在网络层面阻止广告和追踪，覆盖所有连接设备
• 无需客户端软件：一次设置，全家庭设备受益
• 优化性能：通过微调DNS参数提升解析速度
• 灵活上游服务器：支持并行多上游DNS服务器配置
• 分类拦截：按类别管理拦截列表

使用场景和适用范围

• 家庭网络广告和追踪保护
• 提升家庭网络隐私安全
• 简化多设备广告过滤管理
• 需要DNS级内容过滤的场景

使用方法和配置说明

快速启动

默认情况下，DNS端口53可能被resolved守护进程占用，需先禁用：

bash
sudo sh -c 'echo "DNS=127.0.0.1\nDNSStubListener=no" >> /etc/systemd/resolved.conf' && sudo systemctl restart systemd-resolved.service

使用以下命令创建并运行AdGuard Home容器：

bash
sudo docker run --name adguardhome \
    --restart unless-stopped \
    -v /my/own/workdir:/opt/adguardhome/work \
    -v /my/own/confdir:/opt/adguardhome/conf \
    -p 80:80/tcp \
    -p 53:53/tcp -p 53:53/udp \
    -d adam9999/adguardhome

启动后，打开浏览器访问http://127.0.0.1/，默认登录凭据为admin/password。

端口映射

所有暴露端口说明如下：

-p 80:80/tcp: 管理面板
-p 53:53/tcp -p 53:53/udp: 常规DNS
-p 67:67/udp -p 68:68/tcp -p 68:68/udp: 若使用AdGuard Home作为DHCP服务器需添加
-p 443:443/tcp -p 443:443/udp: 若运行DNS-over-HTTPS服务器需添加
-p 853:853/tcp: 若运行DNS-over-TLS服务器需添加
-p 784:784/udp -p 853:853/udp -p 8853:8853/udp: 若运行DNS-over-QUIC服务器需添加（可选择其中一两个）
-p 5443:5443/tcp -p 5443:5443/udp: 若运行DNSCrypt服务器需添加

DHCP服务器配置

如果要使用AdGuard Home的DHCP服务器功能，创建容器时需添加--network host参数：

bash
docker run --name adguardhome --network host ...