Xray-docs-next/docs/en/config/outbounds/dns.md

37 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# DNS
DNS is an outbound protocol used for intercepting and forwarding DNS queries.
This outbound protocol can only handle DNS traffic, including queries based on UDP and TCP protocols. Other types of traffic will result in an error.
When handling DNS queries, this outbound protocol will forward IP queries (A and AAAA) to the built-in [DNS server](../dns.md). Other types of query traffic will be forwarded to their original destination addresses.
## OutboundConfigurationObject
```json
{
"network": "tcp",
"address": "1.1.1.1",
"port": 53,
"nonIPQuery": "drop"
}
```
> `network`: "tcp" | "udp"
Modifies the transport layer protocol for DNS traffic. The possible values are `"tcp"` and `"udp"`. When not specified, the original transport method will be retained.
> `address`: address
Modifies the DNS server address. When not specified, the original address specified in the source will be retained.
> `port`: number
Modifies the DNS server port. When not specified, the original port specified in the source will be retained.
> `nonIPQuery`: string
Control non IP queries (neither A or AAAA), `"drop"` this request or `"skip"` processing in DNS modulethe request will be forwarded to target. By default is `"drop"`.
## DNS Configuration Example <Badge text="WIP" type="warning"/>