Zurück zu den Updates
New releaseJul 15, 2026

reproxy v1.7.0

Leichter HTTP(S)-Edge-Server und Reverse-Proxy mit automatischem SSL, Docker/Consul-Erkennung, routenspezifischer Authentifizierung, Ratenbegrenzung und gesundheitscheckbasiertem Failover.

Teilen
Reproxy | Simple Reverse Proxy

Reproxy ist ein einfacher Edge-HTTP(s)-Server / Reverse-Proxy, der verschiedene Provider unterstützt (docker, static, file, consul catalog). Ein oder mehrere Provider liefern Informationen über den angeforderten Server, die angeforderte URL, die Ziel-URL und die Health-Check-URL. Es wird als einzelne Binärdatei oder als Docker-Container verteilt.

  • Automatische SSL-Terminierung mit Let's Encrypt
  • Unterstützung benutzerdefinierter SSL-Zertifikate
  • Einfache, aber flexible Proxy-Regeln
  • Statischer Proxy-Regel-Provider über die Kommandozeile
  • Dynamischer, dateibasierter Proxy-Regel-Provider
  • Docker-Provider mit automatischer Erkennung
  • Consul-Catalog-Provider mit Erkennung über Service-Tags
  • Unterstützung mehrerer (virtueller) Hosts
  • Optionale Traffic-Komprimierung
  • Optionale IP-basierte Zugriffskontrolle
  • Grundlegende Authentifizierung pro Route
  • Benutzerdefinierte Größenbeschränkungen und Timeouts
  • Verteilung als einzelne Binärdatei
  • Verteilung als Docker-Container
  • Integrierter Server für statische Assets mit optionalem „SPA-freundlichem" Modus
  • Unterstützung von Weiterleitungsregeln
  • Optionaler Limiter für die Gesamtaktivität sowie für die Aktivität einzelner Benutzer
  • Live-Health-Check und Fail-over/Load-Balancing
  • Management-Server mit Routeninformationen und Prometheus-Metriken
  • Plugin-Unterstützung über RPC zur Implementierung benutzerdefinierter Funktionalität
  • Optionales Logging sowohl im Apache Log Format als auch mit vereinfachten stdout-Berichten.

build Coverage Status Go Report Card Docker Hub

Der Server (Host) kann als FQDN, z. B. s.example.com, als * (Catch-all) oder als Regex festgelegt werden. Exakte Übereinstimmungen haben Vorrang. Gibt es also zwei Regeln mit den Servern example.com und example\.(com|org), so trifft eine Anfrage an example.com/some/url auf erstere zu. Die angeforderte URL kann ein Regex sein, zum Beispiel ^/api/(.*), und die Ziel-URL kann durch Regex übereinstimmende Gruppen enthalten, z. B. http://d.example.com:8080/$1. Für das obige Beispiel wird http://s.example.com/api/something?foo=bar an http://d.example.com:8080/something?foo=bar weitergeleitet.

Exakte Server-Namen und *.example.com-Namen stimmen ohne Beachtung der Groß-/Kleinschreibung mit dem Host überein und ignorieren einen abschließenden Punkt. Daher treffen Admin.Example.com und admin.example.com. auf eine Regel für admin.example.com zu. Regex-Server werden exakt wie geschrieben abgeglichen; fügen Sie (?i) hinzu, wenn die Groß-/Kleinschreibung keine Rolle spielen soll. Routen-Regexes werden mit dem escapten Anfragepfad abgeglichen, wobei ein Leerzeichen %20 und ü %C3%BC entspricht, während Präfixe für statische Assets als Klartext geschrieben werden können. Routen-Regexes sind case-sensitiv: Wenn eine geschützte Route vor einem Upstream liegt, der Pfade ohne Beachtung der Groß-/Kleinschreibung behandelt, fügen Sie dieser Route (?i) hinzu.

Der Einfachheit halber werden Anfragen mit abschließendem / und ohne Regex-Gruppen zu /(.*) erweitert, und Ziele werden in diesen Fällen zu /$1 erweitert. D. h. /api/ -> http://127.0.0.1/service wird zu ^/api/(.*) -> http://127.0.0.1/service/$1 übersetzt.

