mirror of
https://github.com/coredns/coredns.git
synced 2025-11-01 10:43:17 -04:00
51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
|
# 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
|
||
|
|
}
|
||
|
|
~~~
|