##############################################

dnscrypt-proxy configuration

##############################################

This is an example configuration file.

You should adjust it to your needs, and save it as "dnscrypt-proxy.toml"

Online documentation is available here: https://dnscrypt.info/doc

##################################

Global settings

##################################

List of servers to use

Servers from the "public-resolvers" source (see down below) can

be viewed here: https://dnscrypt.info/public-servers

The proxy will automatically pick working servers from this list.

Note that the require_* filters do NOT apply when using this setting.

By default, this list is empty and all registered servers matching the

require_* filters will be used instead.

Remove the leading # first to enable this; lines starting with # are ignored.

server_names = ['acsacsar-ams-ipv4', 'arvind-io', 'bcn-dnscrypt', 'd0wn-tz-ns1', 'dnscrypt.be', 'dnscrypt.ca-1', 'dnscrypt.ca-2', 'dnscrypt.eu-dk', 'dnscrypt.eu-nl', 'dnscrypt.one', 'dnscrypt.pl', 'dnscrypt.uk-ipv4', 'ev-canada', 'jp.tiar.app', 'meganerd', 'moulticast-ca-ipv4', 'moulticast-de-ipv4', 'moulticast-fr-ipv4', 'moulticast-sg-ipv4', 'moulticast-uk-ipv4', 'plan9-dns', 'publicarray-au', 'pwoss.org-dnscrypt', 'sarpel-dns-istanbul', 'scaleway-ams', 'scaleway-fr', 'serbica', 'v.dnscrypt.uk-ipv4', 'ventricle.us', 'zackptg5-us-il-ipv4']

List of local addresses and ports to listen to. Can be IPv4 and/or IPv6.

Example with both IPv4 and IPv6:

listen_addresses = ['127.0.0.1:53', '[::1]:53']

To listen to all IPv4 addresses, use listen_addresses = ['0.0.0.0:53']

To listen to all IPv4+IPv6 addresses, use listen_addresses = ['[::]:53']

listen_addresses = ['127.0.0.1:5354']

Maximum number of simultaneous client connections to accept

max_clients = 250

Switch to a different system user after listening sockets have been created.

Note (1): this feature is currently unsupported on Windows.

Note (2): this feature is not compatible with systemd socket activation.

Note (3): when using -pidfile, the PID file directory must be writable by the new user

user_name = 'nobody'

Require servers (from static + remote sources) to satisfy specific properties

Use servers reachable over IPv4

ipv4_servers = true

Use servers reachable over IPv6 -- Do not enable if you don't have IPv6 connectivity

ipv6_servers = false

Use servers implementing the DNSCrypt protocol

dnscrypt_servers = true

Use servers implementing the DNS-over-HTTPS protocol

doh_servers = false

Require servers defined by remote sources to satisfy specific properties

Server must support DNS security extensions (DNSSEC)

require_dnssec = true

Server must not log user queries (declarative)

require_nolog = true

Server must not enforce its own blocklist (for parental control, ads blocking...)

require_nofilter = true

Server names to avoid even if they match all criteria

disabled_server_names = []

Always use TCP to connect to upstream servers.

This can be useful if you need to route everything through Tor.

Otherwise, leave this to false, as it doesn't improve security

(dnscrypt-proxy will always encrypt everything even using UDP), and can

only increase latency.

force_tcp = false

SOCKS proxy

Uncomment the following line to route all TCP connections to a local Tor node

Tor doesn't support UDP, so set force_tcp to true as well.

proxy = 'socks5://127.0.0.1:9050'

HTTP/HTTPS proxy

Only for DoH servers

http_proxy = 'http://127.0.0.1:8888'

How long a DNS query will wait for a response, in milliseconds.

If you have a network with a lot of latency, you may need to

increase this. Startup may be slower if you do so.

Don't increase it too much. 10000 is the highest reasonable value.

timeout = 1000

Keepalive for HTTP (HTTPS, HTTP/2) queries, in seconds

keepalive = 30

Add EDNS-client-subnet information to outgoing queries

Multiple networks can be listed; they will be randomly chosen.

These networks don't have to match your actual networks.

edns_client_subnet = ["0.0.0.0/0", "2001:db8::/32"]

Response for blocked queries. Options are refused, hinfo (default) or

an IP response. To give an IP response, use the format a:<IPv4>,aaaa:<IPv6>.

Using the hinfo option means that some responses will be lies.

Unfortunately, the hinfo option appears to be required for Android 8+

