Skip to content

Changes in sing-box 1.13.0

prefer_go

Since sing-box 1.12.0

Local

Structure

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

        // Dial Fields
      }
    ]
  }
}

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

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.