← 返回 GitHub Proxy 最新地址发布 - GitHub 文件 , Releases 首页

v2rayN DNS 设置怎么配置?入口、分流与解析失败排查

更新于 2026-10-20 · ghproxy.cyou

简答:v2rayN 的 DNS 设置在设置窗口的“DNS 设置(DNS Settings)”区域。先确认当前配置使用 Xray 还是 sing-box,再填写直连 DNS、远程 DNS 和 Bootstrap DNS;如果所有节点都超时,先点击“导入默认 DNS 配置”,关闭自定义 DNS、FakeIP 和 TUN,重启核心后逐项恢复。

定义:v2rayN DNS 设置,是在客户端中指定直连解析、代理目标解析以及用于解析 DNS 服务器域名的 Bootstrap DNS,并由当前核心生成对应 DNS 配置。

先看症状:不要一上来复制整段 JSON

如果你只是想让 v2rayN 正常解析域名,先在设置窗口打开“DNS 设置(DNS Settings)”区域,确认当前配置使用的核心,再只修改基础 DNS 字段。v2rayN 官方说明显示,客户端支持 Xray 和 sing-box 等核心;未启用自定义 DNS 时,会根据 DNS 基础设置和路由配置自动生成 DNS 服务器及相关分流配置。v2rayN 官方 Wiki v2rayN 官方 FAQ

v2rayN DNS 设置症状速查
症状先检查哪里可复现的验证动作
所有节点都超时自定义 DNS、Bootstrap DNS、TUN点击“导入默认 DNS 配置”,关闭自定义 DNS 与 TUN,重启核心后再连一次
只有浏览器异常浏览器是否启用了安全 DNS在 Chrome 的“设置→隐私和安全→安全”中检查“使用安全 DNS”
只有 TUN 模式失败FakeIP、DNS 接管和路由回环关闭 TUN 测试一次,再开启 TUN;若仅开启后失败,先关闭 FakeIP 和自定义 DNS
国内网站变慢直连 DNS 与路由匹配先恢复基础配置,再检查直连目标解析策略和路由规则是否被同时修改

本站是第三方使用指南站,不是 v2rayN 官方站;菜单名称可能随当前版本界面变化,请以实际版本为准。

设置入口与三个基础字段怎么填

  1. 打开设置窗口:在 v2rayN 中进入设置窗口,找到“DNS 设置(DNS Settings)”区域。不同版本可能将它放在设置页的不同位置,但字段名称通常围绕直连 DNS、远程 DNS、Bootstrap DNS 和自定义 DNS 展开。具体界面说明可参考 v2rayN 官方界面功能说明。
  2. 先确认核心:当前配置优先使用配置文件指定的 Core 类型;如果配置文件没有指定,再使用 Core 类型设置中的选择。v2rayN Core 类型说明
  3. 填写直连 DNS:这是直连 DNS 服务器地址,多个地址按界面要求用逗号分隔。v2rayN 官方说明指出,Xray 默认主要将它用于路由阶段的 IP 规则匹配;sing-box 还会用它处理路由匹配、节点域名和直连目标域名解析。
  4. 填写远程 DNS:这是远程 DNS 服务器地址,多个地址同样用逗号分隔。Xray 默认主要用于路由阶段的 IP 规则匹配;sing-box 还会用它处理路由匹配和代理目标域名解析。
  5. 填写 Bootstrap DNS:只使用 IP 地址形式。它的作用是先解析直连 DNS 或远程 DNS 中填写的域名,因此不要把完整的 DoH URL 直接填入 Bootstrap DNS。v2rayN DNS 基础设置说明

修改后先点击“导入默认 DNS 配置”或恢复到基础配置,再保存并重启核心。v2rayN 官方 FAQ 说明,关闭自定义 DNS 后,客户端会依据基础 DNS 设置和路由配置自动生成 DNS 服务器及规则分流;因此排错时不要同时修改自定义 DNS、路由、TUN 和 FakeIP。

四种需求怎么选:基础可用、分流、防泄漏与 TUN

