imthai/dnsmasq-adblock

docker-dnsmasq-adblock

镜像概述

docker-dnsmasq-adblock是一个基于dnsmasq的DNS服务器镜像，通过黑名单机制拦截广告和***域名。它读取用户提供的域名和主机名列表，将这些条目重定向到虚假IP，从而实现广告屏蔽功能。

核心功能与特性

• 双黑名单系统：包含两个关键配置文件
  • /adblock/hostnames.txt：存储需拦截的主机名列表
  • /adblock/domains.txt：存储需拦截的域名列表
• 自动重定向机制：通过dnsmasq配置自动应用拦截规则
  • conf-file=/adblock/domains.txt：加载域名黑名单
  • addn-hosts=/adblock/hostnames.txt：加载主机名黑名单
• 灵活扩展性：镜像中黑名单文件默认为空，用户可自定义或集成第三方列表

使用场景

• 家庭网络广告拦截
• 企业内部网络***域名过滤
• 需要自定义域名拦截规则的环境
• 可与pixelserv-tls服务器配合使用以增强拦截效果

使用方法

准备工作

1. 创建本地目录：在主机上创建专用目录存储黑名单文件

   bash
   mkdir -p ~/adblock
   cd ~/adblock
   

2. 获取黑名单列表：推荐使用每日更新的notracking/hosts-blocklists

   bash
   wget https://raw.githubusercontent.com/notracking/hosts-blocklists/master/hostnames.txt
   wget https://raw.githubusercontent.com/notracking/hosts-blocklists/master/domains.txt
   

运行容器

Linux系统

bash
docker run -d \
  --name dns-adblock \
  --net=host \
  --cap-add=NET_ADMIN \
  -e TZ=Europe/Paris \  # 根据实际时区调整，如Asia/Shanghai
  -v ~/adblock:/adblock \
  imthai/dnsmasq-adblock

MacOS系统

（因不支持host网络模式，需手动映射端口）

bash
docker run -d \
  --name dns-adblock \
  --cap-add=NET_ADMIN \
  -p 53:53/udp \
  -v ~/adblock:/adblock \
  -e TZ=$(ls -la /etc/localtime | cut -d/ -f8-9) \  # 自动获取系统时区
  imthai/dnsmasq-adblock

维护与更新

• 更新黑名单：建议每日更新以保持拦截效果

  bash
  cd ~/adblock
  wget -O hostnames.txt https://raw.githubusercontent.com/notracking/hosts-blocklists/master/hostnames.txt
  wget -O domains.txt https://raw.githubusercontent.com/notracking/hosts-blocklists/master/domains.txt
  docker restart dns-adblock  # 重启容器使更新生效
  

• 查看日志：

  bash
  docker container logs -f --tail 100 dns-adblock
  

高级配置

可使用项目提供的update_adblocklist.sh脚本（位于GitHub仓库）实现：

• 自动下载最新列表
• 自定义重定向目标IP
• 整合白名单和自定义黑名单规则