English

SmartDNS 是一个运行在本地的 DNS 服务器，它接受来自本地客户端的 DNS 查询请求，然后从多个上游 DNS 服务器获取 DNS 查询结果，并将访问速度最快的结果返回给客户端，以此提高网络访问速度。 SmartDNS 同时支持指定特定域名 IP 地址，并高性匹配，可达到过滤广告的效果。
与 DNSmasq 的 all-servers 不同，SmartDNS 返回的是访问速度最快的解析结果。详细差异请看常见问题。

支持树莓派、OpenWrt、华硕路由器原生固件和 Windows 系统等。

• SmartDNS
  • 目录
  • 软件效果展示
  • 特性
  • 架构
  • 下载
    • 使用官方安装源
    • 手工下载安装
  • 安装和使用
    • 标准 Linux 系统 / 树莓派
    • OpenWrt
    • 华硕路由器原生固件 / 梅林固件
    • Optware / Entware
    • WSL
  • 配置文件说明
  • 常见问题
  • 编译
  • 捐赠
    • PayPal 贝宝
    • AliPay 支付宝
    • WeChat Pay 微信支付
  • 开源声明

阿里 DNS
使用阿里 DNS 查询百度IP，并检测结果。

$ nslookup www.baidu.com 223.5.5.5
Server:         223.5.5.5
Address:        223.5.5.5#53

Non-authoritative answer:
www.baidu.com   canonical name = www.a.shifen.com.
Name:   www.a.shifen.com
Address: 180.97.33.108
Name:   www.a.shifen.com
Address: 180.97.33.107

$ ping 180.97.33.107 -c 2
PING 180.97.33.107 (180.97.33.107) 56(84) bytes of data.
64 bytes from 180.97.33.107: icmp_seq=1 ttl=55 time=24.3 ms
64 bytes from 180.97.33.107: icmp_seq=2 ttl=55 time=24.2 ms

--- 180.97.33.107 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
rtt min/avg/max/mdev = 24.275/24.327/24.380/0.164 ms
pi@raspberrypi:~/code/smartdns_build $ ping 180.97.33.108 -c 2
PING 180.97.33.108 (180.97.33.108) 56(84) bytes of data.
64 bytes from 180.97.33.108: icmp_seq=1 ttl=55 time=31.1 ms
64 bytes from 180.97.33.108: icmp_seq=2 ttl=55 time=31.0 ms

--- 180.97.33.108 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
rtt min/avg/max/mdev = 31.014/31.094/31.175/0.193 ms

SmartDNS
使用 SmartDNS 查询百度 IP，并检测结果。

$ nslookup www.baidu.com
Server:         192.168.1.1
Address:        192.168.1.1#53

Non-authoritative answer:
www.baidu.com   canonical name = www.a.shifen.com.
Name:   www.a.shifen.com
Address: 14.215.177.39

$ ping 14.215.177.39 -c 2
PING 14.215.177.39 (14.215.177.39) 56(84) bytes of data.
64 bytes from 14.215.177.39: icmp_seq=1 ttl=56 time=6.31 ms
64 bytes from 14.215.177.39: icmp_seq=2 ttl=56 time=5.95 ms

--- 14.215.177.39 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1001ms
rtt min/avg/max/mdev = 5.954/6.133/6.313/0.195 ms

从对比看出，SmartDNS 找到了访问 www.baidu.com 最快的 IP 地址，比阿里 DNS 速度快了 5 倍。

1. 多 DNS 上游服务器
   支持配置多个上游 DNS 服务器，并同时进行查询，即使其中有 DNS 服务器异常，也不会影响查询。

2. 返回最快 IP 地址
   支持从域名所属 IP 地址列表中查找到访问速度最快的 IP 地址，并返回给客户端，提高网络访问速度。

3. 支持多种查询协议
   支持 UDP、TCP、TLS 和 HTTPS 查询，以及非 53 端口查询。

4. 特定域名 IP 地址指定
   支持指定域名的 IP 地址，达到广告过滤效果、避免恶意网站的效果。