blocked_query_response = 'refused'

Load-balancing strategy: 'p2' (default), 'ph', 'p', 'first' or 'random'

Randomly choose 1 of the fastest 2, half, n, 1 or all live servers by latency.

The response quality still depends on the server itself.

lb_strategy = 'p2'

Set to true to constantly try to estimate the latency of all the resolvers

and adjust the load-balancing parameters accordingly, or to false to disable.

Default is true that makes 'p2' lb_strategy work well.

lb_estimator = true

Log level (0-6, default: 2 - 0 is very verbose, 6 only contains fatal errors)

log_level = 2

Log file for the application, as an alternative to sending logs to

the standard system logging service (syslog/Windows event log).

This file is different from other log files, and will not be

automatically rotated by the application.

log_file = 'dnscrypt-proxy.log'

When using a log file, only keep logs from the most recent launch.

log_file_latest = true

Use the system logger (syslog on Unix, Event Log on Windows)

use_syslog = true

Delay, in minutes, after which certificates are reloaded

cert_refresh_delay = 240

DNSCrypt: Create a new, unique key for every single DNS query

This may improve privacy but can also have a significant impact on CPU usage

Only enable if you don't have a lot of network load

dnscrypt_ephemeral_keys = true

DoH: Disable TLS session tickets - increases privacy but also latency

tls_disable_session_tickets = false

DoH: Use a specific cipher suite instead of the server preference

49199 = TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

49195 = TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

52392 = TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305

52393 = TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

4865 = TLS_AES_128_GCM_SHA256

4867 = TLS_CHACHA20_POLY1305_SHA256

On non-Intel CPUs such as MIPS routers and ARM systems (Android, Raspberry Pi...),

the following suite improves performance.

This may also help on Intel CPUs running 32-bit operating systems.

Keep tls_cipher_suite empty if you have issues fetching sources or

connecting to some DoH servers. Google and Cloudflare are fine with it.

tls_cipher_suite = [52392, 49199]

Fallback resolvers

These are normal, non-encrypted DNS resolvers, that will be only used

for one-shot queries when retrieving the initial resolvers list, and

only if the system DNS configuration doesn't work.

No user application queries will ever be leaked through these resolvers,

and they will not be used after IP addresses of resolvers URLs have been found.

They will never be used if lists have already been cached, and if stamps

don't include host names without IP addresses.

They will not be used if the configured system DNS works.

Resolvers supporting DNSSEC are recommended, and, if you are using

DoH, fallback resolvers should ideally be operated by a different entity than

the DoH servers you will be using, especially if you have IPv6 enabled.

People in China may need to use 114.114.114.114:53 here.

Other popular options include 8.8.8.8 and 1.1.1.1.

If more than one resolver is specified, they will be tried in sequence.

fallback_resolvers = ['91.239.100.100:53']

Always use the fallback resolver before the system DNS settings.

ignore_system_dns = true

Maximum time (in seconds) to wait for network connectivity before

initializing the proxy.

Useful if the proxy is automatically started at boot, and network

connectivity is not guaranteed to be immediately available.

Use 0 to not test for connectivity at all (not recommended),

and -1 to wait as much as possible.

netprobe_timeout = -1

Address and port to try initializing a connection to, just to check

if the network is up. It can be any address and any port, even if

there is nothing answering these on the other side. Just don't use

a local address, as the goal is to check for Internet connectivity.

On Windows, a datagram with a single, nul byte will be sent, only

when the system starts.

On other operating systems, the connection will be initialized

but nothing will be sent at all.

netprobe_address = '91.239.100.100:53'

Offline mode - Do not use any remote encrypted servers.

The proxy will remain fully functional to respond to queries that

plugins can handle directly (forwarding, cloaking, ...)

offline_mode = false

Additional data to attach to outgoing queries.

These strings will be added as TXT records to queries.

Do not use, except on servers explicitly asking for extra data

to be present.

encrypted-dns-server can be configured to use this for access control

in the [access_control] section

query_meta = ['key1:value1', 'key2:value2', 'token:MySecretToken']

Automatic log files rotation

Maximum log files size in MB - Set to 0 for unlimited.

log_files_max_size = 10

How long to keep backup files, in days

log_files_max_age = 7

Maximum log files backups to keep (or 0 to keep all backups)

log_files_max_backups = 1

#########################

Filters

#########################

Note: if you are using dnsmasq, disable the dnssec option in dnsmasq if you

