sing-box/docs/configuration/dns/server/local.md

icon

icon
material/new-box

!!! quote "Changes in sing-box 1.13.0"

:material-plus: [prefer_go](#prefer_go)  

!!! question "Since sing-box 1.12.0"

Local

Structure

{
  "dns": {
    "servers": [
      {
        "type": "local",
        "tag": "",
        "prefer_go": false

        // Dial Fields
      }
    ]
  }
}

!!! info "Difference from legacy local server"

* The old legacy local server only handles IP requests; the new one handles all types of requests and supports concurrent for IP requests.
* The old local 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.

Fields

prefer_go

!!! question "Since sing-box 1.13.0"

When enabled, local DNS server will resolve DNS by dialing itself whenever possible.

Specifically, it disables following behaviors which was added as features in sing-box 1.13.0:

1. On Apple platforms: Attempt to resolve A/AAAA requests using getaddrinfo in NetworkExtension.
2. On Linux: Resolve through systemd-resolvd's DBus interface when available.

As a sole exception, it cannot disable the following behavior:

1. In the Android graphical client, local will always resolve DNS through the platform interface, as there is no other way to obtain upstream DNS servers; On devices running Android versions lower than 10, this interface can only resolve A/AAAA requests.

2. On macOS, local will try DHCP first in Network Extension, since DHCP respects DIal Fields, it will not be disabled by prefer_go.

Dial Fields

See Dial Fields for details.