Local DNS Mapping

Chute supports local-customized DNS mapping. It's equivalent to /etc/hosts, but with more powerful features, including wildcard, alias and assigning DNS server.

[Host]
abc.com = 1.2.3.4
*.dev = 6.7.8.9
foo.com = bar.com
bar.com = server:8.8.8.8

Note: The mapping lines described here are also accepted in a [DNS] section, next to the DNS server options. See DNS Section.

Wildcard

You can use * prefix to wildcard all sub-domains. Please note that Chute uses a simple string match. For example, *google.com will match google.com, foo.google.com and bargoogle.com. And *.google.com will not match google.com.

[Host]
*.dev = 6.7.8.9

Alias

It's equivalent to CNAME record.

[Host]
foo.com = bar.com

An A or AAAA lookup for the aliased name is answered with the target's addresses, so the client does not have to follow the alias itself. When the target has no address of the family that was asked for, the answer is empty rather than a record of the other family. Chute resolves the target when the rule is loaded; if it is not resolved yet, the answer is the CNAME record and the target is resolved for the next lookup.

Assigning DNS Server

You can assign a specified DNS server to one or more domains.

[Host]
bar.com = server:8.8.8.8

server: also accepts a DoH URL, so a specified DoH endpoint can be assigned to the domains directly.

[Host]
*.example.com = server:https://doh.example/dns-query

server: accepts a comma-separated list of servers; the first available entry is used.

[Host]
bar.com = server:8.8.8.8, 8.8.4.4

You can assign system DNS server to one or more domains. Chute will only use system DNS configuration to query these domains.

[Host]
devs = server:system

Since Chute has its own DNS client implementation, some hostnames may fail to resolve. You can use server:syslib to let system handle the lookup.

[Host]
Macbook = server:syslib

Assigning DoH Service

You can assign a specified DoH service to one or more domains.

[Host]
bar.com = doh:cloudflare

By default, all hostnames with suffix .local will be resolved by the system.

Assigning DoT Service

You can assign a specified DoT (DNS-over-TLS) service to one or more domains.

[Host]
bar.com = dot:dns.google

Assigning DoQ Service

You can assign a specified DoQ (DNS-over-QUIC) service to one or more domains.

[Host]
bar.com = doq:dns.adguard.com

Assigning DoH3 Service

You can assign a specified DoH3 (DNS-over-HTTP/3) service to one or more domains.

[Host]
bar.com = doh3:https://dns.google/dns-query

Combined Usage

All features can be used together. For example:

[Host]
*.dev = foo.com
*.bar.com = server:system
Macbook = server:syslib
*.foo.com = doh:cloudflare
*.local = dot:dns.google
api.internal = doq:dns.adguard.com