Vor dem Routenabgleich lehnt reproxy eine Anfrage mit 400 ab, deren dekodierter Pfad ein .- oder ..-Segment, doppelte Schrägstriche (//), ein ; oder einen Backslash enthält. Ein einzelner abschließender Schrägstrich ist zulässig.

Die Host-Substitution wird in der Ziel-URL unterstützt. Zum Beispiel wird /files/${host} durch den übereinstimmenden Hostnamen ersetzt. $host (ohne geschweifte Klammern) kann ebenfalls verwendet werden.

Gruppen eines Regex-Servers können in der Ziel-URL als ${host.1}, ${host.2} und so weiter verwendet werden (geschweifte Klammern erforderlich). Zum Beispiel leitet der Server ^([^.]+)\.example\.com$ mit der Route ^/(.*)$ und dem Ziel https://${host.1}.foo.com/$1 die Anfrage http://aaaa.example.com/some an https://aaaa.foo.com/some weiter. $1, $2 beziehen sich weiterhin auf die Routengruppen. Eine fehlende Gruppe wird durch eine leere Zeichenkette ersetzt, ebenso wie jedes ${host.N} bei einem exakten, *- oder *.example.com-Server, da diese keine Gruppen haben. Host-Werte werden unverändert eingefügt, ohne URL-Escaping, daher sollten Server-Gruppen eng gefasst werden: Verankern Sie den Regex mit ^ und $ und erfassen Sie nur, was ein Host-Label enthalten darf, d. h. ([a-z0-9-]+) statt (.*), was auch .. aus einem Host wie ...example.com treffen würde. Vor dem Routenabgleich lehnt reproxy Host-Header ab, die Zeichen enthalten, die von der HTTP-Host-Header-Validierung nicht erlaubt sind, oder die % enthalten, und gibt 400 zurück. Wenn ein Host-Token direkt auf eine Routengruppe folgt, schreiben Sie die Gruppe mit geschweiften Klammern, d. h. ${1}${host.1}, da $1aaaa als Gruppe namens 1aaaa gelesen würde.

Sowohl HTTP als auch HTTPS werden unterstützt. Für HTTPS kann sowohl ein statisches Zertifikat als auch ein automatisiertes ACME-Zertifikat (Let's Encrypt) verwendet werden. Ein optionaler Assets-Server kann zum Ausliefern statischer Dateien verwendet werden. Der Start von reproxy erfordert mindestens einen definierten Provider. Die übrigen Parameter sind streng optional und haben sinnvolle Standardwerte.

Beispiele:

  • mit einem statischen Provider: reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1"
  • mit automatischer Docker-Erkennung: reproxy --docker.enabled --docker.auto
  • als Docker-Container: docker up -p 80:8080 umputun/reproxy --docker.enabled --docker.auto
  • mit automatischem SSL: docker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.com

Install

Reproxy wird als kleines eigenständiges Binary sowie als Docker-Image vertrieben. Sowohl das Binary als auch das Image unterstützen mehrere Architekturen und mehrere Betriebssysteme, darunter linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 und windows_arm. Wir stellen außerdem sowohl arm64- als auch x86-deb- und rpm-Pakete bereit.

  • für eine Binary-Distribution laden Sie die passende Datei im Release-Bereich herunter
  • für Homebrew-Nutzer: brew install umputun/apps/reproxy
  • Docker-Container verfügbar auf Docker Hub sowie in der Github Container Registry. D. h. docker pull umputun/reproxy oder docker pull ghcr.io/umputun/reproxy.

Die neueste stabile Version hat das Docker-Tag :vX.Y.Z (mit dem Alias :latest) und der aktuelle Master hat das Tag :master.

Providers

Proxy-Regeln werden von verschiedenen Providern bereitgestellt. Derzeit enthalten sind file, docker, static und consul-catalog. Jeder Provider kann mehrere Routing-Regeln sowohl für proxied Requests als auch für statische (Assets) definieren. Der Benutzer kann mehrere Provider gleichzeitig festlegen.

Kategorien