v2rayN DNS 场景选择表
需求起步设置验证方法先不要做什么
只想正常访问确认核心,填写直连 DNS 和远程 DNS,暂不启用自定义 DNS重启核心后分别测试一个直连域名和一个代理域名不要先启用 FakeIP 或完整自定义配置
国内外域名分流让直连 DNS 服务于直连目标,让远程 DNS 服务于代理目标,并保持路由规则与解析策略一致查看两类域名的访问结果和核心日志,不要只测一个网站不要把所有查询无条件交给同一个服务器
担心 DNS 泄漏先确认应用是否走 v2rayN 的代理或 TUN,再检查浏览器是否启用独立安全 DNS关闭 TUN 与开启 TUN 各测试一次,并在 DNS 检测页面比较解析出口不要把 nslookup 结果直接当成 v2rayN DNS 已生效的证明
需要 TUN/FakeIP确认使用 sing-box 核心,开启 TUN 后再启用 FakeIP分别测试关闭 TUN、开启 TUN、开启 FakeIP 三个状态不要把 FakeIP 当作普通系统代理模式的通用选项

v2rayN 官方界面说明明确写明,FakeIP 仅支持 sing-box 核心,并且只在 TUN 模式下有效;“阻止 SVCB 和 HTTPS 查询”也属于 sing-box 的 TUN 相关进阶选项。v2rayN FakeIP 与 TUN 说明

浏览器还可能拥有自己的安全 DNS。Chrome 官方说明称,开启安全 DNS 后,Chrome 会加密域名查询;因此系统解析正常但浏览器异常时,应检查 Chrome“设置(Settings)→隐私和安全(Privacy and security)→安全(Security)→使用安全 DNS(Use secure DNS)”。Chrome 官方安全 DNS 说明

Xray 核心:先用最小配置,再增加分流条件

确认使用 Xray 后,建议先从只包含服务器和查询策略的最小结构开始。下面是 Xray DNS 配置结构示例,不是每个 v2rayN 版本都能直接粘贴的完整配置文件;其中 DNS 地址应替换为你当前网络可以访问的上游。

{
  "dns": {
    "servers": [
      "192.0.2.53",
      "https://dns.example.test/dns-query"
    ],
    "queryStrategy": "UseIP"
  }
}

上面的地址使用文档示例形式,不能直接当作可用公共 DNS。实际填写时,普通 IP 地址、DoH URL 和 DoT 地址必须按照当前 Xray 与 v2rayN 界面支持的格式分别填写,不要把不同协议的字段混在一起。

确认最小配置可以启动后,再考虑按域名和返回 IP 过滤结果。Xray 当前官方文档使用 expectedIPs 字段;它会过滤不符合指定 IP 范围的结果,过滤后为空时再尝试后续服务器。skipFallback 为 true 时,表示该服务器在 DNS fallback 查询阶段会被跳过,并不是“命中该服务器后跳过 fallback”。Xray 官方 DNS 文档

{
  "dns": {
    "servers": [
      {
        "address": "192.0.2.53",
        "domains": ["geosite:cn"],
        "expectedIPs": ["geoip:cn"],
        "skipFallback": true
      },
      "https://dns.example.test/dns-query"
    ],
    "queryStrategy": "UseIP"
  }
}

这是“按域名优先、其余服务器作为回退”的结构示例。192.0.2.53 与 dns.example.test 是文档占位值,实际使用前必须替换为可达的 DNS 地址。不要把境外上游直接写成负责国内域名的唯一服务器,否则既不符合分流目的,也可能因 IP 过滤造成反复回退。

另外,domainStrategy 和 queryStrategy 不是同一个字段:前者属于路由配置,用于决定路由匹配时是否将域名解析为 IP;后者属于 DNS 配置,用于限制 Xray 查询 IPv4、IPv6 或两者。Xray 官方路由文档列出 AsIs、IPIfNonMatch 和 IPOnDemand 等路由取值;DNS 文档列出 UseIP、UseIPv4、UseIPv6 和 UseSystem 等查询策略。Xray 官方路由文档 Xray 官方 DNS 字段文档

sing-box 核心:新版 DoH 写法要补 domain_resolver

