ashmckenzie/adguard-home

AdGuard Home Docker镜像文档

镜像概述

AdGuard Home是一款集DNS服务器与广告拦截功能于一体的工具，本Docker镜像基于Alpine Linux构建，提供了便捷的部署方式，可快速搭建广告拦截DNS服务，支持数据持久化以确保配置不丢失。

核心功能与特性

• 轻量级基础：基于Alpine Linux，资源占用低，运行高效
• 数据持久化：通过/data卷挂载，确保配置文件持久保存
• 完整依赖：内置bash、curl、ca-certificates等必要工具
• 端口暴露：默认暴露DNS服务端口（53/udp、53/tcp）和Web管理端口（3000）
• 即开即用：包含启动脚本和初始配置，简化部署流程

使用场景

• 家庭网络广告拦截与隐私保护
• 小型办公网络DNS管理与内容过滤
• 快速测试AdGuard Home功能与配置
• 个人设备或服务器的本地DNS服务搭建

使用方法

快速测试

通过临时容器快速体验功能（数据不会持久化）：

bash
docker run --rm -ti -p 53:53/udp -p 53:53/tcp -p 3000:3000 docker.xuanyuan.run/ashmckenzie/adguard-home

访问http://<你的IP>:3000，默认登录信息：

• 用户名：admin
• 密码：admin

注意：此模式下所有配置更改在容器停止后将丢失，仅用于测试。

持久化部署

1. 生成配置文件

首先在本地目录生成必要配置文件（替换<your-data-dir>为实际本地目录路径）：

bash
docker run --rm -ti -v <your-data-dir>:/data docker.xuanyuan.run/ashmckenzie/adguard-home

执行后按CTRL-C停止，此时<your-data-dir>目录下将生成以下文件：

AdGuardHome
AdGuardHome.yaml
Corefile
dnsfilter.txt

2. 后台运行容器

使用生成的配置文件启动持久化容器：

bash
docker run -d -p 53:53/udp -p 53:53/tcp -p 3000:3000 -v <your-data-dir>:/data docker.xuanyuan.run/ashmckenzie/adguard-home

注意事项

• 配置文件耦合：目前AdGuardHome二进制需与配置文件放在同一目录（相关问题已在AdGuardHome源码中修复，将随新版本更新镜像）
• 权限要求：确保挂载的<your-data-dir>目录具有读写权限，避免配置文件无法保存
• 端口冲突：若主机已占用53或3000端口，需调整端口映射（如-p 5353:53/udp）