Permalink
851 lines (550 sloc)
26.9 KB
| ############################################## | |
| # # | |
| # 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 = ['scaleway-fr', 'google', 'yandex', 'cloudflare'] | |
| ## 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:53'] | |
| ## 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 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 = true | |
| # Use servers implementing the Oblivious DoH protocol | |
| odoh_servers = false | |
| ## Require servers defined by remote sources to satisfy specific properties | |
| # Server must support DNS security extensions (DNSSEC) | |
| require_dnssec = false | |
| # 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 = 5000 | |
| ## 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<n>', '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 = false | |
| ## 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] | |
| ## Bootstrap resolvers | |
| ## | |
| ## These are normal, non-encrypted DNS resolvers, that will be only used | |
| ## for one-shot queries when retrieving the initial resolvers list and the | |
| ## the system DNS configuration doesn't work. | |
| ## | |
| ## No user queries will ever be leaked through these resolvers, and they will | |
| ## not be used after IP addresses of DoH resolvers have been found (if you are | |
| ## using DoH). | |
| ## | |
| ## They will never be used if lists have already been cached, and if the stamps | |
| ## of the configured servers already include IP addresses (which is the case for | |
| ## most of DoH servers, and for all DNSCrypt servers and relays). | |
| ## | |
| ## They will not be used if the configured system DNS works, or after the | |
| ## proxy already has at least one usable secure resolver. | |
| ## | |
| ## Resolvers supporting DNSSEC are recommended, and, if you are using | |
| ## DoH, bootstrap 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 want to use 114.114.114.114:53 here. | |
| ## Other popular options include 8.8.8.8, 9.9.9.9 and 1.1.1.1. | |
| ## | |
| ## If more than one resolver is specified, they will be tried in sequence. | |
| ## | |
| ## TL;DR: put valid standard resolver addresses here. Your actual queries will | |
| ## not be sent there. If you're using DNSCrypt or Anonymized DNS and your | |
| ## lists are up to date, these resolvers will not even be used. | |
| bootstrap_resolvers = ['9.9.9.9:53', '8.8.8.8:53'] | |
| ## Always use the bootstrap 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 = 60 | |
| ## 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 = '9.9.9.9: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 = false | |
| ## 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 = 10 | |
| ################################################################################## | |
| # 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:abcd:* | |
| ## 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 = '' | |
| ## ODoH (Oblivious DoH) servers and relays | |
| # [sources.'odoh'] | |
| # urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v3/odoh.md', 'https://download.dnscrypt.info/resolvers-list/v3/odoh.md', 'https://ipv6.download.dnscrypt.info/resolvers-list/v3/odoh.md', 'https://download.dnscrypt.net/resolvers-list/v3/odoh.md'] | |
| # cache_file = 'odoh.md' | |
| # minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3' | |
| # refresh_delay = 24 | |
| # 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='*', 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='example-server-1', via=['anon-example-1', 'anon-example-2'] }, | |
| # { server_name='example-server-2', via=['sdns://gRIxMzcuNzQuMjIzLjIzNDo0NDM'] } | |
| # ] | |
| # Skip resolvers incompatible with anonymization instead of using them directly | |
| skip_incompatible = false | |
| # 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' |