scys/adguardhome

AdGuard Home Docker镜像文档

镜像概述

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

核心功能与特性

• 广告和跟踪器拦截：通过DNS sinkholing技术阻止广告和跟踪域名
• 自定义过滤规则：支持添加自定义规则，灵活控制拦截内容
• 内置DHCP服务器：简化网络设备管理
• 加密管理界面：支持HTTPS保护管理界面安全
• 加密DNS上游：支持DNS-over-HTTPS、DNS-over-TLS和DNSCrypt
• 跨平台支持：可在多种操作系统上运行
• 安全功能：拦截钓鱼和***软件域名
• 家长控制：阻止成人内容域名，强制搜索引擎安全搜索
• 设备级配置：支持针对不同设备设置个性化规则
• 访问控制：可配置允许使用DNS服务的客户端

使用场景

• 家庭网络广告和跟踪保护，覆盖所有设备（包括智能电视、智能家居设备等无法安装传统广告拦截器的设备）
• 企业或小型办公网络的集中广告控制
• 需要保护网络隐私的个人用户
• 希望监控和管理家庭网络活动的场景

使用方法

Docker Run 部署

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

Docker Compose 配置

yaml
version: '3'
services:
  adguardhome:
    image: adguard/adguardhome
    container_name: adguardhome
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80/tcp"
      - "443:443/tcp"
      - "3000:3000/tcp"
    volumes:
      - /my/own/workdir:/opt/adguardhome/work
      - /my/own/confdir:/opt/adguardhome/conf
    restart: unless-stopped

初始配置

1. 容器启动后，通过 http://<服务器IP>:3000 访问初始设置界面
2. 按照向导完成管理员账户设置和网络配置
3. 配置设备使用AdGuard Home作为DNS服务器

配置说明

数据卷

• /opt/adguardhome/work: 工作目录，存储临时文件
• /opt/adguardhome/conf: 配置目录，存储持久化配置文件

端口说明

• 53/tcp 和 53/udp: DNS服务端口
• 80/tcp: HTTP服务端口（用于DNS-over-HTTP和管理界面）
• 443/tcp: HTTPS服务端口（用于加密管理界面和DNS-over-HTTPS）
• 3000/tcp: 初始设置界面端口（配置完成后自动关闭）

与其他解决方案的比较

与公共AdGuard DNS的区别

运行自己的AdGuard Home服务器相比公共DNS提供更多控制权：

• 自定义拦截规则
• 监控网络活动
• 添加个人过滤规则
• 完全掌控自己的服务器

与Pi-Hole的比较

与传统广告拦截器的比较

DNS级拦截能覆盖更多设备类型（如智能电视、IoT设备），但灵活性不如传统广告拦截器。适合需要保护整个网络且无法在每个设备上安装广告拦截器的场景。

相关资源

• 官方网站
• https://github.com/AdguardTeam/AdGuardHome/wiki
• https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
• https://hub.docker.com/r/adguard/adguardhome