configure dnscrypt-proxy to do any kind of filtering (including the filters

below and blocklists).

You can still choose resolvers that do DNSSEC validation.

Immediately respond to IPv6-related queries with an empty response

This makes things faster when there is no IPv6 connectivity, but can

also cause reliability issues with some stub resolvers.

block_ipv6 = true

Immediately respond to A and AAAA queries for host names without a domain name

block_unqualified = true

Immediately respond to queries for local zones instead of leaking them to

upstream resolvers (always causing errors or timeouts).

block_undelegated = true

TTL for synthetic responses sent when a request has been blocked (due to

IPv6 or blocklists).

reject_ttl = 600

##################################################################################

Route queries for specific domains to a dedicated set of servers

##################################################################################

See the example-forwarding-rules.txt file for an example

forwarding_rules = 'forwarding-rules.txt'

###############################

Cloaking rules

###############################

Cloaking returns a predefined address for a specific name.

In addition to acting as a HOSTS file, it can also return the IP address

of a different name. It will also do CNAME flattening.

See the example-cloaking-rules.txt file for an example

cloaking_rules = 'cloaking-rules.txt'

TTL used when serving entries in cloaking-rules.txt

cloak_ttl = 600

###########################

DNS cache

###########################

Enable a DNS cache to reduce latency and outgoing traffic

cache = true

Cache size

cache_size = 4096

Minimum TTL for cached entries

cache_min_ttl = 2400

Maximum TTL for cached entries

cache_max_ttl = 86400

Minimum TTL for negatively cached entries

cache_neg_min_ttl = 60

Maximum TTL for negatively cached entries

cache_neg_max_ttl = 600

########################################

Captive portal handling

########################################

[captive_portals]

A file that contains a set of names used by operating systems to

check for connectivity and captive portals, along with hard-coded

IP addresses to return.

map_file = 'example-captive-portals.txt'

##################################

Local DoH server

##################################

[local_doh]

dnscrypt-proxy can act as a local DoH server. By doing so, web browsers

requiring a direct connection to a DoH server in order to enable some

features will enable these, without bypassing your DNS proxy.

Addresses that the local DoH server should listen to

listen_addresses = ['127.0.0.1:3000']

Path of the DoH URL. This is not a file, but the part after the hostname

in the URL. By convention, /dns-query is frequently chosen.

For each listen_address the complete URL to access the server will be:

https://<listen_address><path> (ex: https://127.0.0.1/dns-query)

path = '/dns-query'

Certificate file and key - Note that the certificate has to be trusted.

See the documentation (wiki) for more information.

cert_file = 'localhost.pem'

cert_key_file = 'localhost.pem'

###############################

Query logging

###############################

Log client queries to a file

[query_log]

Path to the query log file (absolute, or relative to the same directory as the config file)

Can be set to /dev/stdout in order to log to the standard output.

file = 'query.log'

Query log format (currently supported: tsv and ltsv)

format = 'tsv'

Do not log these query types, to reduce verbosity. Keep empty to log everything.

ignored_qtypes = ['DNSKEY', 'NS']

############################################

Suspicious queries logging

############################################

Log queries for nonexistent zones

These queries can reveal the presence of malware, broken/obsolete applications,

and devices signaling their presence to 3rd parties.

[nx_log]

Path to the query log file (absolute, or relative to the same directory as the config file)

file = 'nx.log'

Query log format (currently supported: tsv and ltsv)

format = 'tsv'

######################################################

Pattern-based blocking (blocklists)

######################################################

Blocklists are made of one pattern per line. Example of valid patterns:

example.com

=example.com

sex

ads.*

ads*.example.*

ads*.example[0-9]*.com

Example blocklist files can be found at https://download.dnscrypt.info/blocklists/

A script to build blocklists from public feeds can be found in the

utils/generate-domains-blocklists directory of the dnscrypt-proxy source code.

[blocked_names]

Path to the file of blocking rules (absolute, or relative to the same directory as the config file)

blocked_names_file = 'blocked-names.txt'

Optional path to a file logging blocked queries

log_file = 'blocked-names.log'

Optional log format: tsv or ltsv (default: tsv)

log_format = 'tsv'

###########################################################

Pattern-based IP blocking (IP blocklists)

###########################################################

IP blocklists are made of one pattern per line. Example of valid patterns:

127.*

fe80🔡*

192.168.1.4

[blocked_ips]

