Salsa - TCP Load Balancer Proxy with Health Checks

Overview

salsa is a versatile tool for creating a TCP load balancer proxy with integrated health checks for underlying proxies. It listens on a specified address and distributes TCP requests to healthy proxies using a round-robin algorithm.

Features

Load Balancing: Distributes incoming TCP requests across multiple proxies.
Health Checks: Ensures only healthy proxies receive requests based on configurable health checks.
Customization: Supports customizable health check intervals and commands.

Installation

Download: Clone the repository from GitHub:

git clone https://github.com/thekhanj/salsa.git
cd salsa

Build and Install: Compile and install the salsa executable:
```
make
sudo make install
```

Usage

Command-Line Options

salsa [OPTIONS...] -l <listening-address> [<proxy-address>...]

-l <listening-address>: Specifies the address on which the proxy listens.

Options

-t <time>: Interval between health checks (default: 5 seconds).
-c <check-proxy>: Custom command to check proxy health.
-h, --help: Display help message and exit.

Examples

Start salsa with default settings:

salsa -l 127.0.0.1:8080 192.168.1.1:9090 192.168.1.2:9090

Configure salsa with a custom health check interval:

salsa -t 10 -l 127.0.0.1:8080 192.168.1.1:9090 192.168.1.2:9090

Use a custom health check command:

salsa -c 'test 1 -eq 1' -l 127.0.0.1:8080 192.168.1.1:9090 192.168.1.2:9090

Reporting Issues

For bug reports or feature requests, please visit our GitHub Issues Page.

TheKhanj/salsa