garryforreg/adguardhome

AdGuard Home Docker镜像文档

概述

AdGuard Home是一款网络级广告和跟踪器拦截软件，作为DNS服务器运行，通过将跟踪域名重定向到"黑洞"来阻止设备连接这些服务器。它基于AdGuard公共DNS服务器使用的核心技术，无需在设备上安装客户端软件即可覆盖所有家庭设备，提供网络级别的隐私保护和广告过滤。

核心功能与特性

• 广告与跟踪器拦截：阻止广告、跟踪器和***域名，减少网络流量并保护隐私
• 自定义过滤规则：支持添加自定义拦截规则，灵活控制需要阻止或允许的内容
• 网络活动监控：查看设备的DNS查询记录、拦截统计和网络使用情况
• 内置DHCP服务器：简化家庭网络设备IP地址分配和管理
• 加密DNS支持：原生支持DNS-over-HTTPS (DoH)、DNS-over-TLS (DoT)和DNSCrypt作为上游服务器
• 跨平台兼容性：支持Linux、Windows、macOS等多种操作系统，也可通过Docker部署
• 管理界面安全：内置HTTPS支持，保护管理界面访问安全
• 高级安全功能：包括钓鱼和***软件域名拦截、家长控制（成人内容过滤）、强制搜索引擎安全搜索
• 设备级配置：支持为不同设备设置个性化过滤规则和策略
• 访问控制：可限制允许使用AdGuard Home DNS服务的设备范围

与其他解决方案的对比

与公共AdGuard DNS的区别

• 可完全自定义拦截内容，选择具体阻止或允许的域名
• 提供网络活动监控功能，查看设备查询记录和拦截统计
• 支持添加个人自定义过滤规则，满足特定需求
• 完全自主控制，服务器归用户所有，数据隐私更有保障

与Pi-Hole的对比

与传统广告拦截器的区别

DNS级拦截能有效阻止大部分广告和跟踪请求，但灵活性和功能丰富度不及传统客户端广告拦截器。其优势在于可保护无法安装客户端软件的设备（如智能电视、智能音箱、IoT设备等），实现网络级全覆盖保护。

使用场景

• 家庭网络广告和跟踪器拦截，提升上网体验
• 保护儿童上网安全，过滤成人内容和不良网站
• IoT设备隐私保护，阻止智能设备的跟踪行为
• 小型办公室网络广告过滤，提高工作效率
• 需要加密DNS连接的隐私保护需求场景

使用方法

Docker部署

基本运行命令

bash
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/tcp \
    -p 80:80/tcp -p 443:443/tcp \
    -p 853:853/tcp \
    -p 3000:3000/tcp \
    adguard/adguardhome

Docker Compose配置

yaml
version: '3'
services:
  adguardhome:
    image: adguard/adguardhome
    container_name: adguardhome
    restart: unless-stopped
    volumes:
      - /my/own/workdir:/opt/adguardhome/work  # 工作目录，存储日志和临时文件
      - /my/own/confdir:/opt/adguardhome/conf  # 配置目录，存储配置文件
    ports:
      - "53:53/tcp"    # DNS服务TCP端口
      - "53:53/udp"    # DNS服务UDP端口
      - "67:67/udp"    # DHCP服务器端口(可选)
      - "68:68/tcp"    # DHCP客户端端口(可选)
      - "80:80/tcp"    # HTTP管理界面端口
      - "443:443/tcp"  # HTTPS管理界面端口
      - "853:853/tcp"  # DNS-over-TLS端口
      - "3000:3000/tcp" # 初始设置界面端口

初始设置流程

1. 启动容器后，通过http://<服务器IP>:3000访问初始设置界面
2. 设置管理员用户名和密码
3. 配置网络接口和DNS上游服务器（可选择默认或自定义）
4. 应用设置并重启服务
5. 配置设备使用AdGuard Home作为DNS服务器（修改路由器DHCP设置或设备网络设置）

配置说明

核心配置选项

• DNS设置：配置上游DNS服务器、缓存大小、查询日志设置
• 过滤器：管理拦截列表、自定义规则、允许列表
• 客户端：为不同设备设置单独的过滤规则和策略
• DHCP设置：配置IP地址池、租约时间、静态IP分配
• 加密设置：配置HTTPS证书、DoH/DoT服务器设置
• 安全设置：启用钓鱼/***软件拦截、家长控制、安全搜索

自定义过滤规则示例

通过管理界面"过滤器"选项卡添加规则：

• 拦截域名：||example.com^
• 允许域名：@@||example.com^
• 正则表达式：/example\..{2,4}/
• 按设备拦截：192.168.1.100##||example.com^

加密DNS配置示例

在"设置 > DNS设置 > 上游DNS服务器"中添加加密DNS服务器：

• DNS-over-HTTPS：https://dns.adguard.com/dns-query
• DNS-over-TLS：tls://dns.adguard.com
• DNSCrypt：sdns://AQIAAAAAAAAAFDE3Ni4xMDMuMTMwLjEzMDo1NDQzINErR_JS3PLCu_iZEIbq95zkSV2LFsigxDIuUso_OQhzIjIuZG5zY3J5cHQuZGVmYXVsdC5uczEuYWRndWFyZC5jb20

相关资源

• https://github.com/AdguardTeam/AdGuardHome/wiki
• https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
• https://hub.docker.com/r/adguard/adguardhome
• https://github.com/AdguardTeam/AdGuardHome
• 社区支持