Releases · caddyserver/caddy

01 May 00:27

github-actions

v2.8.0-beta.1

d129ae6

v2.8.0 beta 1 Pre-release

Pre-release

This release is obsolete. Please see the next release for the notes.

Assets 149

08 Dec 01:03

github-actions

v2.7.6

6d9a833

v2.7.6

In this version we've made several fixes and enhancements with help from several contributors. Most changes are small, but some notable ones:

The templates middleware is now officially extensible (experimentally). This means modules can add custom functions/actions for templates to execute.
TLS storage cleaning is now synchronized across the cluster and remembered across restarts. This should greatly lower costs for expensive storage backends like DynamoDB.
Placeholders are now evaluated in config for certificate loaders.
Numerous bug fixes.

Thank you to everyone who contributed!

Changelog

65c489a Upgrade acmeserver to github.com/go-chi/chi/v5 (#5913)
ae5e2d9 caddyfile: Fix variadic placeholder false positive when token contains : (#5883)
db55da5 caddyhttp: Adjust scheme placeholder docs (#5910)
df5edf6 caddytls: Context to DecisionFunc (#5923)
6d9a833 caddytls: Sync distributed storage cleaning (#5940)
11a082c cmd: Add newline character to version string in CLI output (#5895)
979c413 cmd: upgrade: resolve symlink of the executable (#5891)
6482070 core: Apply SO_REUSEPORT to UDP sockets (#5725)
15adb89 core: quic listener will manage the underlying socket by itself (#5749)
801ec75 fileserver: Add .m4v for browse template icon
b809ed7 go.mod: CVE-2023-45142 Update opentelemetry (#5908)
b4c7313 go.mod: Upgrade quic-go to v0.39.1
36fce3f go.mod: update quic-go version to v0.40.0 (#5922)
ec2de22 httpcaddyfile: Fix TLS automation policy merging with get_certificate (#5896)
f0ea489 httpcaddyfile: Remove port from logger names (#5881)
87f63b1 httpredirectlistener: Only set read limit for when request is HTTP (#5917)
16834d6 templates: Clarify include args docs, add .ClientIP (#5898)
0259853 templates: Delete headers on httpError to reset to clean slate (#5905)
2f7ceb5 templates: Offically make templates extensible (#5939)
908e956 tls: accept placeholders in string values of certificate loaders (#5963)

Full Changelog: v2.7.5...v2.7.6

Assets 149

11 Oct 22:27

github-actions

v2.7.5

0e204b7

v2.7.5

In this release, we've fixed quite a few small bugs and annoyances, including HTTP/2 Rapid Reset which affected most HTTP/2 implementations.

On a personal note (from @mholt): I recently became a dad! I want to thank our maintainers for helping in so many ways while I've been taking extra time for family. Francis, Matthew, Mohammed, and others -- including all the contributors below, and then some -- are to thank for shipping this release.

Highlights

Updated https://github.com/quic-go/quic-go from v0.37.5 to v0.39.0, including many performance improvements. GSO and ECN are now enabled by default, but you may turn them off by setting the QUIC_GO_DISABLE_GSO=true and QUIC_GO_DISABLE_ECN=true environment variables respectively, if they cause you problems. See the quic-go release notes for more details.
The file server's fileserver.BrowseTemplate is now exported, so it may be customized by programs embedding Caddy. (ed8bb13)
Environment variables loaded with --envfile no longer override existing variables. (#5803)
The encode handler now compresses application/wasm* content types by default. (#5869)
The reverse_proxy handler can now emit very detailed logs for debugging streaming and buffering. To enable it, set the verbose_logs subdirective, and set logging to debug level. Since the logs from this are very noisy, using verbose_logs to opt-in is necessary. We may ask you to enable this when asking for support! (#5793)
You can now check the version with caddy -v, like most other CLI utilities! (#5874)

Caddy is on feature freeze until after 2.8 so we can improve our testing situation. These patches have all been tried to ensure they work as intended, but if you notice any issues please report them!

Changelog

0e204b7 admin: Respond with 4xx on non-existing config path (#5870)
89c407a build(deps): bump actions/checkout from 3 to 4 (#5846)
1405683 build(deps): bump goreleaser/goreleaser-action from 4 to 5 (#5847)
38a7b6b caddyfile: Adjust error formatting (#5765)
7103ea0 caddyfile: Fix case where heredoc marker is empty after newline (#5769)
10053f7 caddyfile: Loosen heredoc parsing (#5761)
58ab3a0 caddyhttp: Use LimitedReader for HTTPRedirectListener (thank you to Bartek Nowotarski for reporting)
9c419f1 cmd: Fix exiting with custom status code, add caddy -v (#5874)
f2ab709 cmd: Prevent overwriting existing env vars with --envfile (#5803)
e0aaefa encode: Add application/wasm* to the default content types (#5869)
fa5a579 fileserver: Add command shortcuts -l and -a (#5854)
ed8bb13 fileserver: Export BrowseTemplate
130f6d1 fileserver: Set canonical URL on browse template (#5867)
a306c5f fileserver: browse template SVG icons and UI tweaks (#5812)
0a6d333 fileserver: docs: clarify the ability to produce JSON array with browse (#5751)
82c356f fix: caddytest.AssertResponseCode error message (#5853)
888c6d7 go.mod: Update quic-go to v0.38.0 (#5772)
88b4fbf go.mod: Upgrade dependencies incl. x/net/http
df99502 httpcaddyfile: Enable TLS for catch-all site if tls directive is specified (#5808)
33d8d2c httpcaddyfile: Sort TLS SNI matcher for deterministic JSON output (#5860)
288216e httpcaddyfile: Stricter errors for site and upstream address schemes (#5757)
2cac3c5 httpcaddyfile: fix placeholder shorthands in named routes (#5791)
c46ec3b logging: Clone array on log filters, prevent side-effects (#5786)
1b73e38 logging: query filter for array of strings (#5779)
4776f62 replacer: change timezone to UTC for "time.now.http" placeholders (#5774)
a8586b0 reverseproxy: Add logging for dynamic A upstreams (#5857)
3a3182f reverseproxy: Add more debug logs (#5793)
4feac4d reverseproxy: Allow fallthrough for response handlers without routes (#5780)
e8b8d4a reverseproxy: Fix least_conn policy regression (#5862)
2a6859a reverseproxy: Fix retries on "upstreams unavailable" error (#5841)
05dbe1c reverseproxy: Replace health header placeholders (#5861)
1e0dea5 reverseproxy: fix nil pointer dereference in AUpstreams.GetUpstreams (#5811)
b245ecd reverseproxy: fix parsing Caddyfile fails for unlimited request/response buffers (#5828)
5653c36 templates: Add dummy RemoteAddr to httpInclude request, proxy compatibility (#5845)
289934f tls: Add X25519Kyber768Draft00 PQ "curve" behind build tag (#5852)

New Contributors

@singhalkarun made their first contribution in #5757
@pauljeannot made their first contribution in #5779
@hainenber made their first contribution in #5790
@evandam made their first contribution in #5803
@FossoresLP made their first contribution in #5811
@glowinthedark made their first contribution in #5812
@pkoenig10 made their first contribution in #5780
@ThanmayNath made their first contribution in #5845
@Christoph-D made their first contribution in #5869
@mcfedr made their first contribution in #5828
@bwesterb made their first contribution in #5852
@Forza-tng made their first contribution in #5867
@BattleRattle made their first contribution in #5870

Full Changelog: v2.7.4...v2.7.5

Contributors

bwesterb, Christoph-D, and 12 other contributors

Assets 149

17 Aug 18:20

github-actions

v2.7.4

f11c3c9

v2.7.4

Caddy 2.7.4 rounds out some bug fixes from the 2.7 release. For example, Go made a last-minute breaking change to a new API that broke quic-go (HTTP/3) on Go 1.21 just before Go 1.21 was released; we resolved a few issues with on-demand TLS that are now much improved from the 2.6 tree; a couple race conditions were fixed in dynamic reverse proxy upstreams. We hope you will be pleased with this new version!

Caddy is on feature freeze until after 2.8 so we can improve our testing situation. These patches have all been tried to ensure they work as intended, but if you notice any issues please report them!

We encourage all users to test this new version and then upgrade. Thanks to all who get involved!

Changelog

080db93 caddytls: Update docs for on-demand config
d813550 cmd: Require config for caddy validate (fix #5612) (#5614)
a8492c0 fileserver: Don't repeat error for invalid method inside error context (#5705)
2d7d806 fileserver: Slightly more fitting icons
f11c3c9 go.mod: Upgrade CertMagic and quic-go
5b9c850 go.mod: Upgrade golang.org/x/net to 0.14.0 (#5718)
936ee91 reverseproxy: Always return new upstreams (fix #5736) (#5752)
431adc0 templates: Fix httpInclude (fix #5698)

New Contributors

@faddat made their first contribution in #5707
@shyim made their first contribution in #5718
@AaronDewes made their first contribution in #5720

Full Changelog: v2.7.3...v2.7.4

Contributors

shyim, faddat, and AaronDewes

Assets 149

06 Aug 00:49

github-actions

v2.7.3

a8cc5d1

v2.7.3

We're pleased to present Caddy 2.7, which makes significant strides in areas of scaling, performance, and niche features.

Special thank-you to @francislavoie, @mohammed90, and other core team members for the ongoing dedication of their time to help maintain the project and help in our forums.

And a big thank-you to everyone else who contributed! You're awesome, and we're glad this project has so many contributors and sponsors to make it possible.

Docs are being updated and will be pushed live shortly. Thank you for your patience and for using Caddy!

(Note: Versions 2.7.0-2.7.2 contain bugs that were hotfixed within minutes and hours and a day of the release. Thank you to everyone who helped with that! And sorry for the trouble, we have learned lessons to help mitigate that in the future.)

Highlights

The in-memory TLS certificate cache is no longer purged and recreated during config reloads, making reloads extremely lightweight even when managing thousands of certificates.
Significant HTTP/3 performance improvements (upstream in quic-go) including enabling 0-RTT. Caddy users should notice significantly better throughput for HTTP/3. Thanks for the fantastic work, @marten-seemann!
New default template for the file server's "browse" listings - more modern, easier to use, grid view, filetype-specific icons, and better dark mode (see #5427 for more screenshots and info)
The reverse proxy now supports the PROXY protocol. Using external modules is no longer required; specifically, the plugin by @mastercactapus is now built-in. (#5424)
Caddyfile now supports Heredoc syntax for long embedded strings/documents. (#5385)
@francislavoie implemented a suite of enhancements to bring you more reliable, trustworthy client IP information, even through proxies and CDNs (#5104)
Certificate private keys will no longer be reused when renewing certificates.
Caddyfile import arg placeholders support slice syntax, e.g. {args[2:]} (#5249)
Customizable "fallback" policy for reverse proxy in case the primary policy isn't applicable. (#5488)
Etags are generated more sensibly for NixOS environments which all have Modified time of 1; and if you set your own Etag, it will not be overwritten.
EXPERIMENTAL: New short flags for the CLI. (#5379)
EXPERIMENTAL: The reverse proxy may be configured to keep hijacked connections (streams, WebSockets, etc.) open through config reloads. (#5567)
EXPERIMENTAL: Define "named routes" to reuse them without copying. Caddyfile snippets are useful for reusing config, but reusing the same HTTP routes involves lots of copied config and memory bloat. Named routes let you define a route once and reuse it throughout your HTTP server without copying. It is available for JSON and Caddyfile configs. (#5107)
EXPERIMENTAL: You can specify permissions for unix sockets. (#4741)
Many many bug fixes you may or may not notice 🙃

Deprecations and possible breaking changes for some:

⚠️ The ask endpoint is now required to enable On-Demand TLS (b97c76f) for catch-all or wildcard hosts. Our docs have always mentioned this is required in production environments, but now the code enforces it. The ask endpoint is not required for local-only or internal-only names (#5384 and a7af7c4).
⚠️ The on-demand config's throttle options are now deprecated because the 'ask' endpoint is required. Additionally, the 'ask' endpoint is checked and the throttle is applied before storage is queried for a certificate in order to limit load on the storage backend.
⚠️ The long-deprecated lookup_srv feature of the reverse proxy has been removed. It was replaced with the dynamic upstreams feature in 2.6. (#5396)
⚠️ The remote_ip forwarded matcher has been deprecated because it assumes trusting downstream proxies. Instead, the client_ip matcher should be used along with trusted_proxies configuration. (#5103 and #5104)
⚠️ Placeholder syntax {args.0} is now deprecated in favor of {args[0]}.
⚠️ Plugin authors will now need to use http.ResponseController to call Flush() or Hijack() on the response writer. (#5654)

Thank you to everyone who contributed! And thank you to our sponsors who truly make this project possible.

New Contributors

@esell made their first contribution in #5417
@krak3n made their first contribution in #5147
@trea made their first contribution in #5435
@heimoshuiyu made their first contribution in #5464
@gucki made their first contribution in #5424
@kidonng made their first contribution in #5475
@taophp made their first contribution in #5497
@eanavitarte made their first contribution in #5515
@jonatan5524 made their first contribution in #5521
@jjiang-stripe made their first contribution in #5531
@TP-O made their first contribution in #5504
@pistasjis made their first contribution in #5536
@charles-dyfis-net made their first contribution in #5547
@jpds made their first contribution in #5554
@kassienull made their first contribution in #5553
@Phrynobatrachus made their first contribution in #5532
@365cent made their first contribution in #5564
@oncilla made their first contribution in #5573
@testwill made their first contribution in #5576
@mmm444 made their first contribution in #5567
@sabify made their first contribution in #5579
@omerdemirok made their first contribution in #5586
@bt90 made their first contribution in #5636
@ydylla made their first contribution in #5646
@kkroo made their first contribution in #5648

Full Changelog: v2.6.4...v2.7.3

Changelog

3f20a7c acmeserver: Configurable resolvers, fix smallstep deprecations (#5500)
b1366c7 build(deps): bump actions/setup-go from 3 to 4 (#5474)
dfe17c3 caddyconfig: Specify config adapter for HTTP loader (close #5607)
f3379f6 caddyfile: Fix heredoc fuzz crasher, drop trailing newline (#5404)
960150b caddyfile: Implement heredoc support (#5385)
8bc05e5 caddyfile: Implement variadics for import args placeholders (#5249)
53b6fab caddyfile: Stricter parsing, error for brace on new line (#5505)
cee4441 caddyfile: Do not replace import tokens if they are part of a snippet (#5539)
9cde715 caddyfile: Track import name instead of modifying filename (#5540)
bbe1952 caddyfile: Fix comparing if two tokens are on the same line (#5626)
9f34383 caddyfile: check that matched key is not a substring of the replacement key (#5685)
cfc85ae caddyhttp: Add a getter for Server.name (#5531)
05e9974 caddyhttp: Determine real client IP if trusted proxies configured (#5104)
c05e389 caddyhttp: Enable 0-RTT QUIC (#5425)
8537586 caddyhttp: Fix vars_regexp matcher with placeholders (#5408)
1c9ea01 caddyhttp: Impl ResponseWriter.Unwrap(), prep for Go 1.20's ResponseController (#5509)
cbf16f6 caddyhttp: Implement named routes, invoke directive (#5107)
2b3046d caddyhttp: Log request body bytes read (#5461)
96919ac caddyhttp: Refactor cert Managers (fix #5415) (#5533)
d8d87a3 caddyhttp: Serve http2 when listener wrapper doesn't return *tls.Conn (#4929)
808b05c caddyhttp: Update quic's TLS configs after reload (#5517) (fix #4849)
2945264 caddyhttp: Fix h3 shutdown (#5541)
6a41b62 caddyhttp: Support custom network for HTTP/3 (#5573)
a7af7c4 caddytls: Allow on-demand w/o ask for internal-only
cd486c2 caddyhttp: Make use of http.ResponseController (#5654)
18c309b caddyhttp: Preserve original error (fix #5652)
66114cb caddyhttp: Trim dot/space only on Windows (fix #5613)
a02ecb0 caddytls: Check for nil ALPN; close #5470 (#5473)
faf0399 caddytls: Configurable fallback SNI (#5527)
e16a886 caddytls: Eval replacer on automation policy subjects (#5459)
be53e43 caddytls: Relax the warning for on-demand (#5384)
b97c76f caddytls: Require 'ask' endpoint for on-demand TLS
0cc49c0 caddytls: Zero out throttle window first (#5443)
4ba03c9 caddytls: Clarify some JSON config docs
0e2c7e1 caddytls: Reuse certificate cache through reloads (#5623)
b301a3d celmatcher: Implement pkix.Name conversion to string (#5492)
096971e ci/cd: ship tarballs with vendored deps (#5403)
5ded580 cmd: Adjust documentation for commands (#5377)
508cf2a cmd: Create pidfile before config load (close #5477)
9e69195 cmd: Exp...