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

Clarify a few things

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

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

@ -26,7 +26,7 @@ Key points:
- An optional **global options block** can be the very first thing in the file.
- Otherwise, the first line of the Caddyfile is **always** the address(es) of the site to serve.
- All directives **must** go in a site block. There is no global scope or inheritence across site blocks.
- All directives and matchers **must** go in a site block. There is no global scope or inheritence across site blocks.
- If there is **only one site block**, its curly braces `{ }` are optional.
A Caddyfile consists of at least one or more site blocks, which always starts with one or more [addresses](#addresses) for the site. Any directives appearing before the address will be confusing to the parser.
@ -131,13 +131,13 @@ These are examples of valid addresses:
- `localhost:8080`
- `127.0.0.1`
- `[::1]:2015`
- `example.com/foo`
- `example.com/foo/*`
From the address, Caddy can potentially infer the scheme, host, port, and path prefix of your site. The default port is 2015 unless [automatic HTTPS](/docs/automatic-https#activation) is activated, which changes it to the HTTPS port.
From the address, Caddy can potentially infer the scheme, host, port, and path of your site. The default port is 2015 unless [automatic HTTPS](/docs/automatic-https#activation) is activated, which changes it to the HTTPS port.
If you specify a hostname, only requests with a matching Host header will be honored. In other words, if the site address is `localhost`, then Caddy will not match requests to `127.0.0.1`.
If multiple sites share the same definition, you can list all of them:
If multiple sites share the same definition, you can list all of them together:
```
localhost:8080, example.com, www.site.com
@ -190,7 +190,7 @@ redir /old-article.html /new-article.html
Path matcher tokens must start with a forward slash `/`.
Note that [path matching](/docs/json/apps/http/servers/routes/match/path/) is an exact match by default; you must append a `*` for a fast prefix match.
Note that [path matching](/docs/json/apps/http/servers/routes/match/path/) is an exact match by default; you must append a `*` for a fast prefix match. Be aware that matching `/foo*` will also match `/foobar`; you might actually want `/foo/*` instead.
### Named matcher
@ -241,6 +241,8 @@ The following matcher modules are built-in:
}
```
Like directives, named matcher definitions must go inside the site blocks that use them.
### Matcher examples