mirrors/caddy-website
1
0
Fork 0
mirror of https://github.com/caddyserver/website.git synced 2025-04-22 13:06:16 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: Update root, reverse_proxy, and shorthand placeholders

Browse source
This commit is contained in:
Matthew Holt 2020-02-04 13:33:48 -07:00
parent 3c6202c15d
commit 2abf8549a7
No known key found for this signature in database
GPG key ID: 2A349DD577D586A5
3 changed files with 26 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

25
src/docs/markdown/caddyfile/concepts.md
View file

@ -277,17 +277,20 @@ reverse_proxy @post localhost:9000
You can use any [Caddy placeholders](/docs/conventions#placeholders) in the Caddyfile, but for convenience you can also use some equivalent shorthand ones: You can use any [Caddy placeholders](/docs/conventions#placeholders) in the Caddyfile, but for convenience you can also use some equivalent shorthand ones:
| Shorthand | Replaces | | Shorthand | Replaces |
|--------------|---------------------------------| |-----------------|---------------------------------|
| `{dir}` | `{http.request.uri.path.dir}` | | `{dir}` | `{http.request.uri.path.dir}` |
| `{file}` | `{http.request.uri.path.file}` | | `{file}` | `{http.request.uri.path.file}` |
| `{host}` | `{http.request.host}` | | `{host}` | `{http.request.host}` |
| `{hostport}` | `{http.request.hostport}` | | `{hostport}` | `{http.request.hostport}` |
| `{method}` | `{http.request.method}` | | `{method}` | `{http.request.method}` |
| `{path}` | `{http.request.uri.path}` | | `{path}` | `{http.request.uri.path}` |
| `{query}` | `{http.request.uri.query}` | | `{query}` | `{http.request.uri.query}` |
| `{scheme}` | `{http.request.scheme}` | | `{remote}` | `{http.request.remote}` |
| `{uri}` | `{http.request.uri}` | | `{remote_host}` | `{http.request.remote.host}` |
| `{remote_port}` | `{http.request.remote.port}` |
| `{scheme}` | `{http.request.scheme}` |
| `{uri}` | `{http.request.uri}` |

11
src/docs/markdown/caddyfile/directives/reverse_proxy.md
View file

@ -163,3 +163,14 @@ reverse_proxy /api/* node1:80 node2:80 node3:80 {
lb_policy header X-My-Header lb_policy header X-My-Header
} }
``` ```
Preserve original request Host and add common proxying headers:
```
reverse_proxy localhost:9000 {
header_up Host {host}
header_up X-Real-IP {remote_host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto {scheme}
}
```

2
src/docs/markdown/caddyfile/directives/root.md
View file

@ -6,7 +6,7 @@ title: root (Caddyfile directive)
Sets the root path of the site, used by various matchers and directives that access the file system. If unset, the default site root is the current working directory. Sets the root path of the site, used by various matchers and directives that access the file system. If unset, the default site root is the current working directory.
Specifically, this directive sets the `{http.vars.root}` placeholder. Specifically, this directive sets the `{http.vars.root}` placeholder. It is mutually exclusive to other `root` directives in the same block, so it is safe to define multiple roots with matchers that intersect: they will not cascade and overwrite each other.
## Syntax ## Syntax