mirror of
https://github.com/caddyserver/website.git
synced 2025-04-23 21:46:16 -04:00
Updated for v2.8.0 (#389)
Co-authored-by: Mohammed Al Sahaf <msaa1990@gmail.com> Co-authored-by: Francis Lavoie <lavofr@gmail.com> Co-authored-by: Nebez Briefkani <me@nebezb.com> Co-authored-by: Mohammed Al Sahaf <mohammed@caffeinatedwonders.com>
This commit is contained in:
parent
1a82466537
commit
ca9ce7b2b5
22 changed files with 549 additions and 107 deletions
|
@ -29,7 +29,7 @@ title: Caddyfile Directives
|
|||
|
||||
# Caddyfile Directives
|
||||
|
||||
Directives are functional keywords that appear within site [blocks](/docs/caddyfile/concepts#blocks). Sometimes, they may open blocks of their own which can contain _subdirectives_, but directives **cannot** be used within other directives unless noted. For example, you can't use `basicauth` inside a `file_server` block, because `file_server` does not know how to do authentication. However, you _may_ use some directives within special directive blocks like `handle` and `route` because they are specifically designed to group HTTP handler directives.
|
||||
Directives are functional keywords that appear within site [blocks](/docs/caddyfile/concepts#blocks). Sometimes, they may open blocks of their own which can contain _subdirectives_, but directives **cannot** be used within other directives unless noted. For example, you can't use `basic_auth` inside a `file_server` block, because `file_server` does not know how to do authentication. However, you _may_ use some directives within special directive blocks like `handle` and `route` because they are specifically designed to group HTTP handler directives.
|
||||
|
||||
- [Syntax](#syntax)
|
||||
- [Directive Order](#directive-order)
|
||||
|
@ -43,12 +43,13 @@ Directive | Description
|
|||
----------|------------
|
||||
**[abort](/docs/caddyfile/directives/abort)** | Aborts the HTTP request
|
||||
**[acme_server](/docs/caddyfile/directives/acme_server)** | An embedded ACME server
|
||||
**[basicauth](/docs/caddyfile/directives/basicauth)** | Enforces HTTP Basic Authentication
|
||||
**[basic_auth](/docs/caddyfile/directives/basic_auth)** | Enforces HTTP Basic Authentication
|
||||
**[bind](/docs/caddyfile/directives/bind)** | Customize the server's socket address
|
||||
**[encode](/docs/caddyfile/directives/encode)** | Encodes (usually compresses) responses
|
||||
**[error](/docs/caddyfile/directives/error)** | Trigger an error
|
||||
**[file_server](/docs/caddyfile/directives/file_server)** | Serve files from disk
|
||||
**[forward_auth](/docs/caddyfile/directives/forward_auth)** | Delegate authentication to an external service
|
||||
**[fs](/docs/caddyfile/directives/fs)** | Set the file system to use for file I/O
|
||||
**[handle](/docs/caddyfile/directives/handle)** | A mutually-exclusive group of directives
|
||||
**[handle_errors](/docs/caddyfile/directives/handle_errors)** | Defines routes for handling errors
|
||||
**[handle_path](/docs/caddyfile/directives/handle_path)** | Like handle, but strips path prefix
|
||||
|
@ -56,6 +57,8 @@ Directive | Description
|
|||
**[import](/docs/caddyfile/directives/import)** | Include snippets or files
|
||||
**[invoke](/docs/caddyfile/directives/invoke)** | Invoke a named route
|
||||
**[log](/docs/caddyfile/directives/log)** | Enables access/request logging
|
||||
**[log_append](/docs/caddyfile/directives/log_append)** | Append a field to the access log
|
||||
**[log_skip](/docs/caddyfile/directives/log_skip)** | Skip access logging for matched requests
|
||||
**[map](/docs/caddyfile/directives/map)** | Maps an input value to one or more outputs
|
||||
**[method](/docs/caddyfile/directives/method)** | Change the HTTP method internally
|
||||
**[metrics](/docs/caddyfile/directives/metrics)** | Configures the Prometheus metrics exposition endpoint
|
||||
|
@ -69,7 +72,6 @@ Directive | Description
|
|||
**[rewrite](/docs/caddyfile/directives/rewrite)** | Rewrites the request internally
|
||||
**[root](/docs/caddyfile/directives/root)** | Set the path to the site root
|
||||
**[route](/docs/caddyfile/directives/route)** | A group of directives treated literally as single unit
|
||||
**[skip_log](/docs/caddyfile/directives/skip_log)** | Skip access logging for matched requests
|
||||
**[templates](/docs/caddyfile/directives/templates)** | Execute templates on the response
|
||||
**[tls](/docs/caddyfile/directives/tls)** | Customize TLS settings
|
||||
**[tracing](/docs/caddyfile/directives/tracing)** | Integration with OpenTelemetry tracing
|
||||
|
@ -120,8 +122,10 @@ tracing
|
|||
|
||||
map
|
||||
vars
|
||||
fs
|
||||
root
|
||||
skip_log
|
||||
log_append
|
||||
log_skip
|
||||
|
||||
header
|
||||
copy_response_headers # only in reverse_proxy's handle_response block
|
||||
|
@ -136,7 +140,7 @@ uri
|
|||
try_files
|
||||
|
||||
# middleware handlers; some wrap responses
|
||||
basicauth
|
||||
basic_auth
|
||||
forward_auth
|
||||
request_header
|
||||
encode
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue