Простой и эффективный HTTP load balancer на Go с round-robin балансировкой, автоматическими health checks и гибким rate limiting на основе API ключей.
- 🔄 Round-robin балансировка - равномерное распределение запросов между бэкендами
- 💓 Health checks - автоматическое отключение недоступных бэкендов
- 🚦 Rate limiting - гибкое ограничение частоты запросов на основе API ключей
- 🔌 Graceful shutdown - корректное завершение работы сервера и бэкендов
- 🎛️ REST API - управление клиентами через HTTP endpoints
- 📊 Structured logging - детальное логирование с помощью zerolog
- ⚡ Быстрый и легковесный - минимальные накладные расходы
- Go 1.24 или выше
# Клонировать репозиторий
git clone <repo-url>
cd go-load-balancer
# Скачать зависимости
go mod download
# Создать конфигурационный файл
cp app.env.example app.env
# Отредактируйте app.env под ваши нужды
# Запустить
go run cmd/loadbalancer/main.goСоздайте файл app.env в корне проекта (используйте app.env.example как шаблон):
# Адрес для прослушивания
LISTEN_ADDRESS=:8080
# Бэкенд серверы (через запятую)
BACKENDS=localhost:9001,localhost:9002,localhost:9003
# Rate limiting: максимальный размер корзины токенов
RATE_LIMIT_CAPACITY=5
# Rate limiting: скорость пополнения токенов в секунду
RATE_LIMIT_REFILL_RATE=1Если файл не найден, используются значения по умолчанию. Переменные окружения имеют приоритет над значениями из файла.
Сначала создайте клиента для получения API ключа:
curl -X POST http://localhost:8080/clients \
-H "Content-Type: application/json" \
-d '{
"client_id": "user1",
"capacity": 10,
"rate_per_sec": 2,
"api_key": "secret-key-123"
}'Если не указать api_key, он будет сгенерирован автоматически.
Параметры:
client_id- уникальный идентификатор клиента (обязательно)capacity- размер корзины токенов (burst capacity)rate_per_sec- количество токенов добавляемых в секундуapi_key- API ключ для аутентификации (опционально)
Используйте полученный API ключ в заголовке X-API-Key:
curl http://localhost:8080/ \
-H "X-API-Key: secret-key-123"Запрос будет проксирован на один из доступных бэкендов согласно round-robin стратегии.
# Получить список всех клиентов
curl http://localhost:8080/clients
# Получить клиента по ID
curl http://localhost:8080/clients/user1
# Обновить клиента
curl -X PUT http://localhost:8080/clients/user1 \
-H "Content-Type: application/json" \
-d '{
"client_id": "user1",
"capacity": 20,
"rate_per_sec": 5,
"api_key": "secret-key-123"
}'
# Удалить клиента
curl -X DELETE http://localhost:8080/clients/user1.
├── cmd/loadbalancer/ # Точка входа приложения
├── internal/
│ ├── backend/ # Управление бэкенд серверами
│ ├── balancer/ # Стратегии балансировки нагрузки
│ ├── client/ # Управление клиентами и API ключами
│ ├── config/ # Загрузка и валидация конфигурации
│ ├── health/ # Health check механизм
│ └── server/ # HTTP сервер и middleware
├── app.env.example # Пример конфигурации
├── go.mod # Go модули
├── go.sum
└── README.md
Запустите тесты:
# Запустить все тесты
go test ./...
# С покрытием кода
go test ./... -cover
# Детальный вывод
go test ./... -vПроверка кода:
# Статический анализ
go vet ./...
# Форматирование
go fmt ./...- Load Balancer получает входящий запрос
- Rate Limiter проверяет API ключ и лимиты клиента
- Balancer выбирает следующий доступный бэкенд (round-robin)
- Reverse Proxy перенаправляет запрос на выбранный бэкенд
- Health Checker периодически проверяет доступность бэкендов
Этот проект распространяется под лицензией MIT. Подробности в файле LICENSE.
Проект создан в качестве учебного задания. Предложения по улучшению приветствуются!