sk278/adguardhome

AdGuard Home

镜像概述和主要用途

AdGuard Home是一款网络级广告和跟踪拦截软件。部署后，它能覆盖所有家庭设备，无需在设备上安装客户端软件，通过作为DNS服务器工作，将跟踪和广告域名重定向到“黑洞”，从而阻止设备连接到这些服务器。其基于AdGuard公共DNS服务器使用的软件构建，共享大量通用代码。

核心功能和特性

• 网络级拦截：作为DNS服务器运行，拦截广告和跟踪域名，阻止设备连接到这些服务器
• 全设备覆盖：无需客户端软件，部署后自动覆盖家庭网络中的所有设备
• 自定义控制：可精确选择阻止或允许的内容，添加自定义过滤规则
• 网络监控：能够监控家庭网络活动，了解设备连接情况
• 扩展性：未来计划扩展为不仅仅是DNS服务器的功能

使用场景和适用范围

• 家庭网络广告和跟踪拦截，保护所有家庭成员的设备
• 企业或小型办公网络的广告过滤和隐私保护
• 需要自定义网络内容过滤规则的场景
• 希望监控网络活动并优化网络连接的用户

使用方法和配置说明

前提条件

• 已安装Docker和Docker Compose（可选）
• 具有管理员权限的设备

Docker部署步骤

1. 创建数据卷

bash
docker volume create adguard

2. 运行容器

bash
docker run -d \
    -p 53:53 \  # DNS TCP端口
    -p 53:53/udp \  # DNS UDP端口
    -p 3000:3000 \  # Web管理界面端口
    -v adguard:/data/adguard \  # 数据持久化
    --restart always \  # 容器自动重启
    sk278/adguardhome:latest

3. 访问管理界面

容器启动后，通过 http://<服务器IP>:3000 访问Web管理界面，完成初始配置。

Docker Compose配置（可选）

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  adguardhome:
    image: docker.xuanyuan.run/sk278/adguardhome:latest
    ports:
      - "53:53"
      - "53:53/udp"
      - "3000:3000"
    volumes:
      - adguard:/data/adguard
    restart: always

volumes:
  adguard:

启动服务：

bash
docker-compose up -d

版本更新日志

• Initial Release 0.9
• Update to 0.9-hotfix1
• Update to 0.91

更多信息

项目主页：https://github.com/AdguardTeam/AdGuardHome