History

Miek Gieben 0876a38cd9 middleware/httproxy: smaller timeouts Make the timeouts smaller after we fail to connect.		2016-11-27 15:24:50 +00:00
..
google.go	middleware/httproxy: smaller timeouts	2016-11-27 15:24:50 +00:00
google_test.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
metrics.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
proxy.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
README.md	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
setup.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
setup_test.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
tls.go	middleware/httpproxy: Add (#439 )	2016-11-26 17:57:22 +00:00
upstream.go	middleware/httproxy: smaller timeouts	2016-11-27 15:24:50 +00:00

README.md

httpproxy

httpproxy proxies DNS request to a proxy using HTTPS (or HTTP/2 - not implemented). Usually this involves sending a JSON payload over this transport and translating the response back to DNS. The current supported backend is Google, using the URL: https://dns.google.com .

Syntax

In its most basic form, a simple http proxy uses this syntax:

httpproxy FROM TO

FROM is the base domain to match for the request to be proxied.
TO is the destination endpoint to proxy to, accepted values here are dns.google.com.

For changing the defaults you can use the expanded syntax:

proxy FROM TO {
    upstream ADDRESS...
}

upstream defines upstream resolvers to be used (re-)resolve dns.google.com (or other names in the future) every 30 seconds. When not specified the combo 8.8.8.8, 8.8.4.4 is used.

Metrics

If monitoring is enabled (via the prometheus directive) then the following metric is exported:

coredns_httpproxy_request_count_total{zone, proto, family}

Examples

Proxy all requests within example.org to Google's dns.google.com.

proxy example.org dns.google.com

Proxy everything, and re-lookup dns.google.com every 30 seconds using the resolvers specified in /etc/resolv.conf.

proxy . dns.google.com {
    upstream /etc/resolv.conf
}