• Extremely fast - Runs on Cloudflare's Edge
• Simple to integrate - Integrate it with existing sites using Cloudflare
• Easy to manage - Redirects are stored in Workers KV
• Supports URL parameters - URL parameters are appended to the target URL if not already present
• Works in front of an existing website - If no redirect is found it can pass the request to the origin

If you want to deploy this Worker yourself, clone this repo and cd into it:

git clone https://github.com/betahuhn/cf-worker-redirect && cd cf-worker-redirect

Install the required dev dependencies:

npm install

Next start the interactive deployment process with worker-setup:

npm run deploy

You will be asked to login to Cloudflare if not already authenticated. The programm will guide you through the process of setting up and deploying the Worker under your own Cloudflare Account.

After you have deployed your Worker, head over to the KV section of the Workers Dashboard and select your Namespace.

To add a redirect, simply enter the URL path you want to redirect as the key (including the leading /) and the target URL as the value.

Example:

If your your Worker runs on example.com, all requests to example.com/github will be redirected to https://github.com/BetaHuhn.

If you have multiple domains pointing to the same worker, you can specify the domain in front of the path to target it specifically.

Example:

Both example.com/foo and example2.com/foo will redirect to example3.com/bar

Since a key in your KV Namespace specifies a URL path with or without the domain, you can also specify a redirect if a user requests the root of your page (i.e. example.com/):

By default if a path is not found in the KV Namespace a 404 error will be returned. You can optionally redirect all 404 errors to a custom URL by specifying it with the 404 key:

If you use the worker in front of your actual website, you can tell the worker to pass requests to the origin if no redirect is found:

You can also use the pass value on any other key:

All URL search parameters will be passed on to the final URL if they are not already present in the specified target URL.

Example with a Worker running at example.com:

A user requesting example.com/blog-post-test?ref=Twitter will be redirected to https://example.com/blog/posts/test?ref=Twitter.

If the specified target URL would have been https://example.com/blog/posts/test?ref=Campaign then the parameter ref=Twitter would have been ignored

If you want to reuse the code for this Worker, generate a new one with wrangler:

wrangler generate new-worker https://github.com/betahuhn/cf-worker-redirect && cd new-worker

Next generate the wrangler.toml from the given template:

npm run generate

Set your account id in wrangler.toml, which can be found on your Workers Dashboard.

Create a KV namespace for cf-worker-redirect:

wrangler kv:namespace create "REDIRECT_KV"

You will be instructed to append some content to the wrangler.toml file.

Publish your Worker with: wrangler publish

• run yarn lint or npm run lint to run eslint.
• run yarn test or npm run test to run all Mocha tests.
• run yarn dev or npm run dev to run the Worker locally with Wrangler.
• run yarn build or npm run build to produce a production version with webpack.

This project was developed by me (@betahuhn) in my free time. If you want to support me:

Copyright 2021 Maximilian Schiller

This project is licensed under the MIT License - see the LICENSE file for details.