2018-01-10 12:01:49 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
##############################################
|
|
|
|
# #
|
|
|
|
# dnscrypt-proxy configuration #
|
|
|
|
# #
|
|
|
|
##############################################
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-02-01 19:01:02 +01:00
|
|
|
## This is an example configuration file.
|
|
|
|
## You should adjust it to your needs, and save it as "dnscrypt-proxy.toml"
|
2018-02-06 14:27:36 +01:00
|
|
|
##
|
|
|
|
## Online documentation is available here: https://dnscrypt.info/doc
|
2018-02-01 19:01:02 +01:00
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
|
|
|
##################################
|
|
|
|
# Global settings #
|
|
|
|
##################################
|
2018-01-10 13:33:06 +01:00
|
|
|
|
|
|
|
## List of servers to use
|
2018-04-02 01:55:22 +02:00
|
|
|
##
|
|
|
|
## Servers from the "public-resolvers" source (see down below) can
|
|
|
|
## be viewed here: https://dnscrypt.info/public-servers
|
|
|
|
##
|
2020-02-26 08:04:28 +01:00
|
|
|
## 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.
|
2018-04-02 01:55:22 +02:00
|
|
|
##
|
2018-02-19 15:15:20 +01:00
|
|
|
## Remove the leading # first to enable this; lines starting with # are ignored.
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2020-04-01 12:22:34 +02:00
|
|
|
server_names = ['doh.nsa.gov']
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-30 15:58:13 +01:00
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
## List of local addresses and ports to listen to. Can be IPv4 and/or IPv6.
|
2019-11-24 10:31:40 +01:00
|
|
|
## Example with both IPv4 and IPv6:
|
|
|
|
## listen_addresses = ['127.0.0.1:53', '[::1]:53']
|
2018-01-24 15:23:03 +01:00
|
|
|
|
2019-11-24 10:31:40 +01:00
|
|
|
listen_addresses = ['127.0.0.1:53']
|
2018-01-10 12:01:49 +01:00
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-24 16:51:26 +01:00
|
|
|
## Maximum number of simultaneous client connections to accept
|
|
|
|
|
2018-01-30 15:58:13 +01:00
|
|
|
max_clients = 250
|
2018-01-24 16:51:26 +01:00
|
|
|
|
2018-06-13 16:52:41 +02:00
|
|
|
|
2018-10-03 16:35:59 +02:00
|
|
|
## Switch to a different system user after listening sockets have been created.
|
2018-07-07 17:21:21 +02:00
|
|
|
## Note (1): this feature is currently unsupported on Windows.
|
|
|
|
## Note (2): this feature is not compatible with systemd socket activation.
|
2018-10-03 18:17:39 +02:00
|
|
|
## Note (3): when using -pidfile, the PID file directory must be writable by the new user
|
2018-06-13 16:54:57 +02:00
|
|
|
|
2018-07-07 17:39:33 +02:00
|
|
|
# user_name = 'nobody'
|
2018-06-13 16:52:41 +02:00
|
|
|
|
2018-01-24 16:51:26 +01:00
|
|
|
|
2018-01-31 12:17:14 +01:00
|
|
|
## Require servers (from static + remote sources) to satisfy specific properties
|
2018-01-19 16:38:43 +01:00
|
|
|
|
|
|
|
# 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
|
|
|
|
|
2018-02-06 14:11:58 +01:00
|
|
|
# Use servers implementing the DNSCrypt protocol
|
|
|
|
dnscrypt_servers = true
|
|
|
|
|
|
|
|
# Use servers implementing the DNS-over-HTTPS protocol
|
|
|
|
doh_servers = true
|
|
|
|
|
2018-01-19 16:38:43 +01:00
|
|
|
|
2018-01-18 13:01:16 +01:00
|
|
|
## Require servers defined by remote sources to satisfy specific properties
|
|
|
|
|
2018-01-31 15:08:58 +01:00
|
|
|
# Server must support DNS security extensions (DNSSEC)
|
2018-01-18 13:01:16 +01:00
|
|
|
require_dnssec = false
|
|
|
|
|
2018-01-31 12:17:14 +01:00
|
|
|
# Server must not log user queries (declarative)
|
2018-01-18 13:04:50 +01:00
|
|
|
require_nolog = true
|
|
|
|
|
|
|
|
# Server must not enforce its own blacklist (for parental control, ads blocking...)
|
|
|
|
require_nofilter = true
|
2018-01-18 13:01:16 +01:00
|
|
|
|
2019-02-23 14:55:23 +01:00
|
|
|
# Server names to avoid even if they match all criteria
|
|
|
|
disabled_server_names = []
|
|
|
|
|
2018-01-18 13:01:16 +01:00
|
|
|
|
2018-04-20 23:17:29 +02:00
|
|
|
## Always use TCP to connect to upstream servers.
|
2018-10-29 14:16:02 +01:00
|
|
|
## This can be useful if you need to route everything through Tor.
|
2018-04-20 23:17:29 +02:00
|
|
|
## 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.
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-10 12:01:49 +01:00
|
|
|
force_tcp = false
|
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-11-15 18:47:33 +01:00
|
|
|
## SOCKS proxy
|
2018-06-06 15:54:51 +02:00
|
|
|
## 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.
|
|
|
|
|
2019-08-04 09:04:01 +02:00
|
|
|
# proxy = 'socks5://127.0.0.1:9050'
|
2018-06-06 15:54:51 +02:00
|
|
|
|
|
|
|
|
2018-11-15 18:47:33 +01:00
|
|
|
## HTTP/HTTPS proxy
|
|
|
|
## Only for DoH servers
|
|
|
|
|
2019-08-04 09:04:01 +02:00
|
|
|
# http_proxy = 'http://127.0.0.1:8888'
|
2018-11-15 18:47:33 +01:00
|
|
|
|
2018-06-06 15:54:51 +02:00
|
|
|
|
2019-10-20 19:30:33 +02:00
|
|
|
## 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.
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2019-10-20 19:22:02 +02:00
|
|
|
timeout = 5000
|
2018-01-10 12:01:49 +01:00
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-04-02 01:49:09 +02:00
|
|
|
## Keepalive for HTTP (HTTPS, HTTP/2) queries, in seconds
|
|
|
|
|
2018-04-09 23:58:36 +02:00
|
|
|
keepalive = 30
|
2018-04-02 01:49:09 +02:00
|
|
|
|
|
|
|
|
2019-06-19 18:11:06 +02:00
|
|
|
## Response for blocked queries. Options are `refused`, `hinfo` (default) or
|
2019-07-14 19:46:11 +02:00
|
|
|
## 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+
|
2019-02-23 12:34:59 +01:00
|
|
|
|
2019-06-19 18:11:06 +02:00
|
|
|
# blocked_query_response = 'refused'
|
2019-06-09 21:15:38 +02:00
|
|
|
|
2019-02-23 12:34:59 +01:00
|
|
|
|
2019-06-02 13:24:24 +02:00
|
|
|
## Load-balancing strategy: 'p2' (default), 'ph', 'first' or 'random'
|
2018-02-04 21:23:39 +01:00
|
|
|
|
|
|
|
# lb_strategy = 'p2'
|
|
|
|
|
2019-06-03 13:04:34 +02:00
|
|
|
## 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.
|
|
|
|
|
|
|
|
# lb_estimator = true
|
|
|
|
|
2018-02-04 21:23:39 +01:00
|
|
|
|
2018-01-30 15:46:21 +01:00
|
|
|
## Log level (0-6, default: 2 - 0 is very verbose, 6 only contains fatal errors)
|
2018-01-19 20:06:04 +01:00
|
|
|
|
|
|
|
# log_level = 2
|
|
|
|
|
|
|
|
|
2018-01-30 15:46:21 +01:00
|
|
|
## log file for the application
|
2018-01-19 20:06:04 +01:00
|
|
|
|
2018-01-20 13:20:30 +01:00
|
|
|
# log_file = 'dnscrypt-proxy.log'
|
2018-01-19 20:06:04 +01:00
|
|
|
|
|
|
|
|
2018-01-30 15:46:21 +01:00
|
|
|
## Use the system logger (syslog on Unix, Event Log on Windows)
|
2018-01-19 20:06:04 +01:00
|
|
|
|
|
|
|
# use_syslog = true
|
|
|
|
|
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
## Delay, in minutes, after which certificates are reloaded
|
|
|
|
|
2018-01-31 00:21:25 +01:00
|
|
|
cert_refresh_delay = 240
|
2018-01-10 12:01:49 +01:00
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-04-09 03:12:34 +02:00
|
|
|
## 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
|
|
|
|
|
|
|
|
|
2018-04-09 23:58:36 +02:00
|
|
|
## DoH: Disable TLS session tickets - increases privacy but also latency
|
2018-04-07 22:23:29 +02:00
|
|
|
|
2018-04-07 22:26:46 +02:00
|
|
|
# tls_disable_session_tickets = false
|
2018-04-07 22:23:29 +02:00
|
|
|
|
|
|
|
|
2018-04-09 12:09:01 +02:00
|
|
|
## DoH: Use a specific cipher suite instead of the server preference
|
2018-04-07 22:23:29 +02:00
|
|
|
## 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
|
2019-06-07 01:39:35 +02:00
|
|
|
## 4865 = TLS_AES_128_GCM_SHA256
|
|
|
|
## 4867 = TLS_CHACHA20_POLY1305_SHA256
|
2018-04-07 23:05:29 +02:00
|
|
|
##
|
2018-04-10 11:28:59 +02:00
|
|
|
## On non-Intel CPUs such as MIPS routers and ARM systems (Android, Raspberry Pi...),
|
2018-04-11 14:03:25 +02:00
|
|
|
## the following suite improves performance.
|
2018-04-10 11:28:59 +02:00
|
|
|
## This may also help on Intel CPUs running 32-bit operating systems.
|
2018-04-09 12:09:01 +02:00
|
|
|
##
|
2018-04-16 02:25:59 +02:00
|
|
|
## Keep tls_cipher_suite empty if you have issues fetching sources or
|
2018-04-11 11:42:10 +02:00
|
|
|
## connecting to some DoH servers. Google and Cloudflare are fine with it.
|
2018-04-07 22:23:29 +02:00
|
|
|
|
2018-04-11 14:03:25 +02:00
|
|
|
# tls_cipher_suite = [52392, 49199]
|
2018-04-07 22:23:29 +02:00
|
|
|
|
|
|
|
|
2020-01-15 19:58:14 +01:00
|
|
|
## Fallback resolvers
|
|
|
|
## These are normal, non-encrypted DNS resolvers, that will be only used
|
2018-01-30 15:46:21 +01:00
|
|
|
## for one-shot queries when retrieving the initial resolvers list, and
|
|
|
|
## only if the system DNS configuration doesn't work.
|
2020-01-15 19:58:14 +01:00
|
|
|
## 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
|
2018-01-30 15:58:13 +01:00
|
|
|
## don't include host names without IP addresses.
|
2020-01-15 19:58:14 +01:00
|
|
|
## They will not be used if the configured system DNS works.
|
2020-02-14 15:17:28 +01:00
|
|
|
## Resolvers supporting DNSSEC are recommended.
|
2018-03-22 07:44:06 +01:00
|
|
|
##
|
|
|
|
## People in China may need to use 114.114.114.114:53 here.
|
2018-03-30 22:24:19 +02:00
|
|
|
## Other popular options include 8.8.8.8 and 1.1.1.1.
|
2020-01-15 19:58:14 +01:00
|
|
|
##
|
2020-02-14 15:17:28 +01:00
|
|
|
## If more than one resolver is specified, they will be tried in sequence.
|
2018-01-30 15:46:21 +01:00
|
|
|
|
2020-01-15 19:58:14 +01:00
|
|
|
fallback_resolvers = ['9.9.9.9:53', '8.8.8.8:53']
|
2018-01-30 15:46:21 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Always use the fallback resolver before the system DNS settings.
|
2018-01-30 17:37:35 +01:00
|
|
|
|
2019-11-17 20:30:04 +01:00
|
|
|
ignore_system_dns = true
|
2018-01-30 17:37:35 +01:00
|
|
|
|
2018-01-30 15:58:13 +01:00
|
|
|
|
2018-05-10 22:19:04 +02:00
|
|
|
## 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.
|
2019-06-07 01:50:03 +02:00
|
|
|
## Use 0 to not test for connectivity at all (not recommended),
|
2019-05-28 13:22:11 +02:00
|
|
|
## and -1 to wait as much as possible.
|
2019-05-31 23:02:45 +02:00
|
|
|
|
2018-11-22 17:24:41 +01:00
|
|
|
netprobe_timeout = 60
|
2018-05-10 21:59:25 +02:00
|
|
|
|
2019-05-31 23:02:45 +02:00
|
|
|
## 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.
|
|
|
|
|
2019-08-04 09:04:01 +02:00
|
|
|
netprobe_address = '9.9.9.9:53'
|
2019-05-31 23:02:45 +02:00
|
|
|
|
2018-05-10 21:59:25 +02:00
|
|
|
|
2018-07-05 18:05:24 +02:00
|
|
|
## 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
|
|
|
|
|
|
|
|
|
2019-09-07 16:19:47 +02:00
|
|
|
## 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.
|
2020-03-20 21:09:34 +01:00
|
|
|
## encrypted-dns-server can be configured to use this for access control
|
|
|
|
## in the [access_control] section
|
2019-09-07 16:19:47 +02:00
|
|
|
|
2020-03-20 21:09:34 +01:00
|
|
|
# query_meta = ["key1:value1", "key2:value2", "token:MySecretToken"]
|
2019-09-07 16:19:47 +02:00
|
|
|
|
|
|
|
|
2018-03-02 10:38:31 +01:00
|
|
|
## Automatic log files rotation
|
|
|
|
|
2019-09-23 10:33:57 +02:00
|
|
|
# Maximum log files size in MB - Set to 0 for unlimited.
|
2018-03-02 10:38:31 +01:00
|
|
|
log_files_max_size = 10
|
|
|
|
|
2018-03-11 16:15:02 +01:00
|
|
|
# How long to keep backup files, in days
|
2018-03-02 10:38:31 +01:00
|
|
|
log_files_max_age = 7
|
|
|
|
|
2018-03-28 00:14:07 +02:00
|
|
|
# Maximum log files backups to keep (or 0 to keep all backups)
|
2018-03-02 10:49:21 +01:00
|
|
|
log_files_max_backups = 1
|
2018-03-02 10:38:31 +01:00
|
|
|
|
|
|
|
|
2018-01-30 17:43:15 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
#########################
|
|
|
|
# Filters #
|
|
|
|
#########################
|
2018-01-10 17:23:20 +01:00
|
|
|
|
2019-12-16 17:23:22 +01:00
|
|
|
## 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 blacklists).
|
2020-02-26 08:08:36 +01:00
|
|
|
## You can still choose resolvers that do DNSSEC validation.
|
2019-12-16 17:23:22 +01:00
|
|
|
|
|
|
|
|
2018-01-10 17:23:20 +01:00
|
|
|
## Immediately respond to IPv6-related queries with an empty response
|
2018-01-21 00:54:20 +01:00
|
|
|
## This makes things faster when there is no IPv6 connectivity, but can
|
2018-05-10 10:46:11 +02:00
|
|
|
## also cause reliability issues with some stub resolvers.
|
2018-01-10 17:23:20 +01:00
|
|
|
|
|
|
|
block_ipv6 = false
|
|
|
|
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2019-12-09 20:25:38 +01:00
|
|
|
## Immediately respond to A and AAAA queries for host names without a domain name
|
|
|
|
|
|
|
|
block_unqualified = true
|
|
|
|
|
|
|
|
|
2019-12-16 16:13:18 +01:00
|
|
|
## Immediately respond to queries for local zones instead of leaking them to
|
|
|
|
## upstream resolvers (always causing errors or timeouts).
|
|
|
|
|
|
|
|
block_undelegated = true
|
|
|
|
|
|
|
|
|
2019-10-21 18:26:49 +02:00
|
|
|
## TTL for synthetic responses sent when a request has been blocked (due to
|
|
|
|
## IPv6 or blacklists).
|
|
|
|
|
|
|
|
reject_ttl = 600
|
|
|
|
|
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
|
|
|
##################################################################################
|
|
|
|
# Route queries for specific domains to a dedicated set of servers #
|
|
|
|
##################################################################################
|
|
|
|
|
2020-02-05 12:17:14 +01:00
|
|
|
## See the `example-forwarding-rules.txt` file for an example
|
2018-01-16 00:23:16 +01:00
|
|
|
|
2018-01-18 20:41:33 +01:00
|
|
|
# forwarding_rules = 'forwarding-rules.txt'
|
2018-01-17 02:40:47 +01:00
|
|
|
|
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-02-04 01:43:37 +01:00
|
|
|
###############################
|
|
|
|
# Cloaking rules #
|
|
|
|
###############################
|
|
|
|
|
2018-02-04 01:57:18 +01:00
|
|
|
## 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.
|
2018-02-04 01:43:37 +01:00
|
|
|
##
|
2020-02-05 12:17:14 +01:00
|
|
|
## See the `example-cloaking-rules.txt` file for an example
|
2018-02-04 01:43:37 +01:00
|
|
|
|
|
|
|
# cloaking_rules = 'cloaking-rules.txt'
|
|
|
|
|
2019-10-17 16:19:07 +02:00
|
|
|
## TTL used when serving entries in cloaking-rules.txt
|
|
|
|
|
|
|
|
# cloak_ttl = 600
|
2018-02-04 01:43:37 +01:00
|
|
|
|
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
###########################
|
|
|
|
# DNS cache #
|
|
|
|
###########################
|
2018-01-10 18:32:05 +01:00
|
|
|
|
2018-01-23 15:51:57 +01:00
|
|
|
## Enable a DNS cache to reduce latency and outgoing traffic
|
2018-01-10 18:32:05 +01:00
|
|
|
|
|
|
|
cache = true
|
|
|
|
|
|
|
|
|
2018-01-10 19:32:56 +01:00
|
|
|
## Cache size
|
|
|
|
|
2020-01-30 15:08:23 +01:00
|
|
|
cache_size = 4096
|
2018-01-10 19:32:56 +01:00
|
|
|
|
|
|
|
|
|
|
|
## Minimum TTL for cached entries
|
|
|
|
|
2019-11-03 17:31:41 +01:00
|
|
|
cache_min_ttl = 2400
|
2018-01-10 19:32:56 +01:00
|
|
|
|
|
|
|
|
2018-02-26 19:38:02 +01:00
|
|
|
## Maximum TTL for cached entries
|
2018-01-10 19:32:56 +01:00
|
|
|
|
|
|
|
cache_max_ttl = 86400
|
|
|
|
|
|
|
|
|
2018-04-17 00:24:49 +02:00
|
|
|
## Minimum TTL for negatively cached entries
|
2018-01-10 19:32:56 +01:00
|
|
|
|
2018-04-17 00:24:49 +02:00
|
|
|
cache_neg_min_ttl = 60
|
|
|
|
|
|
|
|
|
|
|
|
## Maximum TTL for negatively cached entries
|
|
|
|
|
|
|
|
cache_neg_max_ttl = 600
|
2018-01-10 19:32:56 +01:00
|
|
|
|
|
|
|
|
2018-01-30 15:58:13 +01:00
|
|
|
|
2019-11-28 17:04:29 +01:00
|
|
|
##################################
|
|
|
|
# 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
|
2019-11-29 13:42:35 +01:00
|
|
|
## features will enable these, without bypassing your DNS proxy.
|
2019-11-28 17:04:29 +01:00
|
|
|
|
|
|
|
## Addresses that the local DoH server should listen to
|
|
|
|
|
|
|
|
# listen_addresses = ['127.0.0.1:3000']
|
|
|
|
|
|
|
|
|
2019-11-29 13:42:35 +01:00
|
|
|
## 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`)
|
2019-11-28 23:49:28 +01:00
|
|
|
|
|
|
|
# path = "/dns-query"
|
|
|
|
|
|
|
|
|
2019-11-28 17:04:29 +01:00
|
|
|
## Certificate file and key - Note that the certificate has to be trusted.
|
2019-12-01 23:36:32 +01:00
|
|
|
## See the documentation (wiki) for more information.
|
2019-11-28 17:04:29 +01:00
|
|
|
|
|
|
|
# cert_file = "localhost.pem"
|
|
|
|
# cert_key_file = "localhost.pem"
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
###############################
|
|
|
|
# Query logging #
|
|
|
|
###############################
|
|
|
|
|
|
|
|
## Log client queries to a file
|
2018-01-17 09:44:03 +01:00
|
|
|
|
|
|
|
[query_log]
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Path to the query log file (absolute, or relative to the same directory as the config file)
|
2020-02-26 08:08:36 +01:00
|
|
|
## On non-Windows systems, can be /dev/stdout to log to the standard output (also set log_files_max_size to 0)
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# file = 'query.log'
|
2018-01-17 09:44:03 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Query log format (currently supported: tsv and ltsv)
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
format = 'tsv'
|
2018-01-17 09:44:03 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Do not log these query types, to reduce verbosity. Keep empty to log everything.
|
2018-01-19 12:57:47 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# ignored_qtypes = ['DNSKEY', 'NS']
|
2018-01-19 12:57:47 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-01-31 12:17:14 +01:00
|
|
|
|
2018-01-20 16:59:40 +01:00
|
|
|
############################################
|
|
|
|
# Suspicious queries logging #
|
|
|
|
############################################
|
|
|
|
|
|
|
|
## Log queries for nonexistent zones
|
2018-01-31 12:17:14 +01:00
|
|
|
## These queries can reveal the presence of malware, broken/obsolete applications,
|
|
|
|
## and devices signaling their presence to 3rd parties.
|
2018-01-20 16:59:40 +01:00
|
|
|
|
|
|
|
[nx_log]
|
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Path to the query log file (absolute, or relative to the same directory as the config file)
|
2018-01-20 16:59:40 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# file = 'nx.log'
|
2018-01-20 16:59:40 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Query log format (currently supported: tsv and ltsv)
|
2018-01-20 16:59:40 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
format = 'tsv'
|
2018-01-20 16:59:40 +01:00
|
|
|
|
|
|
|
|
2018-01-30 15:58:13 +01:00
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
######################################################
|
|
|
|
# Pattern-based blocking (blacklists) #
|
|
|
|
######################################################
|
|
|
|
|
|
|
|
## Blacklists are made of one pattern per line. Example of valid patterns:
|
2018-01-17 16:06:30 +01:00
|
|
|
##
|
2018-01-17 09:50:21 +01:00
|
|
|
## example.com
|
2018-04-09 13:02:42 +02:00
|
|
|
## =example.com
|
2018-01-17 09:50:21 +01:00
|
|
|
## *sex*
|
|
|
|
## ads.*
|
|
|
|
## ads*.example.*
|
|
|
|
## ads*.example[0-9]*.com
|
2018-01-31 12:17:14 +01:00
|
|
|
##
|
|
|
|
## Example blacklist files can be found at https://download.dnscrypt.info/blacklists/
|
|
|
|
## A script to build blacklists from public feeds can be found in the
|
|
|
|
## `utils/generate-domains-blacklists` directory of the dnscrypt-proxy source code.
|
2018-01-17 09:44:03 +01:00
|
|
|
|
2018-01-17 17:03:42 +01:00
|
|
|
[blacklist]
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Path to the file of blocking rules (absolute, or relative to the same directory as the config file)
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# blacklist_file = 'blacklist.txt'
|
2018-01-17 17:03:42 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Optional path to a file logging blocked queries
|
2018-01-17 17:03:42 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# log_file = 'blocked.log'
|
2018-01-17 17:03:42 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Optional log format: tsv or ltsv (default: tsv)
|
2018-01-17 17:03:42 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# log_format = 'tsv'
|
2018-01-17 09:50:21 +01:00
|
|
|
|
2018-01-17 09:44:03 +01:00
|
|
|
|
|
|
|
|
2018-01-21 16:07:44 +01:00
|
|
|
###########################################################
|
|
|
|
# Pattern-based IP blocking (IP blacklists) #
|
|
|
|
###########################################################
|
|
|
|
|
|
|
|
## IP blacklists are made of one pattern per line. Example of valid patterns:
|
|
|
|
##
|
|
|
|
## 127.*
|
|
|
|
## fe80:abcd:*
|
|
|
|
## 192.168.1.4
|
|
|
|
|
|
|
|
[ip_blacklist]
|
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Path to the file of blocking rules (absolute, or relative to the same directory as the config file)
|
2018-01-21 16:07:44 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# blacklist_file = 'ip-blacklist.txt'
|
2018-01-21 16:07:44 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Optional path to a file logging blocked queries
|
2018-01-21 16:07:44 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# log_file = 'ip-blocked.log'
|
2018-01-21 16:07:44 +01:00
|
|
|
|
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
## Optional log format: tsv or ltsv (default: tsv)
|
2018-01-21 16:07:44 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# log_format = 'tsv'
|
2018-01-21 16:07:44 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-04-07 23:02:40 +02:00
|
|
|
######################################################
|
|
|
|
# Pattern-based whitelisting (blacklists bypass) #
|
|
|
|
######################################################
|
|
|
|
|
|
|
|
## Whitelists support the same patterns as blacklists
|
|
|
|
## If a name matches a whitelist 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.
|
|
|
|
|
|
|
|
[whitelist]
|
|
|
|
|
2019-12-15 03:24:46 +01:00
|
|
|
## Path to the file of whitelisting rules (absolute, or relative to the same directory as the config file)
|
2018-04-07 23:02:40 +02:00
|
|
|
|
|
|
|
# whitelist_file = 'whitelist.txt'
|
|
|
|
|
|
|
|
|
|
|
|
## Optional path to a file logging whitelisted queries
|
|
|
|
|
|
|
|
# log_file = 'whitelisted.log'
|
|
|
|
|
|
|
|
|
|
|
|
## Optional log format: tsv or ltsv (default: tsv)
|
|
|
|
|
|
|
|
# log_format = 'tsv'
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-02-06 16:11:53 +01:00
|
|
|
##########################################
|
|
|
|
# Time access restrictions #
|
|
|
|
##########################################
|
|
|
|
|
|
|
|
## One or more weekly schedules can be defined here.
|
|
|
|
## Patterns in the name-based blocklist 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 blacklist file:
|
|
|
|
## *.youtube.* @time-to-sleep
|
2020-02-26 08:08:36 +01:00
|
|
|
## would block access to YouTube during the times defined by the 'time-to-sleep' schedule.
|
2018-02-06 16:11:53 +01:00
|
|
|
##
|
|
|
|
## {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'}]
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-01-17 09:50:21 +01:00
|
|
|
#########################
|
|
|
|
# Servers #
|
|
|
|
#########################
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-14 00:24:05 +01:00
|
|
|
## Remote lists of available servers
|
2018-01-31 12:17:14 +01:00
|
|
|
## Multiple sources can be used simultaneously, but every source
|
2018-02-06 14:27:36 +01:00
|
|
|
## requires a dedicated cache file.
|
|
|
|
##
|
|
|
|
## Refer to the documentation for URLs of public sources.
|
2018-01-31 12:17:14 +01:00
|
|
|
##
|
2018-02-01 08:51:29 +01:00
|
|
|
## A prefix can be prepended to server names in order to
|
2018-01-31 12:17:14 +01:00
|
|
|
## avoid collisions if different sources share the same for
|
|
|
|
## different servers. In that case, names listed in `server_names`
|
|
|
|
## must include the prefixes.
|
2018-02-24 19:35:37 +01:00
|
|
|
##
|
2018-03-28 13:36:19 +02:00
|
|
|
## If the `urls` property is missing, cache files and valid signatures
|
2020-02-26 08:08:36 +01:00
|
|
|
## must already be present. This doesn't prevent these cache files from
|
2018-02-26 19:05:12 +01:00
|
|
|
## expiring after `refresh_delay` hours.
|
2018-01-14 00:24:05 +01:00
|
|
|
|
2018-01-13 23:52:44 +01:00
|
|
|
[sources]
|
2018-01-31 00:37:56 +01:00
|
|
|
|
2018-04-02 01:55:22 +02:00
|
|
|
## An example of a remote source from https://github.com/DNSCrypt/dnscrypt-resolvers
|
2018-01-31 12:17:14 +01:00
|
|
|
|
2018-01-25 15:17:46 +01:00
|
|
|
[sources.'public-resolvers']
|
2018-03-28 13:36:19 +02:00
|
|
|
urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v2/public-resolvers.md', 'https://download.dnscrypt.info/resolvers-list/v2/public-resolvers.md']
|
2018-01-25 15:17:46 +01:00
|
|
|
cache_file = 'public-resolvers.md'
|
2018-01-27 19:46:50 +01:00
|
|
|
minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3'
|
2018-01-20 16:59:40 +01:00
|
|
|
prefix = ''
|
2018-01-13 23:52:44 +01:00
|
|
|
|
2019-10-18 15:53:56 +02:00
|
|
|
## Anonymized DNS relays
|
|
|
|
|
|
|
|
[sources.'relays']
|
2019-11-10 13:48:21 +01:00
|
|
|
urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v2/relays.md', 'https://download.dnscrypt.info/resolvers-list/v2/relays.md']
|
2019-10-18 15:53:56 +02:00
|
|
|
cache_file = 'relays.md'
|
|
|
|
minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3'
|
|
|
|
refresh_delay = 72
|
|
|
|
prefix = ''
|
|
|
|
|
2018-10-10 16:32:39 +02:00
|
|
|
## Quad9 over DNSCrypt - https://quad9.net/
|
|
|
|
|
|
|
|
# [sources.quad9-resolvers]
|
2019-08-04 09:04:01 +02:00
|
|
|
# urls = ['https://www.quad9.net/quad9-resolvers.md']
|
|
|
|
# minisign_key = 'RWQBphd2+f6eiAqBsvDZEBXBGHQBJfeG6G+wJPPKxCZMoEQYpmoysKUN'
|
|
|
|
# cache_file = 'quad9-resolvers.md'
|
|
|
|
# prefix = 'quad9-'
|
2018-10-10 16:32:39 +02:00
|
|
|
|
2018-02-26 19:38:02 +01:00
|
|
|
## Another example source, with resolvers censoring some websites not appropriate for children
|
2018-02-01 09:00:28 +01:00
|
|
|
## This is a subset of the `public-resolvers` list, so enabling both is useless
|
2018-01-31 12:17:14 +01:00
|
|
|
|
2018-02-01 09:00:28 +01:00
|
|
|
# [sources.'parental-control']
|
2018-03-28 13:36:19 +02:00
|
|
|
# urls = ['https://raw.githubusercontent.com/DNSCrypt/dnscrypt-resolvers/master/v2/parental-control.md', 'https://download.dnscrypt.info/resolvers-list/v2/parental-control.md']
|
2018-02-01 09:00:28 +01:00
|
|
|
# cache_file = 'parental-control.md'
|
|
|
|
# minisign_key = 'RWQf6LRCGA9i53mlYecO4IzT51TGPpvWucNSCh1CBM0QTaLn73Y7GFO3'
|
2018-01-14 00:24:05 +01:00
|
|
|
|
2018-01-31 20:07:52 +01:00
|
|
|
|
2019-11-16 18:51:16 +01:00
|
|
|
|
|
|
|
#########################################
|
|
|
|
# Servers with known bugs #
|
|
|
|
#########################################
|
|
|
|
|
|
|
|
[broken_implementations]
|
|
|
|
|
2019-11-17 15:07:40 +01:00
|
|
|
# Cisco servers currently cannot handle queries larger than 1472 bytes, and don't
|
|
|
|
# truncate reponses larger than questions as expected by the DNSCrypt protocol.
|
2020-03-26 10:57:09 +01:00
|
|
|
# This prevents large responses from being received over UDP and over relays.
|
|
|
|
#
|
2020-03-26 17:25:52 +01:00
|
|
|
# The `dnsdist` server software drops client queries larger than 1500 bytes.
|
2020-03-26 17:20:34 +01:00
|
|
|
# They are aware of it and are working on a fix.
|
2020-03-26 10:57:09 +01:00
|
|
|
#
|
|
|
|
# The list below enables workarounds to make non-relayed usage more reliable
|
|
|
|
# until the servers are fixed.
|
|
|
|
|
2020-03-26 12:31:12 +01:00
|
|
|
fragments_blocked = ['cisco', 'cisco-ipv6', 'cisco-familyshield', 'cisco-familyshield-ipv6', 'quad9-dnscrypt-ip4-filter-alt', 'quad9-dnscrypt-ip4-filter-pri', 'quad9-dnscrypt-ip4-nofilter-alt', 'quad9-dnscrypt-ip4-nofilter-pri', 'quad9-dnscrypt-ip6-filter-alt', 'quad9-dnscrypt-ip6-filter-pri', 'quad9-dnscrypt-ip6-nofilter-alt', 'quad9-dnscrypt-ip6-nofilter-pri', 'cleanbrowsing-adult', 'cleanbrowsing-family-ipv6', 'cleanbrowsing-family', 'cleanbrowsing-security']
|
2019-11-16 18:51:16 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
2020-03-26 13:41:57 +01:00
|
|
|
|
2020-03-09 22:14:31 +01:00
|
|
|
################################
|
|
|
|
# TLS Client Authentication #
|
|
|
|
################################
|
|
|
|
|
2020-03-24 14:32:23 +01:00
|
|
|
# This is only useful if you are operating your own, private DoH server(s).
|
|
|
|
# (for DNSCrypt, see the `query_meta` feature instead)
|
|
|
|
|
2020-03-09 22:14:31 +01:00
|
|
|
[tls_client_auth]
|
|
|
|
|
|
|
|
# creds = [
|
2020-03-24 14:32:23 +01:00
|
|
|
# { server_name='myserver', client_cert='client.crt', client_key='client.key' }
|
2020-03-09 22:14:31 +01:00
|
|
|
# ]
|
|
|
|
|
|
|
|
|
2019-11-16 18:51:16 +01:00
|
|
|
|
2019-10-14 12:08:47 +02:00
|
|
|
################################
|
|
|
|
# Anonymized DNS #
|
|
|
|
################################
|
|
|
|
|
|
|
|
[anonymized_dns]
|
|
|
|
|
2019-10-20 14:19:21 +02:00
|
|
|
## 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.
|
|
|
|
##
|
2019-10-14 12:08:47 +02:00
|
|
|
## A relay can be specified as a DNS Stamp (either a relay stamp, or a
|
2019-10-20 14:19:21 +02:00
|
|
|
## DNSCrypt stamp), an IP:port, a hostname:port, or a server name.
|
|
|
|
##
|
2019-12-15 03:24:46 +01:00
|
|
|
## The following example routes "example-server-1" via `anon-example-1` or `anon-example-2`,
|
2019-10-27 23:36:08 +01:00
|
|
|
## and "example-server-2" via the relay whose relay DNS stamp
|
2019-10-20 14:19:21 +02:00
|
|
|
## is "sdns://gRIxMzcuNzQuMjIzLjIzNDo0NDM".
|
2019-10-27 23:36:08 +01:00
|
|
|
##
|
|
|
|
## !!! THESE ARE JUST EXAMPLES !!!
|
|
|
|
##
|
2020-02-26 08:08:36 +01:00
|
|
|
## Review the list of available relays from the "relays.md" file, and, for each
|
2019-10-27 23:36:08 +01:00
|
|
|
## server you want to use, define the relays you want connections to go through.
|
2019-10-20 14:19:21 +02:00
|
|
|
##
|
2020-02-26 08:08:36 +01:00
|
|
|
## Carefully choose relays and servers so that they are run by different entities.
|
2019-10-20 14:19:21 +02:00
|
|
|
##
|
|
|
|
## "server_name" can also be set to "*" to define a default route, but this is not
|
2020-02-26 08:08:36 +01:00
|
|
|
## recommended. If you do so, keep "server_names" short and distinct from relays.
|
2019-10-14 12:08:47 +02:00
|
|
|
|
|
|
|
# routes = [
|
2019-10-27 23:36:08 +01:00
|
|
|
# { server_name='example-server-1', via=['anon-example-1', 'anon-example-2'] },
|
|
|
|
# { server_name='example-server-2', via=['sdns://gRIxMzcuNzQuMjIzLjIzNDo0NDM'] }
|
2019-10-14 12:08:47 +02:00
|
|
|
# ]
|
|
|
|
|
2018-01-31 20:07:52 +01:00
|
|
|
|
2020-03-26 13:41:57 +01:00
|
|
|
# skip resolvers incompatible with anonymization instead of using them directly
|
|
|
|
|
|
|
|
skip_incompatible = false
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-01-23 15:51:57 +01:00
|
|
|
## Optional, local, static list of additional servers
|
2018-01-25 17:41:36 +01:00
|
|
|
## Mostly useful for testing your own servers.
|
2018-01-10 13:33:06 +01:00
|
|
|
|
2018-01-31 00:37:56 +01:00
|
|
|
[static]
|
|
|
|
|
2019-06-04 12:17:47 +02:00
|
|
|
# [static.'myserver']
|
|
|
|
# stamp = 'sdns:AQcAAAAAAAAAAAAQMi5kbnNjcnlwdC1jZXJ0Lg'
|