daxi20/smartdns
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

config: add some config guide

Browse Source
This commit is contained in:
Nick Peng
2023-03-10 23:53:17 +08:00
parent dcb680ae88
commit 39efbda313
14 changed files with 507 additions and 184 deletions
Download Patch File Download Diff File Expand all files Collapse all files

194
docs/faq.md
View File

@@ -44,50 +44,6 @@ SmartDNS 有测速机制，在配置上游服务器时，建议配置多个上
- 优先使用 TLS 查询。
- 设置上游 DNS 服务器组。
## 如何屏蔽广告？
SmartDNS 具备高性能域名匹配算法，通过域名方式过滤广告非常高效，如要屏蔽广告，只需要配置类似如下记录即可，如，屏蔽 `*.ad.com`，则配置：
```shell
address /ad.com/#
```
域名的使后缀模式，过滤 `*.ad.com`，`#` 表示返回 SOA，使屏蔽广告更加高效，如果要单独屏蔽 IPv4 或 IPv6， 在 `#` 后面增加数字，如 `#4` 表示对 IPv4 生效。若想忽略特定子域名的屏蔽，如忽略 `pass.ad.com`，可配置如下：
```shell
address /pass.ad.com/-
```
## 如何使用 DNS 查询分流？
某些情况下，需要将有些域名使用特定的 DNS 服务器来查询来做到 DNS 分流。比如
```shell
.home -> 192.168.1.1 # .home 结尾的域名发送到 192.168.1.1 解析
.office -> 10.0.0.1 # .office 结尾的域名发送到 10.0.0.1 解析
```
其他域名采用默认的模式解析。
这种情况的分流配置如下：
```shell
# 配置上游，用 -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` 参数指定分流名称。
```shell
bind :7053 -group office
bind :8053 -group home
```
## 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`。
@@ -145,150 +101,20 @@ IOS14开始，苹果支持了DNS HTTPS(TYPE65)记录的解析，此功能用于
force-qtype-SOA 65
```
## 如何解析本地主机名称？
## 为什么smartdns会返回多个IP
smartdns可以配合DNSMASQ的dhcp lease文件支持本地主机名->IP地址的解析，可以配置smartdns读取dnsmasq的lease文件，并支持解析。具体配置参数如下，（注意，DNSMASQ lease文件每个系统可能不一样，需要按实际情况配置）
SmartDNS在早期版本，只会返回一个IP地址，这一个IP地址速度时最快的，这对游戏，浏览器都很好，但对于一些视频播放软件，下载软件则不太友好。这些软件需要更多好的IP地址。
```shell
dnsmasq-lease-file /var/lib/misc/dnsmasq.leases
```
所以，smartdns从37开始，支持返回多个优选的IP地址，这些优选的IP地址原则是：
配置完成后，可以直接使用主机名连接对应的机器。但需要注意：
1. 如果缓存没有命中，则返回及时返回一个IP地址给客户端，并设置TTL为3，让客户端再次查询。
1. 并行的，smartdns等待所有IP地址的查询结果，并对查询结果进行优选。原则为：
- IP列表中的第一个IP为最快地址。
- 其他IP相比第一个IP的速度差不多。
- 速度较差的IP丢弃。
1. 客户端3秒后，再次查询，将会获的所有最佳IP地址。
- Windows系统默认使用mDNS解析地址，如需要在windows下用使用smartdns解析，则需要在主机名后面增加`.`，表示使用DNS解析。如`ping smartdns.`
## 域名集合如何使用？
为方便按集合配置域名，对于有/domain/的配置，可以指定域名集合，方便维护。具体方法为：
- 使用`domain-set`配置集合文件，如
```shell
domain-set -name ad -file /etc/smartdns/ad-list.conf
```
ad-list.conf的格式为一个域名一行，如
```shell
ad.com
site.com
```
- 在有/domain/配置的选项使用域名集合，只需要将`/domain/`配置为`/domain-set:[集合名称]/`即可，如：
```shell
address /domain-set:ad/#
domain-rules /domain-set:ad/ -a #
nameserver /domain-set:ad/server
...
```
## 如何使用ipset和nftset
和Dnsmasq类似，smartdns支持ipset和nftset，可以将特定的域名通过TPROXY进行透明转发，透明转发涉工具模式对比如下：
1. 工具：iptable，nftable
iptable：成熟的路由规则配置工具。
nftable：更加强大的规则配置工具，正在成为主流。
1. 模式：TPROXY，REDIRECT
TPROXY：支持UDP，TCP的转发，配置稍复杂。
REDIRECT：仅支持TCP，配置简单。
1. 配置REDIRECT或TPROXY转发规则
在smartdns.conf中设置需要透明转发的域名列表，比如要将`example.com`进行透明转发。则使用ipset选项，设置`example.com`的ipset规则为`proxy`。
```shell
# 设置规则
# -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的转发规则。如下规则按实际需求选择。具体配置如下：
```shell
# 创建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模式的转发程序。
1. 方式二：TCP/UDP TPROXY转发
- 此方式可同时转发TCP和UDP。
执行shell命令，设置iptable规则，将匹配的域名TCP/UDP请求进行TPROXY方式透明转发，规则参考如下：
```shell
# 设置路由规则
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透明转发程序。
1. 额外说明
- 为保证DNS查询结果的位置亲和性，可以使用smartdns的`server`代理参数，将对应域名的查询请求，通过代理查询，使结果位置更好。如：
```shell
# 增加DNS上游，并设置通过名称为proxy的代理查询，查询组为pass
server 1.2.3.4 -proxy proxy -group pass -exclude-default-group
# 设置代理服务器信息，代理的名称为proxy
proxy-server socks5://user:name@1.2.3.4 -name proxy
# 设置域名规则，对匹配的域名使用代理查询结果，并将结果设置到ipset中。
domain-rules /example.com/ -ipset proxy -c none -address #6 -nameserver pass
```
- 如需要配合测速自动完成ipset的设置，可增加如下配置参数
```shell
ipset-no-speed proxy
```
如果使用OpenWrt的luci界面，可以直接在界面配置相关的域名分流规则。
## BootStrap DNS
对于域名类的上游服务器，SmartDNS会使用其他IP地址类的服务器进行解析，所以一般情况下无需配置BootStrap DNS，但如果有特殊需求，需要指定BootStrap DNS。则可以通过如下方式配置：
1. nameserver指定上游服务器
使用nameserver参数指定特定域名使用指定DNS解析。
```shell
server dns.server # 此服务器将使用1.2.3.4解析。
server 1.2.3.4 -group bootstrap
nameserver /dns.server/bootstrap
```
1. 对所有服务器指定bootstrap DNS。
使用`-bootstrap-dns`参数，指定特定的server为bootstrap DNS。
```shell
server 1.2.3.4 -bootstrap-dns
server dns.server
```
值得注意的是，上述机制，是在开启了缓存的情况下，如果缓存未开启，则仍然返回最快的一个地址。
## 更多问题