caddy-netlify-redirects

WHY?

• Because caddy doesn't have a simple regex redirect sytnax module
• Because caddy doesn't have a simple "variable replacement" redirect module

The netlify redirect syntax is simple and easy to use, so why not use it?

*** For use with Caddy2.7.6 and Golang 1.21 ***

INCLUDES FIXES FOR REDIRECT LOOPS.

Warning: This module does not handle query string matching the same as Netlify. It will only perform exact match.

Enables Caddy to use Netlify's _redirect file format

This module tries to replicate the way Netlify's _redirects file works.

It does support:

• Host redirection
• Path redirection
• Other status codes such as 410 Gone (with a redirect after returning the 410)

It does not (currently) support:

• Header matching
• Query string matching
• HTTP -> HTTPS redirection

If you wish to add these features, please open an issue/PR.

Development

See https://caddyserver.com/docs/extending-caddy and https://github.com/caddyserver/xcaddy

xcaddy run xcaddy run --config caddy.json

Building via Docker

As an example, within a dockerfile you can build Caddy with this custom module:

FROM caddy:2.7.6-builder AS builder

RUN xcaddy build \
   --with github.com/christophcemper/caddy-netlify-redirects/v2
   
FROM caddy:2.7.6-alpine as serve

COPY --from=builder /usr/bin/caddy /usr/bin/caddy
COPY ./Caddyfile /etc/caddy/Caddyfile

# Copy over your built assets for your webapp, this could be from gatbsy which includes a _redirects file
COPY --from=node-builder /usr/src/app/packages/rentivo-gatsby-site/public /srv

Or instead of the docker stuff, just clone the caddy repo and run xcaddy build with the module added.

git clone https://github.com/caddyserver/caddy.git
go install github.com/caddyserver/xcaddy/cmd/xcaddy@latest
xcaddy build --with github.com/christophcemper/caddy-netlify-redirects 

Config

You will need to set the order of the module with this line:

order netlify_redirects before redir

Caveat

If the _redirects file does not exist when using the import directive, Caddy will fail to start. You can fix this by using a glob pattern: import _redirects*

Adding redirects

Put a netlify_redirects directive within the Caddyfile eg:

netlify_redirects {
   /:param/here/:test/two /:param/:test/:two 302
   /hello/* /redirected/:splat
   /:param/hello/* /redirected/:param/:splat
}

You can also import a _netlify file:

netlify_redirects {
   import /srv/_redirects
}