Path to the file of blocking rules (absolute, or relative to the same directory as the config file)

blocked_ips_file = 'blocked-ips.txt'

Optional path to a file logging blocked queries

log_file = 'blocked-ips.log'

Optional log format: tsv or ltsv (default: tsv)

log_format = 'tsv'

######################################################

Pattern-based allow lists (blocklists bypass)

######################################################

Allowlists support the same patterns as blocklists

If a name matches an allowlist entry, the corresponding session

will bypass names and IP filters.

Time-based rules are also supported to make some websites only accessible at specific times of the day.

[allowed_names]

Path to the file of allow list rules (absolute, or relative to the same directory as the config file)

allowed_names_file = 'allowed-names.txt'

Optional path to a file logging allowed queries

log_file = 'allowed-names.log'

Optional log format: tsv or ltsv (default: tsv)

log_format = 'tsv'

#########################################################

Pattern-based allowed IPs lists (blocklists bypass)

#########################################################

Allowed IP lists support the same patterns as IP blocklists

If an IP response matches an allow ip entry, the corresponding session

will bypass IP filters.

Time-based rules are also supported to make some websites only accessible at specific times of the day.

[allowed_ips]

Path to the file of allowed ip rules (absolute, or relative to the same directory as the config file)

allowed_ips_file = 'allowed-ips.txt'

Optional path to a file logging allowed queries

log_file = 'allowed-ips.log'

Optional log format: tsv or ltsv (default: tsv)

log_format = 'tsv'

##########################################

Time access restrictions

##########################################

One or more weekly schedules can be defined here.

Patterns in the name-based blocked_names file can optionally be followed with @schedule_name

to apply the pattern 'schedule_name' only when it matches a time range of that schedule.

For example, the following rule in a blocklist file:

.youtube. @time-to-sleep

would block access to YouTube during the times defined by the 'time-to-sleep' schedule.

{after='21:00', before= '7:00'} matches 0:00-7:00 and 21:00-0:00

{after= '9:00', before='18:00'} matches 9:00-18:00

[schedules]

[schedules.'time-to-sleep']

mon = [{after='21:00', before='7:00'}]

tue = [{after='21:00', before='7:00'}]

wed = [{after='21:00', before='7:00'}]

thu = [{after='21:00', before='7:00'}]

fri = [{after='23:00', before='7:00'}]

sat = [{after='23:00', before='7:00'}]

sun = [{after='21:00', before='7:00'}]

[schedules.'work']

mon = [{after='9:00', before='18:00'}]

tue = [{after='9:00', before='18:00'}]

wed = [{after='9:00', before='18:00'}]

thu = [{after='9:00', before='18:00'}]

fri = [{after='9:00', before='17:00'}]

#########################

Servers

#########################

Remote lists of available servers

Multiple sources can be used simultaneously, but every source

requires a dedicated cache file.

Refer to the documentation for URLs of public sources.

A prefix can be prepended to server names in order to

avoid collisions if different sources share the same for

different servers. In that case, names listed in server_names

must include the prefixes.

If the urls property is missing, cache files and valid signatures

must already be present. This doesn't prevent these cache files from

expiring after refresh_delay hours.

Cache freshness is checked every 24 hours, so values for 'refresh_delay'

of less than 24 hours will have no effect.

A maximum delay of 168 hours (1 week) is imposed to ensure cache freshness.

[sources]

An example of a remote source from https://github.com/DNSCrypt/dnscrypt-resolvers

[sources.'public-resolvers'] urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v3/public-resolvers.md', 'https://download.dnscrypt.info/resolvers-list/v3/public-resolvers.md', 'https://ipv6.download.dnscrypt.info/resolvers-list/v3/public-resolvers.md', 'https://download.dnscrypt.net/resolvers-list/v3/public-resolvers.md'] cache_file = 'public-resolvers.md' minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3' refresh_delay = 72 prefix = ''

Anonymized DNS relays

[sources.'relays'] urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v3/relays.md', 'https://download.dnscrypt.info/resolvers-list/v3/relays.md', 'https://ipv6.download.dnscrypt.info/resolvers-list/v3/relays.md', 'https://download.dnscrypt.net/resolvers-list/v3/relays.md'] cache_file = 'relays.md' minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3' refresh_delay = 72 prefix = ''

Quad9 over DNSCrypt - https://quad9.net/

[sources.quad9-resolvers]

urls = ['https://www.quad9.net/quad9-resolvers.md']

