Skip to content
forked from pymumu/smartdns

A local DNS server to obtain the fastest website IP for the best Internet experience, 一个本地DNS服务器,获取最快的网站IP,获得最佳上网体验。

License

Notifications You must be signed in to change notification settings

yyysuo/smartdns

 
 

Repository files navigation

SmartDNS

English

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

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

目录

软件效果展示

阿里 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、DOT 和 DOH 查询,以及非 53 端口查询;支持通过socks5,HTTP代理查询。

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

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

  6. 域名分流
    支持域名分流,不同类型的域名向不同的 DNS 服务器查询,支持iptable和nftable更好的分流。

  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。

架构

Architecture

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

下载

使用官方安装源

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

系统 安装方式 说明
openwrt opkg update
opkg install luci-app-smartdns
opkg install smartdns
22.03之后的系统。软件源路径:https://downloads.openwrt.org/releases/
ddwrt 官方最新固件service页面->SmartDNS Resolver->启用。 选择界面参考:https://forum.dd-wrt.com/demo/Services.html
debian apt-get install smartdns
entware ipkg update
ipkg install smartdns
软件源路径:https://bin.entware.net/

手工下载安装


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

支持系统(架构) 安装包 支持说明
标准 Linux 系统(ARM) smartdns.1.yyyy.MM.dd-REL.arm-debian-all.deb ARM 的树莓派 Raspbian Stretch 和 Debian 9 系统
标准 Linux 系统(ARM64) smartdns.1.yyyy.MM.dd-REL.aarch64-debian-all.deb ARM64 的 Debian Stretch 和 Debian 9 系统
标准 Linux 系统(x86_64) smartdns.1.yyyy.MM.dd-REL.x86_64-linux-all.tar.gz 64 位 Linux 系统
标准 Linux 系统(x86) smartdns.1.yyyy.MM.dd-REL.x86-linux-all.tar.gz 32 位 Linux 系统
WSL smartdns.1.yyyy.MM.dd-REL.x86_64-linux-all.tar.gz WSL
Optware smartdns.1.yyyy.MM.dd-REL.mips-optware-all.ipk MIPS 大端架构的 Optware 系统
Optware(MIPS Little Endian) smartdns.1.yyyy.MM.dd-REL.mipsel-optware-all.ipk MIPS 小端架构的 Optware 系统
Optware(ARM) smartdns.1.yyyy.MM.dd-REL.arm-optware-all.ipk ARM 小端架构的 Optware 系统
OpenWrt(MIPS) smartdns.1.yyyy.MM.dd-REL.mips-openwrt-all.ipk MIPS 大端架构的 OpenWrt 系统
OpenWrt(MIPS Little Endian) smartdns.1.yyyy.MM.dd-REL.mipsel-openwrt-all.ipk MIPS 小端架构的 OpenWrt 系统
OpenWrt(ARM) smartdns.1.yyyy.MM.dd-REL.arm-openwrt-all.ipk ARM 小端架构的 OpenWrt 系统
OpenWrt LuCI luci-app-smartdns.1.yyyy.MM.dd-REL.all.ipk OpenWrt 管理界面
OpenWrt LuCI luci-app-smartdns.1.yyyy.MM.dd-REL.all-luci-compat-all.ipk OpenWrt 管理界面、OpenWrt 18.xx 及之前版本

前往 Release 页面下载

请注意:

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

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

安装和使用

标准 Linux 系统 / 树莓派


  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

    对于Ubuntu系统:

    • systemd-resolved会占用TCP53和UDP53端口。你需要手动解决端口占用问题或者修改smartdns监听端口

    • 日志文件在/var/log/smartdns/smartdns.log

  2. 修改配置

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

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

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

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

    vi /etc/smartdns/smartdns.conf

    /etc/smartdns/smartdns.conf配置包含如下基本内容:

    # 指定监听的端口号
    bind []:53 
    # 指定上游服务器
    server 1.1.1.1
    server-tls 8.8.8.8
    # 指定域名规则
    address /example.com/1.2.3.4
    domain-rule /example.com/ -address 1.2.3.4
  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.

OpenWrt


  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. 启用服务

    • 替换默认Dnsmasq为主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 SSHLan 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

    /opt/etc/smartdns/smartdns.conf配置包含如下基本内容:

    # 指定监听的端口号
    bind []:53 
    # 指定上游服务器
    server 1.1.1.1
    server-tls 8.8.8.8
    # 指定域名规则
    address /example.com/1.2.3.4
    domain-rule /example.com/ -address 1.2.3.4

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

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

