From f14597dd2093db04525b5a0c5d941f62a6128460 Mon Sep 17 00:00:00 2001 From: xqzr <34030394+xqzr@users.noreply.github.com> Date: Tue, 26 Oct 2021 02:37:17 +0800 Subject: [PATCH] add DNS fallback (#139) * Update dns.md https://github.com/XTLS/Xray-core/releases/tag/v1.5.0 --- docs/config/dns.md | 51 ++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 42 insertions(+), 9 deletions(-) diff --git a/docs/config/dns.md b/docs/config/dns.md index b8700e8..17972ca 100644 --- a/docs/config/dns.md +++ b/docs/config/dns.md @@ -23,15 +23,16 @@ Xray 内置的 DNS 模块，主要有两大用途： ## DNS 处理流程 -DNS 服务器配置模块可以配置多个 DNS 服务器, 并且指定优先匹配列表. +若当前要查询的域名： -1. 查询的域名与某个 DNS 服务器指定的域名列表匹配时，Xray 会优先使用这个 DNS 服务器进行查询。 -2. 无匹配时, 按从上往下的顺序进行查询，并且会跳过 1 步骤中使用的最后一个服务器。 -3. 只返回匹配 expectIPs 的 IP 列表。 - -DNS 服务器的处理流程示意图如下： - -![](./dns_flow.png?classes=border,shadow) +- 命中了 `hosts` 中的「域名 - IP」、「域名 - IP 数组」映射，则将该 IP 或 IP 数组作为 DNS 解析结果返回。 +- 命中了 `hosts` 中的「域名 - 域名」映射，则该映射的值（另一个域名）将作为当前要查询的域名，进入 DNS 处理流程，直到解析出 IP 后返回，或返回空解析。 +- 没有命中 `hosts`，但命中了某（几）个 DNS 服务器中的 `domains` 域名列表，则按照命中的规则的优先级，依次使用该规则对应的 DNS 服务器进行查询。若命中的 DNS 服务器查询失败或 `expectIPs` 不匹配，则使用下一个命中的 DNS 服务器进行查询；否则返回解析得到的 IP。若所有命中的 DNS 服务器均查询失败或 `expectIPs` 不匹配，此时 DNS 组件： + - 默认会进行 「DNS 回退（fallback）查询」：使用「上一轮失败查询中未被使用的、且 `skipFallback` 为默认值 `false` 的 DNS 服务器」依次查询。若查询失败或 `expectIPs` 不匹配，返回空解析；否则返回解析得到的 IP。 + - 若 `disableFallback` 设置为 `true`，则不会进行「DNS 回退（fallback）查询」。 +- 既没有命中 `hosts`，又没有命中 DNS 服务器中的 `domains` 域名列表，则： + - 默认使用「`skipFallback` 为默认值 `false` 的 DNS 服务器」依次查询。若第一个被选中的 DNS 服务器查询失败或 `expectIPs` 不匹配，则使用下一个被选中的 DNS 服务器进行查询；否则返回解析得到的 IP。若所有被选中的 DNS 服务器均查询失败或 `expectIPs` 不匹配，返回空解析。 + - 若「`skipFallback` 为默认值 `false` 的 DNS 服务器」数量为 0 或 `disableFallback` 设置为 `true`，则使用 DNS 配置中的第一个 DNS 服务器进行查询。查询失败或 `expectIPs` 不匹配，返回空解析；否则返回解析得到的 IP。 ## DnsObject @@ -50,11 +51,16 @@ DNS 服务器的处理流程示意图如下： "address": "1.2.3.4", "port": 5353, "domains": ["domain:xray.com"], - "expectIPs": ["geoip:cn"] + "expectIPs": ["geoip:cn"], + "skipFallback": false }, "localhost" ], "clientIp": "1.2.3.4", + "queryStrategy": "UseIP", + "disableCache": false, + "disableFallback": false, + "disableFallbackIfMatch": false, "tag": "dns_inbound" } } @@ -105,6 +111,29 @@ DNS 服务器的处理流程示意图如下： 用于 DNS 查询时通知服务器以指定 IP 位置。不能是私有地址。 +::: tip TIP 1 +需要 DNS 服务器支持 EDNS Client Subnet。 +::: + +::: tip TIP 2 +可以在 [DnsObject](#dnsobject) 为所有 DNS 服务器指定 clientIp, 也可在每个 DNS 服务器配置的 [ServerObject](#serverobject) 为此 DNS 服务器指定 clientIp （优先级高于 [DnsObject](#dnsobject) 的配置）。 + +> `queryStrategy`: "UseIP" | "UseIPv4" | "UseIPv6" + +`UseIPv4` 只查询 A 记录；`UseIPv6` 只查询 AAAA 记录。默认值为 `UseIP`，即查询 A 和 AAAA 记录。 + +> `disableCache`: true | false + +`true` 禁用 DNS 缓存，默认为 `false`，即不禁用。 + +> `disableFallback`: true | false + +`true` 禁用 DNS 的 fallback 查询，默认为 `false`，即不禁用。 + +> `disableFallbackIfMatch`: true | false + +`true` 当 DNS 服务器的优先匹配域名列表命中时，禁用 fallback 查询，默认为 `false`，即不禁用。 + > `tag`: string 由内置 DNS 发出的查询流量，除 `localhost` 和 `DOHL_` 模式外，都可以用此标识在路由使用 `inboundTag` 进行匹配。 @@ -149,3 +178,7 @@ DNS 服务器端口，如 `53`。此项缺省时默认为 `53`。当使用 DOH 当配置此项时，Xray DNS 会对返回的 IP 的进行校验，只返回包含 expectIPs 列表中的地址。 如果未配置此项，会原样返回 IP 地址。 + +> `skipFallback`: true | false + +`true`，在进行 DNS fallback 查询时将跳过此服务器, 默认为 `false`，即不跳过。