确认使用 sing-box 后,优先在 v2rayN 的 DNS 设置中点击“导入默认 DNS 配置”,再按当前版本字段修改。sing-box 官方文档显示,1.12.0 起 DNS 服务器采用 type、server 等新结构;当 HTTPS DNS 的 server 使用域名时,必须设置 domain_resolver 来解析该域名。sing-box 官方 DNS Server 文档 sing-box 官方 HTTPS DNS 文档

{
  "dns": {
    "servers": [
      {
        "type": "local",
        "tag": "local"
      },
      {
        "type": "https",
        "tag": "remote-doh",
        "server": "dns.example.test",
        "path": "/dns-query",
        "domain_resolver": "local"
      }
    ],
    "final": "remote-doh"
  }
}

这里补齐了 local DNS 服务器,因此 domain_resolver 引用的 tag 确实存在。dns.example.test 仍是占位域名,实际使用时必须替换为可达的 DoH 服务器域名;如果使用 IP 地址,可以减少解析该服务器域名这一层依赖,但仍应按当前 sing-box 文档核对 TLS 和路径设置。sing-box 官方 Dial Fields 文档

如果配置启动失败,先关闭自定义 DNS,点击“导入默认 DNS 配置”,保存并重启核心。不要把 sing-box 1.12.0 之前的旧版 HTTPS 服务器结构与新版 type、server、domain_resolver 字段混用。

修改后如何验证:区分系统解析、客户端解析与 DNS 泄漏

  1. 先保存备份:修改前使用 v2rayN 的备份功能保存配置。官方说明称,备份和还原对象是整个 guiConfigs 文件夹;还原成功后 v2rayN 会重启。v2rayN 备份与还原说明
  2. 恢复最小状态:关闭自定义 DNS、FakeIP 和 TUN,点击“导入默认 DNS 配置”,保存后停止并重新启动核心。
  3. 测试系统解析:在 Windows 命令提示符运行 nslookup example.com。普通系统代理模式下,这一步通常测试的是操作系统 DNS,不代表 v2rayN 内置 DNS 已接管;开启 TUN 后,结果还会受到 TUN 的 DNS 接管方式影响。
  4. 测试客户端访问:分别打开一个应当直连的域名和一个应当代理的域名,记录是否能连接、是否只在 TUN 开启后失败。
  5. 检查浏览器绕过:如果只有 Chrome 异常,检查“使用安全 DNS”是否被设置为自定义提供商。Chrome 官方说明称,自定义安全 DNS 出错时可能出现找不到服务器 IP 等错误,因此应暂时关闭或改回当前服务提供商进行对照测试。Chrome 官方安全 DNS排查说明
  6. 做 DNS 泄漏对照:在关闭 TUN、开启 TUN、关闭浏览器自定义安全 DNS后分别访问同一个 DNS 检测页面,比较检测到的解析服务是否发生变化。该方法只能作为对照,不应把单次检测结果当作绝对结论。
  7. 一次只改一项:若所有节点仍超时,回到默认 DNS 配置,再按“直连 DNS→远程 DNS→Bootstrap DNS→自定义 DNS→TUN/FakeIP”的顺序逐项恢复。

如果日志中出现解析超时、无法解析服务器域名或配置解析失败等提示,先检查 DoH 域名是否有可用的 Bootstrap DNS、domain_resolver 引用的 tag 是否存在,以及自定义 DNS 是否与当前核心类型匹配。不要把未经核对的日志关键词当成固定错误码;不同核心和版本的实际文本可能不同。

常见问题

v2rayN DNS 设置入口在哪里?

通常在设置窗口的“DNS 设置(DNS Settings)”区域。不同版本可能调整菜单位置或中文译名,请以当前版本界面为准;官方界面说明将直连 DNS、远程 DNS、Bootstrap DNS、自定义 DNS、FakeIP 等选项放在 DNS 设置部分。v2rayN 官方 DNS 设置说明

直连 DNS、远程 DNS 和 Bootstrap DNS 有什么区别?

直连 DNS 用于直连目标相关的解析,远程 DNS 用于代理目标相关的解析,Bootstrap DNS 用于先解析以域名形式填写的 DNS 服务器。Bootstrap DNS 应填写 IP 地址,不要直接填 DoH URL。Xray 和 sing-box 对直连、远程 DNS 的实际使用范围不同,应先确认当前核心。