Optware / Entware


  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

    /opt/etc/smartdns/smartdns.conf配置包含如下基本内容:

    # 指定监听的端口号
    bind []:53 
    # 指定上游服务器
    server 1.1.1.1
    server-tls 8.8.8.8
    # 指定域名规则
    address /example.com/1.2.3.4
    domain-rule /example.com/ -address 1.2.3.4

    另外,如需支持 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 的文档。

WSL


  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]:portserver-tcp [IP]:port 配置项, 尽可能配置多个上游DNS服务器,包括国内外的服务器。

    具体配置请参考配置文件说明smartdns.conf 配置包含如下基本内容:

    # 指定监听的端口号
    bind []:53 
    # 指定上游服务器
    server 1.1.1.1
    server-tls 8.8.8.8
    # 指定域名规则
    address /example.com/1.2.3.4
    domain-rule /example.com/ -address 1.2.3.4
  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查询体验改善,一般情况只需要增加上游服务器地址即可,无需做其他配置修改;如有其他配置修改,请务必了解其用途,避免修改后起到反作用。

键名 功能说明 默认值 可用值/要求 举例
server-name DNS 服务器名称 操作系统主机名 / smartdns 符合主机名规格的字符串 server-name smartdns
bind DNS 监听端口号 [::]:53 可绑定多个端口。
IP:PORT@DEVICE: 服务器 IP:端口号@设备名
[-group]: 请求时使用的 DNS 服务器组
[-no-rule-addr]:跳过 address 规则
[-no-rule-nameserver]:跳过 Nameserver 规则
[-no-rule-ipset]:跳过 ipset 和 nftset 规则
[-no-rule-soa]:跳过 SOA(#) 规则
[-no-dualstack-selection]:停用双栈测速
[-no-speed-check]:停用测速
[-no-cache]:停止缓存
bind :53@eth0
bind-tcp DNS TCP 监听端口号 [::]:53 可绑定多个端口。
IP:PORT@DEVICE: 服务器 IP:端口号@设备名
[-group]: 请求时使用的 DNS 服务器组
[-no-rule-addr]:跳过 address 规则
[-no-rule-nameserver]:跳过 nameserver 规则
[-no-rule-ipset]:跳过 ipset 和 nftset 规则。
[-no-rule-soa]:跳过 SOA(#) 规则
[-no-dualstack-selection]:停用双栈测速
[-no-speed-check]:停用测速
[-no-cache]:停止缓存
bind-tcp :53
cache-size 域名结果缓存个数 512 大于等于 0 的数字 cache-size 512
cache-persist 是否持久化缓存 自动。
当 cache-file 所在的位置有超过 128 MB 的可用空间时启用,否则禁用。
[yes|no] cache-persist yes
cache-file 缓存持久化文件路径 /tmp/
smartdns.cache
合法路径字符串 cache-file /tmp/smartdns.cache
tcp-idle-time TCP 链接空闲超时时间 120 大于等于 0 的数字 tcp-idle-time 120
rr-ttl 域名结果 TTL 远程查询结果 大于 0 的数字 rr-ttl 600
rr-ttl-min 允许的最小 TTL 值 远程查询结果 大于 0 的数字 rr-ttl-min 60
rr-ttl-max 允许的最大 TTL 值 远程查询结果 大于 0 的数字 rr-ttl-max 600
rr-ttl-reply-max 允许返回给客户端的最大 TTL 值 远程查询结果 大于 0 的数字 rr-ttl-reply-max 60
local-ttl 本地HOST,address的TTL值 rr-ttl-min 大于 0 的数字 local-ttl 60
max-reply-ip-num 允许返回给客户的最大IP数量 IP数量 大于 0 的数字 max-reply-ip-num 1
log-level 设置日志级别 error fatal、error、warn、notice、info 或 debug log-level error
log-file 日志文件路径 /var/log/
smartdns/
smartdns.log
合法路径字符串 log-file /var/log/smartdns/smartdns.log
log-size 日志大小 128K 数字 + K、M 或 G log-size 128K
log-num 日志归档个数 openwrt为2, 其他系统为8 大于等于 0 的数字,0表示禁用日志 log-num 2
log-file-mode 日志归档文件权限 0640 文件权限 log-file-mode 644
audit-enable 设置审计启用 no [yes|no] audit-enable yes
audit-file 审计文件路径 /var/log/
smartdns/
smartdns-audit.log
合法路径字符串 audit-file /var/log/smartdns/smartdns-audit.log
audit-size 审计大小 128K 数字 + K、M 或 G audit-size 128K
audit-num 审计归档个数 2 大于等于 0 的数字 audit-num 2
audit-file-mode 审计归档文件权限 0640 文件权限 log-file-mode 644
conf-file 附加配置文件 合法路径字符串 conf-file /etc/smartdns/smartdns.more.conf
server 上游 UDP DNS 可重复。
[ip][:port]|URL:服务器 IP:端口(可选)或 URL
[-blacklist-ip]:配置 IP 过滤结果。
[-whitelist-ip]:指定仅接受参数中配置的 IP 范围
[-group [group] ...]:DNS 服务器所属组,比如 office 和 foreign,和 nameserver 配套使用
[-exclude-default-group]:将 DNS 服务器从默认组中排除。
[-set-mark mark]:设置数据包标记so-mark。
[-proxy name]:设置代理服务器。
server 8.8.8.8:53 -blacklist-ip -group g1 -proxy proxy
server tls://8.8.8.8
server-tcp 上游 TCP DNS 可重复。
[ip][:port]:服务器 IP:端口(可选)
[-blacklist-ip]:配置 IP 过滤结果
[-whitelist-ip]:指定仅接受参数中配置的 IP 范围。
[-group [group] ...]:DNS 服务器所属组,比如 office 和 foreign,和 nameserver 配套使用
[-exclude-default-group]:将 DNS 服务器从默认组中排除。
[-set-mark mark]:设置数据包标记so-mark。
[-proxy name]:设置代理服务器。
server-tcp 8.8.8.8:53
server-tls 上游 TLS DNS 可重复。
[ip][:port]:服务器 IP:端口(可选)
[-spki-pin [sha256-pin]]:TLS 合法性校验 SPKI 值,base64 编码的 sha256 SPKI pin 值
[-host-name]:TLS SNI 名称, 名称设置为-,表示停用SNI名称
[-tls-host-verify]:TLS 证书主机名校验
[-no-check-certificate]:跳过证书校验
[-blacklist-ip]:配置 IP 过滤结果
[-whitelist-ip]:仅接受参数中配置的 IP 范围
[-group [group] ...]:DNS 服务器所属组,比如 office 和 foreign,和 nameserver 配套使用
[-exclude-default-group]:将 DNS 服务器从默认组中排除。
[-set-mark mark]:设置数据包标记so-mark。
[-proxy name]:设置代理服务器。
server-tls 8.8.8.8:853
server-https 上游 HTTPS DNS 可重复。
https://[host][:port]/path:服务器 IP:端口(可选)
[-spki-pin [sha256-pin]]:TLS 合法性校验 SPKI 值,base64 编码的 sha256 SPKI pin 值
[-host-name]:TLS SNI 名称
[-http-host]:http 协议头主机名
[-tls-host-verify]:TLS 证书主机名校验
[-no-check-certificate]:跳过证书校验
[-blacklist-ip]:配置 IP 过滤结果
[-whitelist-ip]:仅接受参数中配置的 IP 范围。
[-group [group] ...]:DNS 服务器所属组,比如 office 和 foreign,和 nameserver 配套使用
[-exclude-default-group]:将 DNS 服务器从默认组中排除。
[-set-mark]:设置数据包标记so-mark。
[-proxy name]:设置代理服务器。
server-https https://cloudflare-dns.com/dns-query
proxy-server 代理服务器 可重复。
proxy-server URL
[URL]: [socks5|http]://[username:password@]host:port
[-name]: 代理服务器名称。
proxy-server socks5://user:[email protected]:1080 -name proxy
speed-check-mode 测速模式选择 [ping|tcp:[80]|none] speed-check-mode ping,tcp:80,tcp:443
response-mode 首次查询响应模式 first-ping 模式:[first-ping|fastest-ip|fastest-response]
[first-ping]: 最快ping响应地址模式,DNS上游最快查询时延+ping时延最短,查询等待与链接体验最佳;
[fastest-ip]: 最快IP地址模式,查询到的所有IP地址中ping最短的IP。需等待IP测速;
[fastest-response]: 最快响应的DNS结果,DNS查询等待时间最短,返回的IP地址可能不是最快。
response-mode first-ping
address 指定域名 IP 地址 address /domain/[ip|-|-4|-6|#|#4|#6]
- 表示忽略
# 表示返回 SOA
4 表示 IPv4
6 表示 IPv6
address /www.example.com/1.2.3.4
nameserver 指定域名使用 server 组解析 nameserver /domain/[group|-], group 为组名,- 表示忽略此规则,配套 server 中的 -group 参数使用 nameserver /www.example.com/office
ipset 域名 ipset ipset /domain/[ipset|-|#[4|6]:[ipset|-][,#[4|6]:[ipset|-]]],-表示忽略 ipset /www.example.com/#4:dns4,#6:-
ipset-timeout 设置 ipset 超时功能启用 no [yes|no] ipset-timeout yes
nftset 域名 nftset nftset /domain/[#4|#6|-]:[family#nftable#nftset|-][,#[4|6]:[family#nftable#nftset|-]]],-表示忽略;ipv4 地址的 family 只支持 inet 和 ip;ipv6 地址的 family 只支持 inet 和 ip6;由于 nft 限制,两种地址只能分开存放于两个 set 中。 nftset /www.example.com/#4:inet#tab#dns4,#6:-
nftset-timeout 设置 nftset 超时功能启用 no [yes|no] nftset-timeout yes
nftset-debug 设置 nftset 调试功能启用 no [yes|no] nftset-debug yes
domain-rules 设置域名规则 domain-rules /domain/ [-rules...]
[-c|-speed-check-mode]:测速模式,参考 speed-check-mode 配置
[-a|-address]:参考 address 配置
[-n|-nameserver]:参考 nameserver 配置
[-p|-ipset]:参考ipset配置
[-t|-nftset]:参考nftset配置
[-d|-dualstack-ip-selection]:参考 dualstack-ip-selection
[-no-serve-expired]:禁用过期缓存
[-delete]:删除对应的规则
domain-rules /www.example.com/ -speed-check-mode none
domain-set 设置域名集合 domain-set [options...]
[-n|-name]:域名集合名称
[-t|-type]:域名集合类型,当前仅支持list,格式为域名列表,一行一个域名。
[-f|-file]:域名集合文件路径。
选项需要配合address, nameserver, ipset, nftset等需要指定域名的地方使用,使用方式为 /domain-set:[name]/
domain-set -name set -type list -file /path/to/list
address /domain-set:set/1.2.4.8
bogus-nxdomain 假冒 IP 地址过滤 [ip/subnet],可重复 bogus-nxdomain 1.2.3.4/16
ignore-ip 忽略 IP 地址 [ip/subnet],可重复 ignore-ip 1.2.3.4/16
whitelist-ip 白名单 IP 地址 [ip/subnet],可重复 whitelist-ip 1.2.3.4/16
blacklist-ip 黑名单 IP 地址 [ip/subnet],可重复 blacklist-ip 1.2.3.4/16
force-AAAA-SOA 强制 AAAA 地址返回 SOA no [yes|no] force-AAAA-SOA yes
force-qtype-SOA 强制指定 qtype 返回 SOA qtype id [qtypeid|...] force-qtype-SOA 65 28
prefetch-domain 域名预先获取功能 no [yes|no] prefetch-domain yes
dnsmasq-lease-file 支持读取dnsmasq dhcp文件解析本地主机名功能 dnsmasq dhcp lease文件路径 dnsmasq-lease-file /var/lib/misc/dnsmasq.leases
serve-expired 过期缓存服务功能 yes [yes|no],开启此功能后,如果有请求时尝试回应 TTL 为 0 的过期记录,并发查询记录,以避免查询等待
serve-expired-ttl 过期缓存服务最长超时时间 0 秒,0 表示停用超时,大于 0 表示指定的超时的秒数 serve-expired-ttl 0
serve-expired-reply-ttl 回应的过期缓存 TTL 5 秒,0 表示停用超时,大于 0 表示指定的超时的秒数 serve-expired-reply-ttl 30
dualstack-ip-selection 双栈 IP 优选 yes [yes|no] dualstack-ip-selection yes
dualstack-ip-selection-threshold 双栈 IP 优选阈值 15ms 单位为毫秒(ms) dualstack-ip-selection-threshold [0-1000]
user 进程运行用户 root user [username] user nobody
ca-file 证书文件 /etc/ssl/
certs/ca-certificates.crt
合法路径字符串 ca-file /etc/ssl/certs/ca-certificates.crt
ca-path 证书文件路径 /etc/ssl/certs 合法路径字符串 ca-path /etc/ssl/certs

常见问题

  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-sizeaudit-fileaudit-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. 如何使用ipset和nftset
    和Dnsmasq类似,smartdns支持ipset和nftset,可以将特定的域名通过TPROXY进行透明转发,透明转发涉工具模式对比如下:

    1. 工具:iptable,nftable

      iptable:成熟的路由规则配置工具。
      nftable:更加强大的规则配置工具,正在成为主流。

    2. 模式:TPROXY,REDIRECT

      TPROXY:支持UDP,TCP的转发,配置稍复杂。
      REDIRECT:仅支持TCP,配置简单。

    3. 配置REDIRECT或TPROXY转发规则

      • 在smartdns.conf中设置需要透明转发的域名列表,比如要将example.com进行透明转发。则使用ipset选项,设置example.com的ipset规则为proxy
      # 设置规则
      # -ipset proxy: 匹配的域名设置到ipset:tproxy中。
      # -c none: 停用测速
      # -address #6: 停用IPV6解析。
      domain-rules /example.com/ -ipset proxy -c none -address #6
      1. 方式一: TCP REDIRECT转发

        • 此方式配置简单,仅支持TCP的转发。
          执行shell命令,设置iptable规则,如果仅转发TCP则可以直接使用REDIRECT的规则,如果需要同时转发UDP和TCP,可以使用TPROXY的转发规则。如下规则按实际需求选择。具体配置如下:
        # 创建ipset集合
        ipset create proxy hash:net
        # 设置转发规则,将匹配的请求转发到本机的1081端口
        iptables -t nat -I PREROUTING -p tcp -m set --match-set proxy dst -j REDIRECT --to-ports 1081
        • 在本机1081端口开启REDIRECT模式的转发程序。
      2. 方式二:TCP/UDP TPROXY转发

        • 此方式可同时转发TCP和UDP。
          执行shell命令,设置iptable规则,将匹配的域名TCP/UDP请求进行TPROXY方式透明转发,规则参考如下:
        # 设置路由规则
        ip rule add fwmark 1104 lookup 1104
        ip route add local 0.0.0.0/0 dev lo table 1104
        
        # 创建ipset集合
        ipset create proxy hash:net
        
        # 设置转发规则,UDP,TCP方式的TPROXY转发
        iptables -t mangle -N SMARTDNS
        iptables -t mangle -A SMARTDNS -p tcp -m set --match-set proxy dst -j TPROXY --on-ip 127.0.0.1 --on-port 1081 --tproxy-mark 1104
        iptables -t mangle -A SMARTDNS -p udp -m set --match-set proxy dst -j TPROXY --on-ip 127.0.0.1 --on-port 1081 --tproxy-mark 1104
        iptables -t mangle -A SMARTDNS -j ACCEPT
        iptables -t mangle -A PREROUTING -j SMARTDNS
        • 在本机的1081端口启动IP透明转发程序。
    4. 额外说明
      为保证DNS查询结果的位置亲和性,可以使用smartdns的server代理参数,将对应域名的查询请求,通过代理查询,使结果位置更好。如:

      # 增加DNS上游,并设置通过名称为proxy的代理查询,查询组为pass
      server 1.2.3.4 -proxy proxy -group pass -exclude-default-group
      # 设置代理服务器信息,代理的名称为proxy
      proxy-server socks5://user:[email protected] -name proxy
      # 设置域名规则,对匹配的域名使用代理查询结果,并将结果设置到ipset中。
      domain-rules /example.com/ -ipset proxy -c none -address #6 -nameserver pass

    如果使用openwrt的luci界面,可以直接在界面配置相关的域名分流规则。

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

编译

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

捐赠

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

PayPal 贝宝

Support via PayPal

AliPay 支付宝

alipay

WeChat Pay 微信支付

wechat

开源声明

SmartDNS 基于 GPL V3 协议开源。

About

A local DNS server to obtain the fastest website IP for the best Internet experience, 一个本地DNS服务器,获取最快的网站IP,获得最佳上网体验。

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 85.1%
  • Shell 6.8%
  • JavaScript 3.2%
  • Lua 3.1%
  • C++ 0.8%
  • Makefile 0.6%
  • Other 0.4%