minisign_key = 'RWQBphd2+f6eiAqBsvDZEBXBGHQBJfeG6G+wJPPKxCZMoEQYpmoysKUN'

cache_file = 'quad9-resolvers.md'

prefix = 'quad9-'

Another example source, with resolvers censoring some websites not appropriate for children

This is a subset of the public-resolvers list, so enabling both is useless

[sources.'parental-control']

urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v3/parental-control.md', 'https://download.dnscrypt.info/resolvers-list/v3/parental-control.md', 'https://ipv6.download.dnscrypt.info/resolvers-list/v3/parental-control.md', 'https://download.dnscrypt.net/resolvers-list/v3/parental-control.md']

cache_file = 'parental-control.md'

minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3'

#########################################

Servers with known bugs

#########################################

[broken_implementations]

Cisco servers currently cannot handle queries larger than 1472 bytes, and don't

truncate reponses larger than questions as expected by the DNSCrypt protocol.

This prevents large responses from being received over UDP and over relays.

Older versions of the dnsdist server software had a bug with queries larger

than 1500 bytes. This is fixed since dnsdist version 1.5.0, but

some server may still run an outdated version.

The list below enables workarounds to make non-relayed usage more reliable

until the servers are fixed.

fragments_blocked = ['cisco', 'cisco-ipv6', 'cisco-familyshield', 'cisco-familyshield-ipv6', 'cleanbrowsing-adult', 'cleanbrowsing-adult-ipv6', 'cleanbrowsing-family', 'cleanbrowsing-family-ipv6', 'cleanbrowsing-security', 'cleanbrowsing-security-ipv6']

#################################################################

Certificate-based client authentication for DoH

#################################################################

Use a X509 certificate to authenticate yourself when connecting to DoH servers.

This is only useful if you are operating your own, private DoH server(s).

'creds' maps servers to certificates, and supports multiple entries.

If you are not using the standard root CA, an optional "root_ca"

property set to the path to a root CRT file can be added to a server entry.

[doh_client_x509_auth]

creds = [

{ server_name='myserver', client_cert='client.crt', client_key='client.key' }

]

################################

Anonymized DNS

################################

[anonymized_dns]

Routes are indirect ways to reach DNSCrypt servers.

A route maps a server name ("server_name") to one or more relays that will be

used to connect to that server.

A relay can be specified as a DNS Stamp (either a relay stamp, or a

DNSCrypt stamp) or a server name.

The following example routes "example-server-1" via anon-example-1 or anon-example-2,

and "example-server-2" via the relay whose relay DNS stamp is

"sdns://gRIxMzcuNzQuMjIzLjIzNDo0NDM".

!!! THESE ARE JUST EXAMPLES !!!

Review the list of available relays from the "relays.md" file, and, for each

server you want to use, define the relays you want connections to go through.

Carefully choose relays and servers so that they are run by different entities.

"server_name" can also be set to "*" to define a default route, for all servers:

{ server_name='*', via=['anon-example-1', 'anon-example-2'] }

If a route is ["*"], the proxy automatically picks a relay on a distinct network.

{ server_name='', via=[''] } is also an option, but is likely to be suboptimal.

Manual selection is always recommended over automatic selection, so that you can

select (relay,server) pairs that work well and fit your own criteria (close by or

in different countries, operated by different entities, on distinct ISPs...)

