Skip to content

Lightweight reverse proxy implemented with Cloudflare Workers.

License

Notifications You must be signed in to change notification settings

jackblackjack/Workers-Proxy

 
 

Repository files navigation

Workers-Proxy

LICENSE GitHub closed issues GitHub stars

Languages: English, 简体中文.

Introduction

Workers-Proxy is a lightweight Javascript application that retrieves resource as a client from other servers.

Deploying on Cloudflare Workers, which is an influential platform for building serverless applications, you could build customized reverse proxy without purchasing virtual machines and configuring web servers such as Nginx or Apache.

Moreover, crucial performance such as latency and availability will be optimized, since your serverless application will be deployed on Cloudflare's global network of data centers across 200 cities in 90 countries.

By configuring Geolocation and IP address filters, you could directly suspend your reverse proxy service in specific countries or regions based on their regulations. Taking advantage of the mobile redirector, you could distribute various webpages based on users' devices.

Demo

Reverse-Proxy Project (This demo may not be available in specific regions.)

Getting Started

Build and Deploy

Deploy with Wrangler

  1. Installing Wrangler.

  2. Generate a new project.

wrangler generate my-workers-proxy https://github.com/Siujoeng-Lau/Workers-Proxy
  1. Configure your project's wrangler.toml file to prepare your project for deployment.
wrangler config
  1. Build and deploy on Cloudflare Workers.
wrangler build
wrangler publish

Deploy manually

  1. Navigate to Cloudflare Workers, register or sign in your Cloudflare account, and set custom subdomain for workers, and create a new Worker.

  2. Customize 'src/index.js', paste the code into Cloudflare online editor to replace the default one.

  3. Change name of your Worker, save and deploy it, and check whether its performance fulfills your demand.

Bind to Custom Domain

  1. Check whether your domain is currently under Cloudflare's protection.

  2. Navigate to the dashboard of your domain, select 'Workers' page, and click on 'Add Route'.

  3. Type https://<domain-name>/* in Route and select the Worker you created previously.

  4. Add a CNAME DNS record for your custom domain. Concretely, enter the subdomain (or '@' for root) in the 'Name' field, enter the second level domain of your workers in the 'Target' field, and set 'Proxy status' to 'Proxied'.

Customize index.js

Basically, there are a few constants on the top of the 'index.js' file.

To customize your own Workers-Proxy Service, you should edit these constants according to your demands.

// Website you intended to retrieve for users.
const upstream = 'www.google.com'

// Custom pathname for the upstream website.
const upstream_path = '/'

// Website you intended to retrieve for users using mobile devices.
const upstream_mobile = 'www.google.com'

// Countries and regions where you wish to suspend your service.
const blocked_region = ['CN', 'KP', 'SY', 'PK', 'CU']

// IP addresses which you wish to block from using your service.
const blocked_ip_address = ['0.0.0.0', '127.0.0.1']

// Whether to use HTTPS protocol for upstream address.
const https = true

// Replace texts.
const replace_dict = {
    '$upstream': '$custom_domain',
    '//google.com': ''
}

Example Configurations

About

Lightweight reverse proxy implemented with Cloudflare Workers.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%