idssc/adguardhome

AdGuardHome Docker镜像文档

镜像概述和主要用途

AdGuardHome是一款网络级广告和跟踪器拦截DNS服务器，能够在整个网络范围内阻止广告、跟踪器和***网站。该镜像支持amd64、arm64、armv7多种架构，适用于家庭网络、小型办公网络等场景，提供高效的广告过滤和网络保护功能。

核心功能和特性

• 全网广告拦截：在网络层面阻止各类广告内容，减少带宽占用
• 跟踪器拦截：阻止第三方跟踪器收集用户数据，保护隐私安全
• 跨平台支持：兼容amd64、arm64、armv7多种硬件架构
• 灵活部署：支持host网络模式和端口映射模式部署
• 持久化配置：通过数据卷挂载实现配置和工作目录的持久化存储

使用场景和适用范围

• 家庭网络广告过滤
• 小型办公室网络安全防护
• 个人服务器广告拦截
• 需要保护隐私、减少广告干扰的网络环境

使用方法和配置说明

1. 环境准备与权限设置

首先设置环境变量并创建必要的目录，修改权限以确保容器正常访问：

bash
export NAME=adguardhome  WORK_PATH=/var/lib/${NAME}  IMG=idssc/adguardhome:0.107.73-amd64
mkdir -p ${WORK_PATH}/conf ${WORK_PATH}/work 
chmod 0755 ${WORK_PATH}/conf ${WORK_PATH}/work  
chown -R $(groups nobody | sed 's/ //g') ${WORK_PATH}/conf ${WORK_PATH}/work  

2. 部署模式

2.1 Host模式

直接使用主机网络，适合需要完全网络访问权限的场景。

Docker CLI命令：

bash
docker run -d \
	--name ${NAME} \
	--hostname ${NAME} \
	--restart always \
	--log-opt max-size=256k \
	--network host \
	--user nobody \
	-v ${WORK_PATH}/conf:/opt/adguardhome/conf \
	-v ${WORK_PATH}/work:/opt/adguardhome/work \
${IMG}

Docker Compose配置：

yaml
version: "3"
services:
    adguardhome:
        container_name: adguardhome
        hostname: adguardhome
        restart: always
        logging:
            options:
                max-size: 256k
        network_mode: host
        user: nobody
        volumes:
            - /var/lib/adguardhome/conf:/opt/adguardhome/conf
            - /var/lib/adguardhome/work:/opt/adguardhome/work
        image: idssc/adguardhome:0.107.73-amd64

2.2 端口映射模式

通过端口映射方式部署，适合需要自定义端口或网络隔离的场景。

Docker CLI命令：

bash
docker run -d \
	--name ${NAME} \
	--hostname ${NAME} \
	--restart always \
	--log-opt max-size=256k \
	-p 53:53/tcp -p 53:53/udp -p 853:853/tcp -p 853:853/udp \
	-p 67:67/udp -p 68:68/udp \
	-p 3080:80/tcp \
	-p 3443:443/tcp -p 3443:443/udp \
	-p 3000:3000/tcp -p 3000:3000/udp \
	-p 5443:5443/tcp -p 5443:5443/udp -p 6060:6060/udp \
	--user nobody \
	-v ${WORK_PATH}/conf:/opt/adguardhome/conf \
	-v ${WORK_PATH}/work:/opt/adguardhome/work \
${IMG}

Docker Compose配置：

yaml
version: "3"
services:
    adguardhome:
        container_name: adguardhome
        hostname: adguardhome
        restart: always
        logging:
            options:
                max-size: 256k
        ports:
            - 53:53/tcp
            - 53:53/udp
            - 853:853/tcp
            - 853:853/udp
            - 67:67/udp
            - 68:68/udp
            - 3080:80/tcp
            - 3443:443/tcp
            - 3443:443/udp
            - 3000:3000/tcp
            - 3000:3000/udp
            - 5443:5443/tcp
            - 5443:5443/udp
            - 6060:6060/udp
        user: nobody
        volumes:
            - /var/lib/adguardhome/conf:/opt/adguardhome/conf
            - /var/lib/adguardhome/work:/opt/adguardhome/work
        image: idssc/adguardhome:0.107.73-amd64

3. 访问与配置

部署完成后，通过浏览器访问 http://<服务器IP>:3000 即可进入AdGuardHome的Web管理界面，根据引导完成初始配置。配置文件和工作数据将保存在 /var/lib/adguardhome/conf 和 /var/lib/adguardhome/work 目录中，确保数据持久化。