mirror of https://github.com/SagerNet/sing-box.git synced 2025-04-03 03:47:37 +03:00

2025-03-29 23:12:05 +08:00

1.4 KiB

Raw Blame History

icon
material/new-box

!!! question "Since sing-box 1.12.0"

DNS over HTTPS (DoH)

Structure

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

!!! info "Difference from legacy HTTPS 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.

443 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.

1.4 KiB Raw Blame History