DNS Server

Structure

{
  "dns": {
    "servers": [
      {
        "tag": "google",
        "address": "tls://dns.google",
        "address_resolver": "local",
        "address_strategy": "prefer_ipv4",
        "strategy": "ipv4_only",
        "detour": "direct"
      }
    ]
  }
}

Fields

tag

The tag of the dns server.

address

Required

The address of the dns server.

Protocol	Format
`System`	`local`
`TCP`	`tcp://1.0.0.1`
`UDP`	`8.8.8.8` `udp://8.8.4.4`
`TLS`	`tls://dns.google`
`HTTPS`	`https://1.1.1.1/dns-query`
`QUIC`	`quic://dns.adguard.com`
`HTTP3`	`h3://8.8.8.8/dns-query`
`RCode`	`rcode://refused`
`DHCP`	`dhcp://auto` or `dhcp://en0`
FakeIP	`fakeip`

To ensure that system DNS is in effect, rather than Go's built-in default resolver, enable CGO at compile time.

QUIC and HTTP3 transport is not included by default, see Installation.

the RCode transport is often used to block queries. Use with rules and the disable_cache rule option.

DHCP transport is not included by default, see Installation.

RCode	Description
`success`	`No error`
`format_error`	`Format error`
`server_failure`	`Server failure`
`name_error`	`Non-existent domain`
`not_implemented`	`Not implemented`
`refused`	`Query refused`

address_resolver

Required if address contains domain

Tag of a another server to resolve the domain name in the address.

address_strategy

The domain strategy for resolving the domain name in the address.

One of prefer_ipv4 prefer_ipv6 ipv4_only ipv6_only.

dns.strategy will be used if empty.

strategy

Default domain strategy for resolving the domain names.

One of prefer_ipv4 prefer_ipv6 ipv4_only ipv6_only.

Take no effect if override by other settings.

detour

Tag of an outbound for connecting to the dns server.

Default outbound will be used if empty.