black-internet-days-ahead/sing-box
1
0
Fork 0
mirror of https://github.com/SagerNet/sing-box.git synced 2025-01-31 13:16:53 +00:00
Code Issues Packages Projects Releases Wiki Activity
sing-box/docs/configuration/dns/server/predefined.md
世界 5979d42a09
documentation: Refactor DNS
2025-01-30 19:43:36 +08:00

1.7 KiB
Raw Blame History

icon
material/new-box

!!! question "Since sing-box 1.12.0"

Predefined

Structure

{
  "dns": {
    "servers": [
      {
        "type": "predefined",
        "tag": "",
        "responses": []
      }
    ]
  }
}

Fields

responses

==Required==

List of Response.

Response Structure

{
  "query": [],
  "query_type": [],
  "rcode": "",
  "answer": [],
  "ns": [],
  "extra": []
}

!!! note ""

You can ignore the JSON Array [] tag when the content is only one item

Response Fields

query

List of domain name to match.

query_type

List of query type to match.

rcode

The response code.

Value Value in the legacy rcode server Description
NOERROR success Ok
FORMERR format_error Bad request
SERVFAIL server_failure Server failure
NXDOMAIN name_error Not found
NOTIMP not_implemented Not implemented
REFUSED refused Refused

NOERROR will be used by default.

answer

List of text DNS record to respond as answers.

Examples:

Record Type Example
A localhost. IN A 127.0.0.1
AAAA localhost. IN AAAA ::1
TXT localhost. IN TXT \"Hello\"

ns

List of text DNS record to respond as name servers.

extra

List of text DNS record to respond as extra records.