routes = [ { server_name='acsacsar-ams-ipv4', via=['anon-meganerd', 'anon-scaleway-ams'] }, { server_name='arvind-io', via=['anon-arapurayil-in-ipv4', 'anon-tiarap'] }, { server_name='bcn-dnscrypt', via=['anon-kama', 'anon-scaleway'] }, { server_name='d0wn-tz-ns1', via=['anon-arapurayil-in-ipv4', 'anon-pwoss.org'] }, { server_name='dnscrypt.be', via=['anon-acsacsar-ams-ipv4', 'anon-scaleway'] }, { server_name='dnscrypt.ca-1', via=['anon-ev-canada', 'anon-zackptg5-us-il-ipv4'] }, { server_name='dnscrypt.ca-2', via=['anon-ev-canada', 'anon-zackptg5-us-il-ipv4'] }, { server_name='dnscrypt.eu-dk', via=['anon-meganerd', 'anon-scaleway-ams'] }, { server_name='dnscrypt.eu-nl', via=['anon-meganerd', 'anon-scaleway-ams'] }, { server_name='dnscrypt.one', via=['anon-pwoss.org', 'anon-serbica'] }, { server_name='dnscrypt.pl', via=['anon-dnscrypt.one', 'anon-pwoss.org'] }, { server_name='dnscrypt.uk-ipv4', via=['anon-kama', 'anon-scaleway'] }, { server_name='ev-canada', via=['anon-inconnu', 'anon-plan9-dns'] }, { server_name='jp.tiar.app', via=['anon-pwoss.org', 'anon-yepdns-sg-ipv4'] }, { server_name='meganerd', via=['anon-acsacsar-ams-ipv4', 'anon-scaleway-ams'] }, { server_name='moulticast-ca-ipv4', via=['anon-ev-canada', 'anon-zackptg5-us-il-ipv4'] }, { server_name='moulticast-de-ipv4', via=['anon-dnscrypt.one', 'anon-pwoss.org'] }, { server_name='moulticast-fr-ipv4', via=['anon-kama', 'anon-scaleway'] }, { server_name='moulticast-sg-ipv4', via=['anon-tiarap', 'anon-yepdns-sg-ipv4'] }, { server_name='moulticast-uk-ipv4', via=['anon-dnscrypt.uk-ipv4', 'anon-v.dnscrypt.uk-ipv4'] }, { server_name='plan9-dns', via=['anon-ev-canada', 'anon-zackptg5-us-il-ipv4'] }, { server_name='publicarray-au', via=['anon-arapurayil-in-ipv4', 'anon-tiarap'] }, { server_name='pwoss.org-dnscrypt', via=['anon-dnscrypt.one', 'anon-serbica'] }, { server_name='sarpel-dns-istanbul', via=['anon-bcn', 'anon-kama'] }, { server_name='scaleway-ams', via=['anon-acsacsar-ams-ipv4', 'anon-serbica'] }, { server_name='scaleway-fr', via=['anon-dnscrypt.uk-ipv4', 'anon-v.dnscrypt.uk-ipv4'] }, { server_name='serbica', via=['anon-acsacsar-ams-ipv4', 'anon-scaleway-ams'] }, { server_name='v.dnscrypt.uk-ipv4', via=['anon-meganerd', 'anon-scaleway'] }, { server_name='ventricle.us', via=['anon-inconnu', 'anon-zackptg5-us-il-ipv4'] }, { server_name='zackptg5-us-il-ipv4', via=['anon-inconnu', 'anon-plan9-dns'] }

{ server_name='example-server-2', via=['sdns://gRIxMzcuNzQuMjIzLjIzNDo0NDM'] }

]

Skip resolvers incompatible with anonymization instead of using them directly

skip_incompatible = true

If public server certificates for a non-conformant server cannot be

retrieved via a relay, try getting them directly. Actual queries

will then always go through relays.

direct_cert_fallback = false

###############################

DNS64

###############################

DNS64 is a mechanism for synthesizing AAAA records from A records.

It is used with an IPv6/IPv4 translator to enable client-server

communication between an IPv6-only client and an IPv4-only server,

without requiring any changes to either the IPv6 or the IPv4 node,

for the class of applications that work through NATs.

There are two options to synthesize such records:

Option 1: Using a set of static IPv6 prefixes;

Option 2: By discovering the IPv6 prefix from DNS64-enabled resolver.

If both options are configured - only static prefixes are used.

(Ref. RFC6147, RFC6052, RFC7050)

Do not enable unless you know what DNS64 is and why you need it, or else

you won't be able to connect to anything at all.

[dns64]

(Option 1) Static prefix(es) as Pref64::/n CIDRs.

prefix = ['64:ff9b::/96']

(Option 2) DNS64-enabled resolver(s) to discover Pref64::/n CIDRs.

These resolvers are used to query for Well-Known IPv4-only Name (WKN) "ipv4only.arpa." to discover only.

Set with your ISP's resolvers in case of custom prefixes (other than Well-Known Prefix 64:ff9b::/96).

IMPORTANT: Default resolvers listed below support Well-Known Prefix 64:ff9b::/96 only.

resolver = ['[2606:4700:4700::64]:53', '[2001:4860:4860::64]:53']

########################################

Static entries

########################################

Optional, local, static list of additional servers

Mostly useful for testing your own servers.

[static]

[static.'myserver']

stamp = 'sdns://AQcAAAAAAAAAAAAQMi5kbnNjcnlwdC1jZXJ0Lg'