littlebalalafairy/sing-box
1
0
Fork 0
mirror of https://github.com/SagerNet/sing-box.git synced 2025-08-19 00:27:38 +08:00
Code Issues Packages Projects Releases Wiki Activity

documentation: Improve local DNS server

Browse Source
This commit is contained in:
世界 2025-08-18 16:04:13 +08:00
parent 7058c2e08a
commit b09cb7969b
No known key found for this signature in database
GPG Key ID: CD109927C34A63C4
1 changed files with 27 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/configuration/dns/server/local.md
View File

@ -2,6 +2,10 @@
icon: material/new-box 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" !!! question "Since sing-box 1.12.0"
# Local # Local
@ -15,6 +19,7 @@ icon: material/new-box
{ {
"type": "local", "type": "local",
"tag": "", "tag": "",
"prefer_go": false
// Dial Fields // Dial Fields
} }
@ -24,10 +29,31 @@ icon: material/new-box
``` ```
!!! info "Difference from legacy local server" !!! 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 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. * 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:
* On Apple platforms: Use `libresolv` for resolution, as it is the only one that works properly with NetworkExtension
that overrides DNS servers (DHCP is also possible but is not considered).
* On Linux: Resolve through `systemd-resolvd`'s DBus interface when available.
As a sole exception, it cannot disable the following behavior:
In the Android graphical client, the `local` DNS server 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 IP queries.
### Dial Fields ### Dial Fields
See [Dial Fields](/configuration/shared/dial/) for details. See [Dial Fields](/configuration/shared/dial/) for details.