5. 域名高性能后缀匹配
   支持域名后缀匹配模式，简化过滤配置，过滤 20 万条记录时间 < 1ms。

6. 域名分流
   支持域名分流，不同类型的域名向不同的 DNS 服务器查询。

7. Windows / Linux 多平台支持
   支持标准 Linux 系统（树莓派）、OpenWrt 系统各种固件和华硕路由器原生固件。同时还支持 WSL（Windows Subsystem for Linux，适用于 Linux 的 Windows 子系统）。

8. 支持 IPv4、IPv6 双栈
   支持 IPv4 和 IPV 6网络，支持查询 A 和 AAAA 记录，支持双栈 IP 速度优化，并支持完全禁用 IPv6 AAAA 解析。

9. 高性能、占用资源少
   多线程异步 IO 模式，cache 缓存查询结果。

10. 主流系统官方支持 主流路由系统官方软件源安装smartdns。

1. SmartDNS 接收本地网络设备的DNS 查询请求，如 PC、手机的查询请求；
2. 然后将查询请求发送到多个上游 DNS 服务器，可支持 UDP 标准端口或非标准端口查询，以及 TCP 查询；
3. 上游 DNS 服务器返回域名对应的服务器 IP 地址列表，SmartDNS 则会检测从本地网络访问速度最快的服务器 IP；
4. 最后将访问速度最快的服务器 IP 返回给本地客户端。

smartdns已经合入主流系统的软件仓库，可以直接使用系统安装命令直接安装。

下载对应系统或固件版本的 SmartDNS 安装包，对应关系如下。

前往 Release 页面下载。

请注意：

• Release 释出的软件包采取静态编译，无外部依赖，但体积大。若需要小体积软件包，请自行编译或从 OpenWrt / Entware 仓库获取。

• 静态编译的软件包未强制判断 CPU 架构，安装不正确的软件包将会导致服务无法启动，请确保正确安装对应的版本。

1. 安装

   下载配套安装包，并上传到 Linux 系统中。

   标准 Linux 系统（X86 / X86_64）请执行如下命令安装：

   $ tar zxf smartdns.1.yyyy.MM.dd-REL.x86_64-linux-all.tar.gz
   $ cd smartdns
   $ chmod +x ./install
   $ ./install -i

   树莓派或其他 Debian 系系统（ARM / ARM64）请执行如下命令安装：

   # dpkg -i smartdns.1.yyyy.MM.dd-REL.arm-debian-all.deb

2. 修改配置

   安装完成后，可配置 SmartDNS 的上游服务器信息。

   一般情况下，只需要增加 server [IP]:port 和 server-tcp [IP]:port 配置项。

   请尽可能配置多个上游 DNS 服务器，包括国内外的服务器。

   具体配置参数请参考配置文件说明。

   # vi /etc/smartdns/smartdns.conf

3. 启动服务

   # systemctl enable smartdns
   # systemctl start smartdns

4. 将 DNS 请求转发到 SmartDNS 解析

   修改本地路由器的 DNS 服务器，将 DNS 服务器配置为 SmartDNS。

   • 登录到本地网络的路由器中，配置树莓派，分配其静态 IP 地址。
   • 修改 WAN 口或者 DHCP DNS 为树莓派 IP 地址。 注意： I. 每款路由器配置方法不尽相同，请在网络上搜索对应配置方法。 II. 华为等路由器可能不支持配置 DNS 为本地 IP，可修改电脑端或手机端的 DNS 服务器为树莓派 IP。

5. 检测服务是否配置成功

   执行

   $ nslookup -querytype=ptr smartdns

   查看命令结果中的 name 是否为 smartdns 或你的主机名，如果是则表示生效

   $ nslookup -querytype=ptr smartdns
   Server:         192.168.1.1
   Address:        192.168.1.1#53
   
   Non-authoritative answer:
   smartdns        name = smartdns.

1. 安装

   将软件包（使用 WinSCP 等）上传到路由器的 /root 目录，执行如下命令安装

   # opkg install smartdns.1.yyyy.MM.dd-REL.xxxx.ipk
   # opkg install luci-app-smartdns.1.yyyy.MM.dd-REL.all.ipk

   • 注意： 19.07 之前的版本，请务必安装 luci-app-smartdns.1.yyyy.MM.dd-REL.all-luci-compat-all.ipk。

