217heidai/nestingdns repository overview

⁠NestingDNS

DNS 三大神器 AdGuardHome⁠、MosDNS⁠、SmartDNS⁠，该如何选择？
不，小孩子才做选择，我全都要。
于是有了这个项目，套娃使用三大神器，试图找到一套最佳实践。

⁠DNS 解析流程

1. AdGuardHome 为第一层 DNS ，作为整体入口，监听端口 4053。

• 负责去广告。

1. MosDNS 为第二层 DNS，监听端口 5053。

• 负责分流。
  • 直连：待解析域名在 direct.txt⁠、direct_custom.txt(自定义直连域名)内，通过 SmartDNS 的 mainland 组进行解析。
  • 代理：待解析域名在 proxy.txt⁠、proxy_custom.txt(自定义代理域名)内，通过 SmartDNS 的 gfw 组进行解析。
  • Fallback：待解析域名不在以上规则内的，先使用 SmartDNS 的 mainland 组进行解析，如解析出来的地址为国内 IP(在 ipv4_china.txt⁠ 内)则使用，否则抛弃。再使用 SmartDNS 的 gfw 组进行解析，如解析成功则使用，如失败则使用 SmartDNS 的 overseas 组进行解析（gfw 组使用代理连接公共 DNS，当代理异常时使用 overseas 组作为备用进行解析）。

1. SmartDNS 为第三层 DNS，监听端口 6053、7053、8053

• 负责 DNS 解析、测速、缓存。
  • mainland 组，端口 7053，通过 DoH 接入上游 AliDNS(DoQ)、DNSPod、360DNS、Quad101，负责直连域名解析。
  • gfw 组，端口 8053，通过代理使用 DoH 接入上游 Google、Cloudflare、Quad9、DNS.SB、OpenDNS，负责代理域名解析，关闭缓存、测速。
  • overseas 组，端口 6053，通过 DoH 接入上游 Google、Cloudflare、Quad9、DNS.SB、OpenDNS、Quad101，作为备用域名解析，关闭缓存、测速。

⁠安装方法

使用 Docker 一键安装。

1. network host 模式（推荐使用）

docker run -d \
    --restart on-failure:3 \
    --name nestingdns \
    --network host \
    -v $HOME/nestingdns/etc:/nestingdns/etc \    # 配置文件路径
    -v $HOME/nestingdns/work:/nestingdns/work \  # 工作文件路径
    -v $HOME/nestingdns/log:/nestingdns/log \    # 日志文件路径
    -e TZ=Asia/Shanghai \
    -e SCHEDULE="0  4  *  *  *" \  # 每天 4 点更新规则文件，重启 MosDNS
    217heidai/nestingdns

1. 端口映射模式（MosDNS、SmartDNS 的端口可以不映射）

docker run -d \
    --restart on-failure:3 \
    --name nestingdns \
    -p 3000:3000 \      # AdGuardHome web 页面
    -p 4053:4053 \      # AdGuardHome NDS
    -p 4053:4053/udp \  # AdGuardHome NDS
    -p 5053:5053 \      # MosDNS NDS
    -p 5053:5053/udp \  # MosDNS NDS
    -p 4000:4000 \      # SmartDNS web 页面
    -p 6053:6053 \      # SmartDNS NDS
    -p 6053:6053/udp \  # SmartDNS NDS
    -p 7053:7053 \      # SmartDNS NDS
    -p 7053:7053/udp \  # SmartDNS NDS
    -p 8053:8053 \      # SmartDNS NDS
    -p 8053:8053/udp \  # SmartDNS NDS
    -v $HOME/nestingdns/etc:/nestingdns/etc \    # 配置文件路径
    -v $HOME/nestingdns/work:/nestingdns/work \  # 工作文件路径
    -v $HOME/nestingdns/log:/nestingdns/log \    # 日志文件路径
    -e TZ=Asia/Shanghai \
    -e SCHEDULE="0  4  *  *  *" \  # 每天 4 点更新配置文件，重启 MosDNS
    217heidai/nestingdns

⁠配置说明

默认已全部关闭 IPv6 支持。

⁠AdGuardHome

AdGuardHome 配置文件为 $HOME/nestingdns/etc/conf/adguardhome.yaml。

• 默认已配置好，一般无需调整。
• 默认开启缓存，并关闭乐观缓存，AdGuardHome 仅作临时缓存。主要缓存功能由 SmartDNS 负责。
• 默认内置去广告规则 AdBlock DNS Filters⁠。
• web 服务为 3000 端口，默认账号 root 密码 password。

⁠MosDNS

MosDNS 配置文件为 $HOME/nestingdns/etc/conf/mosdns.yaml、$HOME/nestingdns/etc/conf/mosdns_load_rules.yaml、$HOME/nestingdns/etc/conf/mosdns_forward.yaml。

• 默认已配置好，一般无需调整。各项配置可参考官方 wiki⁠。
• 分流规则文件路径为 $HOME/nestingdns/etc/site/。根据创建容器时的 SCHEDULE 参数，定时下载更新分流规则文件，默认每天 4 点更新。
• 自定义直连域名文件为 $HOME/nestingdns/etc/site/direct_custom.txt。默认为空，可自行添加内容，如填入 VPS 的域名。
• 自定义代理域名文件为 $HOME/nestingdns/etc/site/proxy_custom.txt。默认为空，可自行添加内容。
• 自定义 hosts 文件为 $HOME/nestingdns/etc/site/hosts.txt。默认为空，可自行添加内容（注意格式与操作系统的 hosts 不一样，具体请参考官方 wiki⁠）。
• gfw TTL 默认全部调整为最大 300s，$HOME/nestingdns/etc/conf/mosdns_forward.yaml 中设置 sequence dns_gfw，如有多个代理地址切换使用的，请设置较小值，如 60。（上游 smartdns gfw 组默认已关闭缓存、测速）
• ECS (EDNS Client Subnet) ，默认关闭。如需启用，请在 $HOME/nestingdns/etc/conf/mosdns_forward.yaml 中找到 ecs_mainland（推荐设置为宽带拨号自动获取的运营商 DNS IP）、ecs_gfw（推荐设置为 VPS 测试 IP），放开调用前的注释。
• CDN IP 优选，默认关闭。如需启用，请在 $HOME/nestingdns/etc/conf/mosdns_forward.yaml 中找到所有 best_ip，删掉注释，并设置相应 black_hole ip（建议多填几个不同网段的 ip）。测速工具推荐使用 CloudflareSpeedTest⁠（注意测速必须关闭代理）。由于测速需关闭代理，因此未做成自动化脚本，请定期手工测速。
  • cloudflare 优选，请将测速较快的 ip 填入 $HOME/nestingdns/etc/conf/mosdns_forward.yaml 中 sequence blackhole_cloudflare。

⁠SmartDNS

SmartDNS 配置文件为 $HOME/nestingdns/etc/conf/smartdns.conf。

• 除代理外，其它默认已配置好，一般无需调整。各项配置可参考官方 wiki⁠。
• 使用科学上网的，请为 gfw 组配置通过代理进行 DNS 解析，配置方式参见官方 wiki proxy 部分⁠。不使用科学上网的，无需配置。
• web 服务为 4000 端口，默认账号 root 密码 password。默认未开启，配置文件放开 plugin 注释即可开启。

⁠测试方法

dig @ip -p 4053 www.baidu.com