oznu/dns-ad-blocker

oznu/dns-ad-blocker

一个简单、轻量级的dnsmasq DNS服务器，用于阻止向已知广告服务器的流量。

镜像变体

使用场景

适用于需要在本地网络或个人设备上拦截广告域名、提升浏览速度的用户，支持多种架构（包括树莓派），可通过DNSCrypt增强DNS通信的安全性。

快速部署

常规启动

docker run -d -p 53:53/tcp -p 53:53/udp oznu/dns-ad-blocker

树莓派启动

docker run -d -p 53:53/tcp -p 53:53/udp oznu/dns-ad-blocker:armhf

部署后，可将设备的主DNS解析器设置为Docker主机的IP地址（Windows/Mac环境下为127.0.0.1）。默认启用黑名单自动更新。

配置说明

完整参数示例：

shell
docker run --restart=always \
  -p 53:53/tcp -p 53:53/udp \
  -e DEBUG=0 \
  -e NS1=1.1.1.1 -e NS2=1.0.0.1 \
  -e AUTO_UPDATE=1 \
  -e BRANCH=master \
  -e DNSCRYPT=0 \
  -v </path/to/config>:/config \
  oznu/dns-ad-blocker

参数说明：

• --restart=always：确保容器在主机重启后自动启动
• -p 53:53/tcp -p53:53/udp：暴露53端口（TCP/UDP），必填项
• -e DEBUG：设置为1启用调试模式，2启用详细日志（含源IP）
• -e NS1/NS2：覆盖默认转发DNS服务器（默认Cloudflare的1.1.1.1/1.0.0.1）
• -e AUTO_UPDATE：设置为0禁用黑名单自动更新（默认启用）
• -e WHITELIST：逗号分隔的域名列表，排除在黑名单外（如www.oz.nu,hub.docker.com）
• -e DNSCRYPT：设置为1启用DNSCrypt加密（默认禁用）
• -v /config：挂载目录，其中所有.conf后缀文件会被包含到dnsmasq配置中

广告拦截原理

镜像使用https://github.com/oznu/dns-zone-blacklist%E5%92%8Chttps://github.com/StevenBlack/hosts%E7%9A%84%E9%BB%91%E5%90%8D%E5%8D%95%EF%BC%8C%E5%BD%93%E6%B5%8F%E8%A7%88%E5%99%A8%E6%88%96%E8%AE%BE%E5%A4%87%E5%90%91%E9%BB%91%E5%90%8D%E5%8D%95%E5%9F%9F%E5%90%8D%E5%8F%91%E8%B5%B7DNS%E6%9F%A5%E8%AF%A2%E6%97%B6%EF%BC%8C%E8%BF%94%E5%9B%9E%60NXDOMAIN%60%EF%BC%88%E5%9F%9F%E5%90%8D%E4%B8%8D%E5%AD%98%E5%9C%A8%EF%BC%89%EF%BC%8C%E9%98%BB%E6%AD%A2%E8%BF%9E%E6%8E%A5%E5%B0%9D%E8%AF%95%E3%80%82

DNSCrypt功能

DNSCrypt是一种验证DNS客户端与解析器通信的协议，通过加密签名确保响应来自指定解析器且未被篡改。启用方式：

docker run -d --restart=always -p53:53/tcp -p53:53/udp -e DNSCRYPT=1 oznu/dns-ad-blocker

• -e DNS_CRYPT_SERVERS：逗号分隔的服务器列表（默认cloudflare,cloudflare-ipv6）
• 注意：启用DNSCrypt会覆盖NS1/NS2参数，且不替代***，因SNI仍会明文传输主机名。 可参考官方DNSCrypt解析器列表选择其他提供商。