leonekwolfik/adguardhome

AdGuardHome Docker镜像文档

镜像概述

AdGuardHome Docker镜像是基于AdGuardHome应用程序的容器化部署方案，主要用于提供DNS级别的广告拦截、***网站过滤和网络隐私保护功能。通过容器化部署，可快速搭建轻量级、高效的网络防护服务，适用于家庭网络、小型办公环境等场景。

核心功能与特性

• DNS广告拦截：过滤网页、应用中的广告和跟踪器，提升网络浏览体验
• 隐私保护：阻止第三方跟踪器收集用户数据，保护网络隐私
• Web管理界面：通过3000端口提供直观的Web管理界面，支持配置规则、监控统计等
• 多端口支持：集成DNS服务(53/udp)、HTTP(80)和HTTPS(443)服务，满足基础网络需求
• 数据持久化：通过挂载数据卷保存配置和运行数据，确保服务重启后配置不丢失

使用场景

• 家庭网络广告拦截：为家庭所有设备提供广告过滤服务
• 小型办公网络防护：阻止***网站访问，提升网络安全性
• 个人设备网络优化：在服务器或路由器上部署，为整个网络提供防护

使用方法与配置说明

基本部署命令

通过以下命令快速启动AdGuardHome容器：

bash
docker run -v /opt/AdGuardHome/data:/opt/AdGuardHome/data \
  -p 3000:3000 \
  -p 53:53/udp \
  -p 80:80 \
  -p 443:443 \
  -itd adminakademia/adguardhome

参数说明

• -v /opt/AdGuardHome/data:/opt/AdGuardHome/data: 挂载数据卷，用于持久化存储配置文件和运行数据
• -p 3000:3000: 映射Web管理界面端口，首次访问需通过此端口进行初始配置
• -p 53:53/udp: 映射DNS服务端口，提供DNS解析功能
• -p 80:80: 映射HTTP服务端口，用于处理广告拦截相关的HTTP请求
• -p 443:443: 映射HTTPS服务端口，支持HTTPS协议的广告拦截
• -itd: 以交互、后台模式运行容器

初始配置

1. 容器启动后，通过浏览器访问 http://<服务器IP>:3000 进入初始配置界面
2. 按照引导完成管理员账号设置、网络接口配置和DNS服务器设置
3. 配置完成后，Web管理界面将切换至常规管理页面（默认使用80/443端口）

数据持久化

数据卷 /opt/AdGuardHome/data 包含以下关键文件：

• AdGuardHome.yaml: 主配置文件
• querylog.json: DNS查询日志
• stats.db: 统计数据数据库
• 过滤规则文件：自定义和默认的广告过滤规则

停止与更新

停止容器：

bash
docker stop <容器ID>

更新镜像并重启（需先备份数据卷）：

bash
docker pull adminakademia/adguardhome
docker run -v /opt/AdGuardHome/data:/opt/AdGuardHome/data ... (使用原参数重新启动)