sing-box/docs/configuration/dns/server/http3.md
2025-01-30 19:43:36 +08:00

1.3 KiB

icon
material/new-box

!!! question "Since sing-box 1.12.0"

DNS over HTTP3 (DoH3)

Structure

{
  "dns": {
    "servers": {
      "type": "h3",
      "tag": "",
      
      "server": "",
      "server_port": 443,
      
      "path": "",
      "headers": {},
      
      "tls": {},
      
      // Dial Fields
    }
  }
}

!!! info "Difference from legacy H3 server"

* The old server uses default outbound by default unless detour is specified; the new one uses dialer just like outbound, which is equivalent to using an empty direct outbound by default.
* The old server uses `address_resolver` and `address_strategy` to resolve the domain name in the server; the new one uses `domain_resolver` and `domain_strategy` in [Dial Fields](/configuration/shared/dial/) instead.

Fields

server

==Required==

The address of the DNS server.

If domain name is used, domain_resolver must also be set to resolve IP address.

server_port

The port of the DNS server.

853 will be used by default.

path

The path of the DNS server.

/dns-query will be used by default.

headers

Additional headers to be sent to the DNS server.

tls

TLS configuration, see TLS.

Dial Fields

See Dial Fields for details.