Caddy (web server)

Short description: Open source web server

Caddy

Original author(s)| Matthew Holt
Initial release| 28 April 2015; 11 years ago (2015-04-28)
Stable release|

2.7.6 / 7 December 2023; 2 years ago (2023-12-07)[1]

Repository| github.com/caddyserver/caddy
Written in| Go[2]
Operating system| BSD variants, Linux, Plan 9, macOS and Windows
Platform| IA-32 (i386), x86-64, ARM, MIPS, S390X
Type| Web server, reverse proxy server
License| Apache 2
Website| {{{1}}}

Caddy is an extensible, cross-platform, open-source web server written in Go.

The name "Caddy" refers both to a helper for tedious tasks, and a way to organize multiple parts into a simplified system.[3] At its core, Caddy is an extensible platform for deploying long-running services ("apps") using a single, unified configuration that can be updated on-line with a REST API.[4] Official Caddy distributions ship with a set of standard modules which include HTTP server, TLS automation, and PKI apps.[5] It is best known for its automatic HTTPS features.[6][7]

## Contents

* 1 Architecture
* 2 HTTP server
* 3 Development
* 4 References
* 5 External links

## Architecture

Caddy is organized into three main components: a command, the core library, and configuration modules.[8] The command is the extensible interface by which the program is executed; it can also load configuration files, run common modes, manage installed plugins, and offer relevant utility functions. The core library has APIs for loading, unloading, and managing configuration; but it does nothing particularly useful on its own. Most of Caddy's functionality is provided by modules, which are plugins that extend Caddy's configuration structure; for example, the HTTP server is a module.[9] Caddy modules implement various long-running services, web standards, and other useful features.

Caddy's input is a JSON configuration document[10] which is received through an open socket via a RESTful HTTP API.[11][6] In the absence of an HTTP client, Caddy's command-line interface can be used to load configuration files.[12] Config adapters may be used to convert other configuration formats to JSON. Existing adapters include the Caddyfile, which has first-class support in the command line; and YAML, TOML, Nginx, and several other formats.[13][6]

When a configuration is received through its administration socket, Caddy decodes the configuration for all the specified modules, and starts running all the app modules.[6] When the app modules are being provisioned, they themselves may load and provision modules that they use. For example, the HTTP server is an app module which uses HTTP handler modules to handle HTTP requests; these handlers might use yet other modules to implement their functionality, and so on.[14] All these modules are provisioned during the config load phase.[8]

Plugins are installed by statically compiling them directly into the Caddy binary.[3][6] Without plugins, Caddy's native configuration structure only has some basic options for administration and logging.[10] All other functionality must be provided by app modules. Official Caddy distributions ship with dozens of standard modules;[5] others can be added from the project's website,[15] using the `xcaddy` command line tool, or by manually compiling a custom build.[16]

Miek Gieben forked Caddy to use as the core of CoreDNS, now a project of the Cloud Native Computing Foundation, as he appreciated its overall architecture and simplicity of its configuration.[17]

## HTTP server

The HTTP server is an app module that comes standard with official Caddy distributions.[9] It is primarily used as a static file server[18] and load-balancing reverse proxy.[19] While the basis of Caddy's HTTP features use the implementation found in Go's standard library,[20] a variety enhancements and customizations are available as middleware and exposed through configuration parameters:[6]

By default, TLS is used automatically if any routes have a non-empty host matcher.[21] These are assumed to be site names or IP addresses that Caddy is serving, so Caddy will automatically procure and renew certificates for the configured hostnames and IP addresses. When automatic HTTPS is activated in this manner, Caddy will also redirect HTTP requests to their equivalent HTTPS location.

## Development

Caddy version 2 was released on May 5, 2020.[7] Reviewers say that it still has a simpler configuration file syntax than the Apache Web Server, although version 2's configuration format is largely incompatible with the previous major release of Caddy.[7][22]

## References