2. 修改配置

   登录 OpenWrt 管理页面，打开 Services -> SmartDNS 进行配置。

   • 在 Upstream Servers 增加上游 DNS 服务器配置，建议配置多个国内外 DNS 服务器。
   • 在 Domain Address 指定特定域名的 IP 地址，可用于广告屏蔽。

3. 启用服务

• 替换默认Dndmasq为主DNS。

  登录 OpenWrt 管理界面，点击 Services -> SmartDNS -> port，设置端口号为53，smartdns会自动接管主DNS服务器。

• 检测转发服务是否配置成功

  执行

  $ nslookup -querytype=ptr smartdns

  查看命令结果中的 name 是否为 smartdns 或你的主机名，如果是则表示生效

  $ nslookup -querytype=ptr smartdns
  Server:         192.168.1.1
  Address:        192.168.1.1#53
  
  Non-authoritative answer:
  smartdns        name = smartdns.

4. 启动服务

   勾选配置页面中的 Enable（启用）来启动 SmartDNS。

5. 注意：

   • 如已经安装 ChinaDNS，建议将 ChinaDNS 的上游配置为 SmartDNS。
   • 当smartdns的端口为53时，将自动接管dnsmasq为主dns。配置其他端口时，会重新启用dnsmasq为主dns。
   • 若在此过程中发生异常，可使用如下命令还原dnsmasq为主DNS

   uci delete dhcp.@dnsmasq[0].port
   uci commit dhcp
   /etc/init.d/dnsmasq restart

说明： 梅林固件派生自华硕固件，理论上可以直接使用华硕配套的安装包使用。但目前未经验证，如有问题，请提交 Issue。

1. 准备

   在使用此软件时，需要确认路由器是否支持 U 盘，并准备好 U 盘一个。

2. 启用 SSH 登录

   登录管理界面，点击 系统管理 -> 系统设置，配置 Enable SSH 为 Lan Only。
   SSH 登录用户名密码与管理界面相同。

3. 下载 Download Master

   在管理界面点击 USB 相关应用 -> Download Master 下载。
   下载完成后，启用 Download Master，如果不需要下载功能，此时可以卸载 Download Master，但要保证卸载前 Download Master 是启用的。

4. 安装 SmartDNS

   将软件包（使用 WinSCP 等）上传到路由器的 /tmp/mnt/sda1 目录（或网上邻居复制到 sda1 共享目录），执行如下命令安装

   # ipkg install smartdns.1.yyyy.MM.dd-REL.mipsbig.ipk

5. 重启路由器使服务生效

   待路由器启动后， 执行

   $ nslookup -querytype=ptr smartdns

   查看命令结果中的 name 是否为 smartdns 或你的主机名，如果是则表示生效

   $ nslookup -querytype=ptr smartdns
   Server:         192.168.1.1
   Address:        192.168.1.1#53
   
   Non-authoritative answer:
   smartdns        name = smartdns.

6. 额外说明

   上述过程，SmartDNS 将安装到 U 盘根目录，采用 Optware 的模式运行。 其目录结构如下（此处仅列出 SmartDNS 相关文件）：

   U 盘
   └── asusware.mipsbig
           ├── bin
           ├── etc
           |    ├── smartdns
           |    |     └── smartdns.conf
           |    └── init.d
           |          └── S50smartdns
           ├── lib
           ├── sbin
           ├── usr
           |    └── sbin
           |          └── smartdns
           ....

   如要修改配置，可以 SSH 登录路由器，使用 vi 命令修改

   # vi /opt/etc/smartdns/smartdns.conf

   也可以通过网上邻居修改，网上邻居共享目录 sda1 看不到 asusware.mipsbig 目录，但可以直接在文件管理器中输入 asusware.mipsbig\etc\init.d 访问

   \\192.168.1.1\sda1\asusware.mipsbig\etc\init.d

1. 准备

   在使用此软件时，需要确认路由器是否支持 U 盘，并准备好 U 盘一个。

