
Легковесный граничный HTTP(S) сервер и обратный прокси с автоматическим SSL, обнаружением Docker/Consul, аутентификацией по маршрутам, ограничением скорости и отказоустойчивостью на основе проверки здоровья.
Reproxy — это простой edge HTTP(s)-сервер / обратный прокси с поддержкой различных провайдеров (docker, static, file, consul catalog). Один или несколько провайдеров предоставляют информацию о запрашиваемом сервере, запрашиваемом URL, целевом URL и URL проверки работоспособности. Распространяется в виде единого бинарного файла или docker-контейнера.
Сервер (хост) может быть задан как FQDN, то есть s.example.com, * (перехват всех) или регулярное выражение. Точное совпадение имеет приоритет, поэтому если есть два правила с серверами example.com и example\.(com|org), запрос к example.com/some/url будет соответствовать первому. Запрашиваемый URL может быть регулярным выражением, например ^/api/(.*), а целевой URL может содержать группы, совпавшие с регулярным выражением, то есть http://d.example.com:8080/$1. Для примера выше http://s.example.com/api/something?foo=bar будет проксирован на http://d.example.com:8080/something?foo=bar.
Точные имена серверов и имена вида *.example.com сопоставляются с хостом без учёта регистра и игнорируют одну завершающую точку, поэтому Admin.Example.com и admin.example.com. соответствуют правилу admin.example.com. Серверы-регулярные выражения сопоставляются как написано, поэтому добавляйте (?i), когда регистр не должен иметь значения. Регулярные выражения маршрутов сопоставляются с экранированным путём запроса, где пробел — это %20, а ü — это %C3%BC, тогда как префиксы статических ресурсов можно записывать как обычный текст. Регулярные выражения маршрутов чувствительны к регистру: когда защищённый маршрут находится перед вышестоящим сервером, который обрабатывает пути без учёта регистра, добавьте (?i) к этому маршруту.
Для удобства запросы с завершающим / и без групп регулярного выражения раскрываются в /(.*), а назначения в этих случаях раскрываются в /$1. То есть /api/ -> http://127.0.0.1/service будет преобразовано в ^/api/(.*) -> http://127.0.0.1/service/$1.
Перед сопоставлением маршрута reproxy отклоняет с кодом 400 запрос, декодированный путь которого содержит сегмент . или .., повторяющиеся слэши (//), ; или обратный слэш. Одиночный завершающий слэш допускается.
В целевом URL поддерживается подстановка хоста. Например, /files/${host} будет заменено на совпавшее имя хоста. Также можно использовать $host (без фигурных скобок).
Группы регулярного выражения сервера можно использовать в URL назначения как ${host.1}, ${host.2} и так далее (фигурные скобки обязательны). Например, сервер ^([^.]+)\.example\.com$ с маршрутом ^/(.*)$ и назначением https://${host.1}.foo.com/$1 проксирует http://aaaa.example.com/some на https://aaaa.foo.com/some. $1, $2 по-прежнему ссылаются на группы маршрута. Отсутствующая группа заменяется пустой строкой, как и любой ${host.N} для точного сервера, * или *.example.com, поскольку у них нет групп. Значения хоста вставляются как есть, без URL-экранирования, поэтому делайте группы сервера строгими: привязывайте регулярное выражение с помощью ^ и $ и захватывайте только то, что может содержать метка хоста, то есть ([a-z0-9-]+), а не (.*), которое также совпало бы с .. из хоста вроде ...example.com. Перед сопоставлением маршрута reproxy отклоняет заголовки Host, содержащие символы, недопустимые при валидации заголовка Host по HTTP, или содержащие %, возвращая 400. Когда токен хоста непосредственно следует за группой маршрута, записывайте группу с фигурными скобками, то есть ${1}${host.1}, поскольку $1aaaa был бы прочитан как группа с именем 1aaaa.
Поддерживаются как HTTP, так и HTTPS. Для HTTPS можно использовать как статический сертификат, так и автоматические сертификаты ACME (Let's Encrypt). Опциональный сервер ресурсов можно использовать для раздачи статических файлов. Для запуска reproxy требуется хотя бы один определённый провайдер. Остальные параметры строго опциональны и имеют разумные значения по умолчанию.
Примеры:
reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1"reproxy --docker.enabled --docker.autodocker up -p 80:8080 umputun/reproxy --docker.enabled --docker.autodocker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.comReproxy распространяется как небольшой самодостаточный бинарный файл, а также как docker-образ. И бинарный файл, и образ поддерживают множество архитектур и операционных систем, включая linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 и windows_arm. Мы также предоставляем пакеты deb и rpm для arm64 и x86.
brew install umputun/apps/reproxydocker pull umputun/reproxy или docker pull ghcr.io/umputun/reproxy.Последняя стабильная версия имеет docker-тег :vX.Y.Z (с алиасом :latest), а текущий master имеет тег :master.
Правила проксирования поставляются различными провайдерами. В настоящее время включены — file, docker, static и consul-catalog. Каждый провайдер может определять несколько правил маршрутизации как для проксируемых запросов, так и для статических (ресурсов). Пользователь может задать несколько провайдеров одновременно.
Смотрите примеры различных провайдеров в examples