mirror of
https://github.com/coredns/coredns.git
synced 2025-11-12 15:02:17 -05:00
6445a3f2f0
Make the CH middleware actually work. Needs a bit of a hack to route the fake version.bind and friends zone to the correct handler. Fiddle with the order in directive.go so that CH queries get logged as well. Secondly add class rewriting to the rewrite middleware handler and also log the class by default.
100 lines
3.7 KiB
Markdown
100 lines
3.7 KiB
Markdown
# rewrite
|
|
|
|
`rewrite` performs internal message rewriting. Rewrites are invisible to the client.
|
|
There are simple rewrites (fast) and complex rewrites (slower), but they're powerful enough to
|
|
accommodate most dynamic back-end applications.
|
|
|
|
## Syntax
|
|
|
|
~~~
|
|
rewrite from to
|
|
~~~
|
|
|
|
* from is the exact name of type to match
|
|
* to is the destination name or type to rewrite to
|
|
|
|
If from *and* to look like a DNS type (`A`, `MX`, etc.) the type of the message will be rewriten,
|
|
i.e. to rewrite ANY queries to HINFO, use `rewrite ANY HINFO`.
|
|
|
|
If from *and* to look like a DNS class (`IN`, `CH`, or `HS`) the class of the message will be
|
|
rewritten. I.e. to rewrite CH queries to IN use `rewrite CH IN`.
|
|
|
|
If it does not look like a type a name is assumed and the qname in the message is rewritten, this
|
|
needs to be a full match of the name `rewrite miek.nl example.org`.
|
|
|
|
Advanced users may open a block and make a complex rewrite rule:
|
|
TODO(miek): this has not yet been implemented.
|
|
|
|
> Everything below this line has not been implemented, yet.
|
|
|
|
~~~
|
|
rewrite [basename] {
|
|
regexp pattern
|
|
ext extensions...
|
|
if a cond b
|
|
status code
|
|
to destinations...
|
|
}
|
|
~~~
|
|
|
|
* basepath is the base path to match before rewriting with regular expression. Default is /.
|
|
* regexp (shorthand: r) will match the path with the given regular expression pattern. Extremely high-load servers should avoid using regular expressions.
|
|
* extensions... is a space-separated list of file extensions to include or ignore. Prefix an extension with ! to exclude an extension. The forward slash / symbol matches paths without file extensions.
|
|
* if specifies a rewrite condition. Multiple ifs are AND-ed together. a and b are any string and may use request placeholders. cond is the condition, with possible values explained below.
|
|
* status will respond with the given status code instead of performing a rewrite. In other words, use either "status" or "to" in your rule, but not both. The code must be a number in the format 2xx or 4xx.
|
|
* destinations... is one or more space-separated paths to rewrite to, with support for request placeholders as well as numbered regular expression captures such as {1}, {2}, etc. Rewrite will check each destination in order and rewrite to the first destination that exists. Each one is checked as a file or, if ends with /, as a directory. The last destination will act as default if no other destination exists.
|
|
"if" Conditions
|
|
|
|
The if keyword is a powerful way to describe your rule. It takes the format a cond b, where the values a and b are separated by cond, a condition. The condition can be any of these:
|
|
|
|
~~~
|
|
is = a equals b
|
|
not = a does NOT equal b
|
|
has = a has b as a substring (b is a substring of a)
|
|
not_has = b is NOT a substring of a
|
|
starts_with = b is a prefix of a
|
|
ends_with = b is a suffix of a
|
|
match = a matches b, where b is a regular expression
|
|
not_match = a does NOT match b, where b is a regular expression
|
|
~~~
|
|
|
|
## Examples
|
|
|
|
When requests come in for /mobile, actually serve /mobile/index.
|
|
rewrite /mobile /mobile/index
|
|
If the file is not favicon.ico and it is not a valid file or directory, serve the maintenance page if present, or finally, rewrite to index.php.
|
|
|
|
~~~
|
|
rewrite {
|
|
if {file} not favicon.ico
|
|
to {path} {path}/ /maintenance.html /index.php
|
|
}
|
|
~~~
|
|
|
|
If user agent includes "mobile" and path is not a valid file/directory, rewrite to the mobile index page.
|
|
|
|
~~~
|
|
rewrite {
|
|
if if {>User-agent} has mobile
|
|
to {path} {path}/ /mobile/index.php
|
|
}
|
|
~~~
|
|
|
|
If the request path starts with /source, respond with HTTP 403 Forbidden.
|
|
|
|
~~~
|
|
rewrite {
|
|
regexp ^/source
|
|
status 403
|
|
}
|
|
~~~
|
|
|
|
Rewrite /app to /index with a query string. {1} is the matched group (.*).
|
|
|
|
~~~
|
|
rewrite /app {
|
|
r (.*)
|
|
to /index?path={1}
|
|
}
|
|
~~~
|