2. 安装 SmartDNS

   将软件（使用 WinSCP 等）上传到路由器的 /tmp 目录，执行如下命令安装

   # ipkg install smartdns.1.yyyy.MM.dd-REL.mipsbig.ipk

3. 修改 SmartDNS 配置

   # vi /opt/etc/smartdns/smartdns.conf

   另外，如需支持 IPv6，可设置工作模式为 2，将 DNSmasq 的 DNS 服务禁用，设置 SmartDNS 为主用 DNS 服务器。将文件 /opt/etc/smartdns/smartdns-opt.conf 中的 SMARTDNS_WORKMODE 的值修改为 2

   SMARTDNS_WORKMODE="2"

4. 重启路由器使服务生效

   待路由器启动后， 执行

   $ nslookup -querytype=ptr smartdns

   查看命令结果中的 name 是否为 smartdns 或你的主机名，如果是则表示生效

   $ nslookup -querytype=ptr smartdns
   Server:         192.168.1.1
   Address:        192.168.1.1#53
   
   Non-authoritative answer:
   smartdns        name = smartdns.

   注意： 若服务没有自动启动，则需要设置 Optware / Entware 自动启动，具体方法请参考 Optware/Entware 的文档。

1. 安装 WSL

   安装 WSL 运行环境，发行版本选择 Ubuntu 系统为例。安装步骤请参考 WSL 安装说明

2. 安装 SmartDNS

   下载适用于 WSL 的安装包，并解压到如 D 盘根目录。解压后目录如下：

   D:\SMARTDNS
   ├─etc
   │  ├─default
   │  ├─init.d
   │  └─smartdns
   ├─package
   │  └─windows
   ├─src
   └─systemd

   双击 D:\smartdns\package\windows 目录下的 install.bat 进行安装。要求输入密码时，请输入 WLS ubuntu 的密码。

3. 修改配置

   用记事本等打开 D:\smartdns\etc\smartdns 目录中的 smartdns.conf 配置文件配置 SmartDNS。

   一般情况下，只需要增加 server [IP]:port 和 server-tcp [IP]:port 配置项， 尽可能配置多个上游DNS服务器，包括国内外的服务器。

   具体配置请参考配置文件说明。

4. 重新加载配置

   双击 D:\smartdns\package\windows 目录下的 reload.bat 进行重新加载。要求输入密码时，请输入 WLS ubuntu 的密码。

5. 将 DNS 请求转发到 SmartDNS 解析

   将 Windows 的默认 DNS 服务器修改为 127.0.0.1，具体步骤参考 Windows 更改 TCP/IP 设置。

6. 检测服务是否配置成功

   执行

   $ nslookup -querytype=ptr smartdns

   查看命令结果中的 name 是否为 smartdns 或你的主机名，如果是则表示生效

   $ nslookup -querytype=ptr smartdns
   Server:         192.168.1.1
   Address:        192.168.1.1#53
   
   Non-authoritative answer:
   smartdns        name = smartdns.

配置建议：smartdns默认已设置为最优模式，适合大部分场景的DNS查询体验改善，一般情况只需要增加上游服务器地址即可，无需做其他配置修改；如有其他配置修改，请务必了解其用途，避免修改后起到反作用。

1. SmartDNS 和 DNSmasq 有什么区别？

   SmartDNS 在设计上并不是 DNSmasq 的替代品，它的主要功能集中在 DNS 解析增强上，增强部分有：

   • 多上游服务器并发请求，对结果进行测速后，返回最佳结果；
   • address、ipset 域名匹配采用高效算法，查询匹配更加快速，即使是路由器设备也依然高效；
   • 域名匹配支持忽略特定域名，可单独匹配 IPv4 和 IPv6，支持多样化定制；
   • 针对广告屏蔽功能做增强，返回 SOA，屏蔽广告效果更佳；
   • IPv4、IPv6 双栈 IP 优选机制，在双网情况下，选择最快的网络通讯；
   • 支持最新的 TLS 和 HTTPS 协议，提供安全的 DNS 查询能力；
   • ECS 支持，使查询结果更佳准确；
   • IP 黑名单和忽略 IP 机制，使域名查询更佳准确；
   • 域名预查询，访问常用网站更加快速；
   • 域名 TTL 可指定，使访问更快速；
   • 高速缓存机制，使访问更快速；
   • 异步日志，审计机制，在记录信息的同时不影响 DNS 查询性能；
   • 域名组（group）机制，特定域名使用特定上游服务器组查询，避免隐私泄漏；
   • 第二 DNS 支持自定义更多行为。