为什么 v2rayN DNS 改完后所有节点都超时?

先关闭自定义 DNS、FakeIP 和 TUN,点击“导入默认 DNS 配置”,保存并重启核心。随后检查 DoH 域名是否能通过 Bootstrap DNS 解析、sing-box 的 domain_resolver 是否引用了存在的 server tag,以及 Xray 的自定义 JSON 是否有重复引号或字段拼写错误。

nslookup 能证明 v2rayN DNS 设置生效吗?

不能直接证明。普通系统代理模式下,nslookup 通常调用操作系统 DNS,而不是 v2rayN 内置 DNS;它只能帮助判断本机系统解析是否正常。要判断客户端设置,应结合核心重启结果、客户端访问、TUN 开关前后对照和日志一起判断。

UseIP、UseIPv4 和 UseIPv6 应该怎么选?

这些是 Xray DNS 的 queryStrategy 取值:UseIP 允许 IPv4 和 IPv6 查询,UseIPv4 只查询 IPv4,UseIPv6 只查询 IPv6。普通双栈网络可先使用 UseIP;如果实际网络没有可用 IPv6,再根据连通性选择 UseIPv4。不要把这些值填入路由的 domainStrategy。Xray 官方 queryStrategy 定义

常见问题

v2rayN DNS 设置入口在哪里?

通常在设置窗口的“DNS 设置(DNS Settings)”区域。不同版本可能调整菜单位置或中文译名,请以当前版本界面为准;官方界面说明将直连 DNS、远程 DNS、Bootstrap DNS、自定义 DNS、FakeIP 等选项放在 DNS 设置部分。

直连 DNS、远程 DNS 和 Bootstrap DNS 有什么区别?

直连 DNS 用于直连目标相关的解析,远程 DNS 用于代理目标相关的解析,Bootstrap DNS 用于先解析以域名形式填写的 DNS 服务器。Bootstrap DNS 应填写 IP 地址,不要直接填 DoH URL。Xray 和 sing-box 对直连、远程 DNS 的实际使用范围不同,应先确认当前核心。

为什么 v2rayN DNS 改完后所有节点都超时?

先关闭自定义 DNS、FakeIP 和 TUN,点击“导入默认 DNS 配置”,保存并重启核心。随后检查 DoH 域名是否能通过 Bootstrap DNS 解析、sing-box 的 domain_resolver 是否引用了存在的 server tag,以及 Xray 的自定义 JSON 是否有重复引号或字段拼写错误。

nslookup 能证明 v2rayN DNS 设置生效吗?

不能直接证明。普通系统代理模式下,nslookup 通常调用操作系统 DNS,而不是 v2rayN 内置 DNS;它只能帮助判断本机系统解析是否正常。要判断客户端设置,应结合核心重启结果、客户端访问、TUN 开关前后对照和日志一起判断。

UseIP、UseIPv4 和 UseIPv6 应该怎么选?

这些是 Xray DNS 的 queryStrategy 取值:UseIP 允许 IPv4 和 IPv6 查询,UseIPv4 只查询 IPv4,UseIPv6 只查询 IPv6。普通双栈网络可先使用 UseIP;如果实际网络没有可用 IPv6,再根据连通性选择 UseIPv4。不要把这些值填入路由的 domainStrategy。

相关阅读

参考资料

  1. v2rayN 官方 Wiki:重要界面功能、DNS 设置、FakeIP 与备份还原
  2. v2rayN 官方 Wiki:客户端与核心文档入口
  3. Xray 官方文档:内置 DNS、expectedIPs、skipFallback 与 queryStrategy
  4. Xray 官方文档:路由 domainStrategy
  5. sing-box 官方文档:DNS Server 类型与新版结构
  6. sing-box 官方文档:新版 HTTPS DNS 与 domain_resolver
  7. sing-box 官方文档:Dial Fields 与 domain_resolver
  8. Chrome 官方帮助:安全 DNS 设置与排查
  9. github.com
  10. github.com