proxy-loadbalancer/README.md

# proxy-loadbalancer

_A round-robin load balancer for HTTP proxies._

This is a simple proxy load balancer that will route requests to a cluster of proxy backends in a round-robin fashion.
This makes it easy to connect your clients to a large number of proxy servers without worrying about implementing
anything special clientside.

- Downstream HTTPS proxy servers are not supported.
- This proxy server will transparently forward HTTPS requests without terminating them, meaning a self-signed certificate is not required.

## Install

1.  Download the latest release from [/releases](https://git.evulid.cc/cyberes/proxy-loadbalancer/releases) or run `./build.sh` to build the program locally.
2.  `cp config.example.yml config.yml`
3.  Edit the config.
4.  Start the loadbalancer with `./proxy-loadbalancer --config [path to your config.yml]`

## Use

You can run your own "public IP delivery server" `canihazip` <https://git.evulid.cc/cyberes/canihazip> or use the default `api.ipify.org`

An example systemd service `loadbalancer.service` is provided.

The server displays stats and info at `/json`

## Special Headers

The load balancer accepts special headers to control its behavior.

-   `Thirdparty-Bypass`: don't use any third-party endpoints for this request.
-   `Thirdparty-Include-Broken`: use all online endpoints for this request, including third-party ones that failed the special test.
Initial commit 2024-01-14 14:17:56 -07:00			`# proxy-loadbalancer`

update readme 2024-01-14 15:19:03 -07:00			`_A round-robin load balancer for HTTP proxies._`

update documentation 2024-04-12 18:34:47 -06:00			`This is a simple proxy load balancer that will route requests to a cluster of proxy backends in a round-robin fashion.`
			`This makes it easy to connect your clients to a large number of proxy servers without worrying about implementing`
			`anything special clientside.`
prototype new golang loadbalancer 2024-04-12 01:26:45 -06:00
fix exception from proxy server when background thread is updating proxies, return the proxied status code instead of handling it on the server,add more fields to request logging 2024-04-12 20:31:59 -06:00			`- Downstream HTTPS proxy servers are not supported.`
			`- This proxy server will transparently forward HTTPS requests without terminating them, meaning a self-signed certificate is not required.`
update readme 2024-01-14 15:19:03 -07:00
			`## Install`

update documentation 2024-04-12 18:34:47 -06:00			1. Download the latest release from [/releases](https://git.evulid.cc/cyberes/proxy-loadbalancer/releases) or run `./build.sh` to build the program locally.
			2. `cp config.example.yml config.yml`
			`3. Edit the config.`
			4. Start the loadbalancer with `./proxy-loadbalancer --config [path to your config.yml]`
update readme 2024-01-14 15:19:03 -07:00
add homepage and json status page 2024-04-12 19:15:37 -06:00			`## Use`

update documentation 2024-04-12 18:34:47 -06:00			You can run your own "public IP delivery server" `canihazip` <https://git.evulid.cc/cyberes/canihazip> or use the default `api.ipify.org`
update readme 2024-01-14 15:19:03 -07:00
update documentation 2024-04-12 18:34:47 -06:00			An example systemd service `loadbalancer.service` is provided.
add helpful headers 2024-03-20 19:06:06 -06:00
add homepage and json status page 2024-04-12 19:15:37 -06:00			The server displays stats and info at `/json`

add helpful headers 2024-03-20 19:06:06 -06:00			`## Special Headers`

			`The load balancer accepts special headers to control its behavior.`

update documentation 2024-04-12 18:34:47 -06:00			- `Thirdparty-Bypass`: don't use any third-party endpoints for this request.
			- `Thirdparty-Include-Broken`: use all online endpoints for this request, including third-party ones that failed the special test.