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: header default values (#98)

Browse source 
see https://github.com/caddyserver/caddy/pull/3807
This commit is contained in:
Gilbert Gilb's 2020-11-24 23:32:42 +01:00 • committed by GitHub
parent b95745040b
commit 8084cba78b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

13
src/docs/markdown/caddyfile/directives/header.md
View file

@ -12,16 +12,18 @@ By default, header operations are performed immediately unless any of the header
## Syntax ## Syntax
```caddy-d ```caddy-d
header [<matcher>] [[+|-]<field> [<value>|<find>] [<replace>]] { header [<matcher>] [[+|-|?]<field> [<value>|<find>] [<replace>]] {
<field> <find> <replace> <field> <find> <replace>
[+]<field> <value> [+]<field> <value>
-<field> -<field>
?<field> <default_value>
[defer] [defer]
} }
``` ```
- **&lt;field&gt;** is the name of the header field. By default, will overwrite any existing field of the same name. Prefix with `+` to add the field instead of replace, or prefix with `-` to remove the field. - **&lt;field&gt;** is the name of the header field. By default, will overwrite any existing field of the same name. Prefix with `+` to add the field instead of replace, or prefix with `-` to remove the field.
- **&lt;value&gt;** is the header field value, if adding or setting a field. - **&lt;value&gt;** is the header field value, if adding or setting a field.
- **&lt;default_value&gt;** is the header field value that will be set only if the header does not already exist.
- **&lt;find&gt;** is the substring or regular expression to search for. - **&lt;find&gt;** is the substring or regular expression to search for.
- **&lt;replace&gt;** is the replacement value; required if performing a search-and-replace. - **&lt;replace&gt;** is the replacement value; required if performing a search-and-replace.
- **defer** will force the header operations to be deferred until the response is written out to the client. This is automatically enabled if any of the header fields are being deleted. - **defer** will force the header operations to be deferred until the response is written out to the client. This is automatically enabled if any of the header fields are being deleted.
@ -58,7 +60,7 @@ header {
# disable clients from sniffing the media type # disable clients from sniffing the media type
X-Content-Type-Options nosniff X-Content-Type-Options nosniff
# clickjacking protection # clickjacking protection
X-Frame-Options DENY X-Frame-Options DENY
@ -75,3 +77,10 @@ route {
header /static/* Cache-Control max-age=31536000 header /static/* Cache-Control max-age=31536000
} }
``` ```
Set a default cache expiration if upstream doesn't define one:
```caddy-d
header ?Cache-Control "max-age=3600"
reverse_proxy upstream:443
```