2. 如何配置上游服务器最佳？

   SmartDNS 有测速机制，在配置上游服务器时，建议配置多个上游 DNS 服务器，包含多个不同区域的服务器，但总数建议在 10 个左右。推荐搭配

   • 运营商 DNS。
   • 国内公共 DNS，如 119.29.29.29, 223.5.5.5。
   • 国外公共 DNS，如 8.8.8.8, 8.8.4.4。

3. 如何启用审计日志？

   审计日志记录客户端请求的域名，记录信息包括，请求时间，请求 IP，请求域名，请求类型，如果要启用审计日志，在配置界面配置 audit-enable yes 启用，audit-size、 audit-file、audit-num 分别配置审计日志文件大小，审计日志文件路径，和审计日志文件个数。审计日志文件将会压缩存储以节省空间。

4. 如何避免隐私泄漏？

   默认情况下，SmartDNS 会将请求发送到所有配置的DNS服务器，若上游 DNS 服务器使用DNS，或记录日志，将会导致隐私泄漏。为避免隐私泄漏，请尽量：

   • 配置使用可信的DNS服务器。
   • 优先使用 TLS 查询。
   • 设置上游 DNS 服务器组。

5. 如何屏蔽广告？

   SmartDNS 具备高性能域名匹配算法，通过域名方式过滤广告非常高效，如要屏蔽广告，只需要配置类似如下记录即可，如，屏蔽 *.ad.com，则配置：

   address /ad.com/#

   域名的使后缀模式，过滤 *.ad.com，# 表示返回 SOA，使屏蔽广告更加高效，如果要单独屏蔽 IPv4 或 IPv6， 在 # 后面增加数字，如 #4 表示对 IPv4 生效。若想忽略特定子域名的屏蔽，如忽略 pass.ad.com，可配置如下：

   address /pass.ad.com/-

6. 如何使用 DNS 查询分流？

   某些情况下，需要将有些域名使用特定的 DNS 服务器来查询来做到 DNS 分流。比如

   .home -> 192.168.1.1 # .home 结尾的域名发送到 192.168.1.1 解析
   .office -> 10.0.0.1  # .office 结尾的域名发送到 10.0.0.1 解析

   其他域名采用默认的模式解析。 这种情况的分流配置如下：

   # 配置上游，用 -group 指定组名，用 -exclude-default-group 将服务器从默认组中排除。
   server 192.168.1.1 -group home -exclude-default-group
   server 10.0.0.1 -group office -exclude-default-group
   server 8.8.8.8
   
   # 配置解析的域名
   nameserver /.home/home
   nameserver /.office/office

   通过上述配置即可实现 DNS 解析分流，如果需要实现按请求端端口分流，可以配置第二 DNS 服务器，bind 配置增加 --group 参数指定分流名称。

   bind :7053 -group office
   bind :8053 -group home

7. IPv4、IPv6 双栈 IP 优选功能如何使用？

   目前 IPv6 已经开始普及，但 IPv6 网络在速度上，某些情况下还不如 IPv4。为在双栈网络下获得较好的体验，SmartDNS 提供来双栈IP优选机制，同一个域名，若 IPv4 的速度远快与 IPv6，那么 SmartDNS 就会阻止IPv6的解析、使用 IPv4 访问。可在配置文件中通过设置 dualstack-ip-selection yes 启用此功能，通过 dualstack-ip-selection-threshold [time] 来修改阈值。如果要完全禁止 IPv6 AAAA记录解析，可设置 force-AAAA-SOA yes。

