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

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 willnotmatch google.com.

[Host]
*.dev = 6.7.8.9

Alias

It's equivalent to CNAME record.

[Host]
foo.com = bar.com

Assigning DNS Server

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

[Host]
bar.com = server:8.8.8.8

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.

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