1. ↑ "Github Releases". https://github.com/caddyserver/caddy/releases.
2. ↑ Gerrand, Andrew (17 February 2016). "Go 1.6 is released". https://blog.golang.org/go1.6.
3. ↑ 3.0 3.1 README.md, caddyserver/caddy on GitHub, 2021-09-27, https://github.com/caddyserver/caddy/blob/059fc32f002d00e980b438b3edbdf7b8bcdf9a90/README.md, retrieved 2021-09-27
4. ↑ "Welcome - Caddy Documentation". https://caddyserver.com/docs/.
5. ↑ 5.0 5.1 imports.go, caddyserver/caddy on GitHub, 2021-09-27, https://github.com/caddyserver/caddy/blob/059fc32f002d00e980b438b3edbdf7b8bcdf9a90/modules/standard/imports.go, retrieved 2021-09-27
6. ↑ 6.0 6.1 6.2 6.3 6.4 6.5 Woodbeck, Adam (2021). Network programming with GO : code secure and reliable network services from Scratch. San Francisco, CA. pp. 217–239. ISBN 978-1-7185-0088-4. OCLC 1198449668. https://www.worldcat.org/oclc/1198449668.
7. ↑ 7.0 7.1 7.2 Jim Salter (May 6, 2020). "Caddy offers TLS, HTTPS, and more in one dependency-free Go Web server". Ars Technica. https://arstechnica.com/gadgets/2020/05/caddy-offers-tls-https-and-more-in-one-dependency-free-go-web-server/.
8. ↑ 8.0 8.1 "Architecture - Caddy Documentation". https://caddyserver.com/docs/architecture.
9. ↑ 9.0 9.1 "Module http - Caddy Documentation". https://caddyserver.com/docs/modules/http.
10. ↑ 10.0 10.1 "JSON Config Structure - Caddy Documentation". https://caddyserver.com/docs/json/.
11. ↑ "API - Caddy Documentation". https://caddyserver.com/docs/api.
12. ↑ "Command Line - Caddy Documentation". https://caddyserver.com/docs/command-line.
13. ↑ "Config Adapters - Caddy Documentation". https://caddyserver.com/docs/config-adapters.
14. ↑ Holt, Matthew (2019-12-04) (in en), The Engineering Challenges of long running go programs, Forge Utah, https://www.youtube.com/watch?v=EhJO8giOqQs, retrieved 2021-09-27
15. ↑ "Download Caddy". https://caddyserver.com/download.
16. ↑ "Build from source - Caddy Documentation". https://caddyserver.com/docs/build#cross-platform.
17. ↑ John Balemaric; Cricket Liu (2019). Learning CoreDNS. "O'Reilly Media, Inc.". ISBN 9781492047919. https://books.google.com/books?id=A1WsDwAAQBAJ&q=cady. Retrieved 12 June 2023.
18. ↑ "Static files quick-start - Caddy Documentation". https://caddyserver.com/docs/quick-starts/static-files.
19. ↑ "Reverse proxy quick-start - Caddy Documentation". https://caddyserver.com/docs/quick-starts/reverse-proxy.
20. ↑ Holt, Matthew (2015-05-27). "A Look Inside Caddy, a Web Server Written in Go" (in en-us). https://blog.gopheracademy.com/caddy-a-look-inside/.
21. ↑ "Automatic HTTPS - Caddy Documentation". https://caddyserver.com/docs/automatic-https.
22. ↑ Jack Wallen (May 26, 2022). "How to deploy a single web page to the Caddy server from a Caddyfile". TechRepublic. https://www.techrepublic.com/article/deploy-web-caddy-server-caddyfile/.

## External links

0.00

(0 votes)

Original source: https://en.wikipedia.org/wiki/Caddy (web server). Read more

|

Retrieved from "https://handwiki.org/wiki/index.php?title=Software:Caddy_(web_server)&oldid=723714"