8. 如何提高缓存效率，加快访问速度？

   SmartDNS 提供了域名缓存机制，对查询的域名，进行缓存，缓存时间符合 DNS TTL 规范。为提高缓存命中率，可采用如下措施：

   • 适当增大缓存的记录数

     通过 cache-size 来设置缓存记录数。

     查询压力大的环境下，并且有内存大的机器的情况下，可适当调大。

   • 适当设置最小 TTL 值

     通过 rr-ttl-min 将最低 DNS TTL 时间设置为一个合理值，延长缓存时间。

     建议是超时时间设置在 10～30 分钟，避免服务器域名变化时，查询到失效域名。

   • 开启域名预获取功能

     通过 prefetch-domain yes 来启用域名预先获取功能，提高查询命中率。

     配合上述 TTL 超时时间，SmartDNS 将在域名 TTL 即将超时时，再次发送查询请求，并缓存查询结果供后续使用。频繁访问的域名将会持续缓存。此功能将在空闲时消耗更多的 CPU。

   • 过期缓存服务功能

     通过 serve-expired 来启用过期缓存服务功能，可提高缓存命中率的同时，降低CPU占用。

     此功能会在TTL超时后，将返回 TTL=0 给客户端，并且同时再次发送查询请求，并缓存新的结果给后续使用。

9. 第二 DNS 如何自定义更多行为？

   第二 DNS 可以作为其他 DNS 服务器的上游，提供更多的查询行为，通过 bind 配置支持可以绑定多个端口，不同端口可设置不同的标志，实现不同的功能，如

   # 绑定 6053 端口，6053 端口的请求将采用配置 office 组的上游查询，且不对结果进行测速，忽略 address 的配置地址
   bind [::]:6053 -no-speed-check -group office -no-rule-addr

10. DoT 的 SPKI 如何获取？ SPKI 可以通过 DNS 服务商发布的页面获取，如果没有发布，可以通过如下命令获取，其中将对应IP地址更换为要获取 SPKI 的 IP 地址。

    $ echo | openssl s_client -connect '1.0.0.1:853' 2>/dev/null | openssl x509 -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | openssl enc -base64

11. iOS系统解析缓慢问题怎么解决？
    IOS14开始，苹果支持了DNS HTTPS(TYPE65)记录的解析，此功能用于快速DNS查询和解决HTTPS链接相关的问题，但当前还是草案，另外会导致广告屏蔽等功能失效，建议通过如下配置关闭TYPE65记录查询。

    force-qtype-SOA 65

12. 如何解析本地主机名称？
    smartdns可以配合DNSMASQ的dhcp lease文件支持本地主机名->IP地址的解析，可以配置smartdns读取dnsmasq的lease文件，并支持解析。具体配置参数如下，（注意，DNSMASQ lease文件每个系统可能不一样，需要按实际情况配置）

    dnsmasq-lease-file /var/lib/misc/dnsmasq.leases
    

    配置完成后，可以直接使用主机名连接对应的机器。但需要注意：

    • Windows系统默认使用mDNS解析地址，如需要在windows下用使用smartdns解析，则需要在主机名后面增加.，表示使用DNS解析。如ping smartdns.

13. 域名集合如何使用？
    为方便按集合配置域名，对于有/domain/的配置，可以指定域名集合，方便维护。具体方法为：

    • 使用domain-set配置集合文件，如

    domain-set -name ad -file /etc/smartdns/ad-list.conf

    ad-list.conf的格式为一个域名一行，如

    ad.com
    site.com
    

    • 在有/domain/配置的选项使用域名集合，只需要将/domain/配置为/domain-set:[集合名称]/即可，如：

    address /domain-set:ad/#
    domain-rules /domain-set:ad/ -a #
    nameserver /domain-set:ad/server
    ...

14. 更多问题
    如有更多问题，请查阅或提交issue: https://github.com/pymumu/smartdns/issues

SmartDNS 提供了编译软件包的脚本（package/build-pkg.sh），支持编译 LuCI、Debian、OpenWrt 和 Optware 安装包。

如果你觉得此项目对你有帮助，请捐助我们，使项目能持续发展和更加完善。

SmartDNS 基于 GPL V3 协议开源。