https://github.com/microup/vbalancer
The vbalancer is a highload proxy for TCP traffic. It provides high availability, scalability for applications running on multiple servers. It allows users to easily manage and scale their applications.
https://github.com/microup/vbalancer
balancer cli cross-platform docker golang highload network proxy requests web
Last synced: 3 months ago
JSON representation
The vbalancer is a highload proxy for TCP traffic. It provides high availability, scalability for applications running on multiple servers. It allows users to easily manage and scale their applications.
- Host: GitHub
- URL: https://github.com/microup/vbalancer
- Owner: microup
- License: agpl-3.0
- Created: 2022-11-20T16:05:06.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-09-10T10:31:47.000Z (4 months ago)
- Last Synced: 2025-09-10T14:06:49.319Z (4 months ago)
- Topics: balancer, cli, cross-platform, docker, golang, highload, network, proxy, requests, web
- Language: Go
- Homepage:
- Size: 470 KB
- Stars: 28
- Watchers: 3
- Forks: 3
- Open Issues: 20
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
  [](https://github.com/microup/vbalancer/actions/workflows/main.yml)
[](https://github.com/microup/vbalancer/actions/workflows/release.yml) [](https://github.com/microup/vbalancer/actions/workflows/docker-ci.yml)
Begining | Docker | Features | License
## What is VBalancer?
VBalancer is a project written on Golang that provides a simple and efficient way to balance traffic between identical servers(peers). It is designed to be lightweight and fast. VBalancer supports TCP protocol. With its easy-to-use configuration options, it is an ideal solution for any organization looking to improve their network application performance and reliability. Blacklist functionality has also been implemented in VBalancer. Now, IP addresses can be added to the configuration file to reject requests, which will also provide protection against DDoS or unauthorized access by a specific address.
VBalancer is an open source project released under the AGPL-3.0 license.
## Beginning
This solution it allows users to easily configure and manage their load balancers with minimal effort.
1. Clone the repository: Use the following command to clone the repository from GitHub: ```git clone https://github.com/microup/vbalancer.git```
2. Install the dependencies required for the project: ```go get github.com/microup/vbalancer```
3. Build the project: Navigate to the project directory and run the following command to build the project: ```go build```
4. Run the project with the following command: ```./vbalancer -config ```
5. Configure your load balancers using the configuration file (config.yaml):
- Set up your load balancers by specifying their IP addresses, ports, and other settings in the config file
- Add or remove services from your load balancers by adding or removing them from the config file
7. Enjoy!
## Docker
Using VBalancer, you can quickly set up a load balancing solution for your Docker containers. It allows you to easily configure the rules for routing traffic between containers, as well as set up health checks to ensure that the containers are running properly.
### * you can build manually
#### build
```bash build
$docker build --tag vbalancer . -f Dockerfile
```
#### run
```bash
$docker run --restart=always -p 8080:8080 vbalancer
```
### * you can take a ready image.
#### Login to GitHub
```bash
$docker login docker.pkg.github.com -u USERNAME -p ${{ secrets.TOKEN }}
```
#### pull the image from GitHub Packages
```bash
$docker pull docker.pkg.github.com/microup/vbalancer/vbalancer:latest
```
#### then start it
before using the ready-made image, you need to enter the container and modify the configuration file by adding or removing the required hosts
```bash
$docker run -d -e PORT=8080 -p 8080:8080 docker.pkg.github.com/microup/vbalancer/vbalancer:latest
```
Congratulations! Now you can use the high-load balancer by sending network requests to it.
#### If you need to stop the container, you will get the container ID:
```bash
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
271b4abb963s vbalancer ./vbalancer" 7 minutes ago Up 7 minutes 0.0.0.0:8080->8080/tcp beeraf_skills
```
#### and stop it
```bash
$ docker container stop 271b4abb963s
```
## Features
- The proxy (VBalancer) has realized on TCP net.Listener
- A limit on connections and a deadline time can be set
- Blacklists functionality has been implemented
- All log write to 'CSV' file
- Size log file can be changed in the config file
## License
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License as published by the Free
Software Foundation, version 3.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Affero General Public License for more details.
####
Copyright (C) 2022-2024 https://microup.ru