अपडेट पर वापस जाएँ
New releaseAug 20, 2026

reproxy v1.7.1

हल्का एज HTTP(S) सर्वर और रिवर्स प्रॉक्सी जिसमें स्वचालित SSL, Docker/Consul डिस्कवरी, प्रति-रूट प्रमाणीकरण, दर सीमा, और स्वास्थ्य-जांच-आधारित फ़ेलओवर शामिल है।

साझा करें
Reproxy | सरल रिवर्स प्रॉक्सी

Reproxy एक सरल एज HTTP(s) सर्वर / रिवर्स प्रॉक्सी है जो विभिन्न प्रदाताओं (docker, static, file, consul catalog) का समर्थन करता है। एक या अधिक प्रदाता अनुरोधित सर्वर, अनुरोधित URL, गंतव्य URL और हेल्थ चेक URL के बारे में जानकारी प्रदान करते हैं। इसे एकल बाइनरी या docker कंटेनर के रूप में वितरित किया जाता है।

  • Let's Encrypt के साथ स्वचालित SSL टर्मिनेशन
  • उपयोगकर्ता-प्रदत्त SSL प्रमाणपत्रों का समर्थन
  • सरल लेकिन लचीले प्रॉक्सी नियम
  • स्टैटिक, कमांड-लाइन प्रॉक्सी नियम प्रदाता
  • डायनामिक, फ़ाइल-आधारित प्रॉक्सी नियम प्रदाता
  • स्वचालित खोज के साथ Docker प्रदाता
  • सेवा टैग द्वारा खोज के साथ Consul Catalog प्रदाता
  • कई (वर्चुअल) होस्ट्स का समर्थन
  • वैकल्पिक ट्रैफ़िक कम्प्रेशन
  • वैकल्पिक IP-आधारित एक्सेस नियंत्रण
  • प्रति-रूट बेसिक प्रमाणीकरण
  • उपयोगकर्ता-परिभाषित आकार सीमाएँ और टाइमआउट
  • एकल बाइनरी वितरण
  • Docker कंटेनर वितरण
  • वैकल्पिक "SPA फ्रेंडली" मोड के साथ अंतर्निहित स्टैटिक एसेट्स सर्वर
  • रीडायरेक्ट नियमों का समर्थन
  • समग्र गतिविधि के साथ-साथ उपयोगकर्ता की गतिविधि के लिए वैकल्पिक लिमिटर
  • लाइव हेल्थ चेक और फेल-ओवर/लोड-बैलेंसिंग
  • रूट्स जानकारी और prometheus मेट्रिक्स के साथ प्रबंधन सर्वर
  • कस्टम कार्यक्षमता लागू करने के लिए RPC के माध्यम से प्लगइन्स समर्थन
  • Apache Log Format और सरलीकृत stdout रिपोर्ट दोनों के साथ वैकल्पिक लॉगिंग।

build Coverage Status Go Report Card Docker Hub

सर्वर (होस्ट) को FQDN के रूप में सेट किया जा सकता है, अर्थात् s.example.com, * (सभी को पकड़ने वाला) या एक regex। सटीक मिलान को प्राथमिकता मिलती है, इसलिए यदि सर्वर example.com और example\.(com|org) वाले दो नियम हैं, तो example.com/some/url के लिए अनुरोध पूर्व वाले से मेल खाएगा। अनुरोधित url regex हो सकता है, उदाहरण के लिए ^/api/(.*) और गंतव्य url में regex मिलान किए गए समूह हो सकते हैं, अर्थात् 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 नियम से मेल खाते हैं। Regex सर्वर जैसे लिखे गए हैं वैसे ही मेल खाते हैं, इसलिए जब केस मायने न रखे तो (?i) जोड़ें। रूट regex एस्केप किए गए अनुरोध पथ से मेल खाते हैं, जहाँ एक स्पेस %20 है और ü %C3%BC है, जबकि स्टैटिक एसेट प्रीफ़िक्स सादे टेक्स्ट के रूप में लिखे जा सकते हैं। रूट regex केस-संवेदनशील हैं: जब कोई संरक्षित रूट ऐसे अपस्ट्रीम के सामने होता है जो पथों को केस-असंवेदनशील रूप से मानता है, तो उस रूट में (?i) जोड़ें।

सुविधा के लिए, अनुगामी / वाले और regex समूहों के बिना अनुरोध /(.*) में विस्तारित होते हैं, और उन मामलों में गंतव्य /$1 में विस्तारित होते हैं। अर्थात् /api/ -> http://127.0.0.1/service को ^/api/(.*) -> http://127.0.0.1/service/$1 में अनुवादित किया जाएगा।

रूट मिलान से पहले, reproxy ऐसे अनुरोध को 400 के साथ अस्वीकार करता है जिसके डिकोड किए गए पथ में . या .. सेगमेंट, दोहराए गए स्लैश (//), एक ; या एक बैकस्लैश हो। एकल अनुगामी स्लैश की अनुमति है।

गंतव्य URL में होस्ट प्रतिस्थापन समर्थित है। उदाहरण के लिए, /files/${host} को मिलान किए गए होस्ट नाम से बदल दिया जाएगा। $host (बिना ब्रेसिज़ के) का भी उपयोग किया जा सकता है।

Regex सर्वर के समूहों का उपयोग गंतव्य 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 रूट समूहों को संदर्भित करना जारी रखते हैं। अनुपस्थित समूह को खाली स्ट्रिंग से बदल दिया जाता है, और ठीक, * या *.example.com सर्वर के लिए कोई भी ${host.N} भी, क्योंकि उनमें कोई समूह नहीं होते। होस्ट मान जैसे हैं वैसे ही डाले जाते हैं, बिना URL escaping के, इसलिए सर्वर समूहों को सख्त रखें: regex को ^ और $ से anchor करें, और केवल वही कैप्चर करें जो एक होस्ट लेबल में हो सकता है, अर्थात् ([a-z0-9-]+) न कि (.*), जो ...example.com जैसे होस्ट से .. को भी मैच कर लेगा। रूट मिलान से पहले, reproxy उन Host हेडर को अस्वीकार करता है जिनमें HTTP host-header validation द्वारा अस्वीकृत अक्षर हों या जिनमें % हो, और 400 लौटाता है। जब कोई होस्ट टोकन सीधे किसी रूट समूह के बाद आता है, तो समूह को ब्रैकेस के साथ लिखें, अर्थात् ${1}${host.1}, क्योंकि $1aaaa को 1aaaa नाम के समूह के रूप में पढ़ा जाएगा।

HTTP और HTTPS दोनों समर्थित हैं। HTTPS के लिए, स्थिर प्रमाणपत्र के साथ-साथ स्वचालित ACME (Let's Encrypt) प्रमाणपत्र भी उपयोग किए जा सकते हैं। स्थिर फ़ाइलों को सर्व करने के लिए वैकल्पिक assets सर्वर का उपयोग किया जा सकता है। reproxy शुरू करने के लिए कम से कम एक provider परिभाषित होना आवश्यक है। शेष पैरामीटर पूरी तरह से वैकल्पिक हैं और उनके उचित डिफ़ॉल्ट मान हैं।

उदाहरण:

  • एक static provider के साथ: reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1"
  • स्वचालित docker discovery के साथ: reproxy --docker.enabled --docker.auto
  • एक docker कंटेनर के रूप में: docker up -p 80:8080 umputun/reproxy --docker.enabled --docker.auto
  • स्वचालित SSL के साथ: docker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.com

Install

Reproxy एक छोटे स्व-निहित बाइनरी के साथ-साथ एक docker इमेज के रूप में वितरित किया जाता है। बाइनरी और इमेज दोनों कई आर्किटेक्चर और कई ऑपरेटिंग सिस्टम का समर्थन करते हैं, जिनमें linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64 और windows_arm शामिल हैं। हम arm64 और x86 दोनों deb और rpm पैकेज भी प्रदान करते हैं।

  • बाइनरी वितरण के लिए release section में उपयुक्त फ़ाइल डाउनलोड करें
  • Homebrew उपयोगकर्ताओं के लिए: brew install umputun/apps/reproxy
  • docker कंटेनर Docker Hub पर तथा Github Container Registry पर उपलब्ध है। अर्थात् docker pull umputun/reproxy या docker pull ghcr.io/umputun/reproxy।

नवीनतम स्थिर संस्करण में :vX.Y.Z docker टैग (:latest उपनाम के साथ) है और वर्तमान master में :master टैग है।

Providers

विभिन्न providers द्वारा प्रॉक्सी नियम प्रदान किए जाते हैं। वर्तमान में शामिल हैं - file, docker, static और consul-catalog। प्रत्येक provider प्रॉक्सी किए गए अनुरोध और static (assets) दोनों के लिए कई रूटिंग नियम परिभाषित कर सकता है। उपयोगकर्ता एक साथ कई providers सेट कर सकता है।

विभिन्न providers के उदाहरण examples में देखें

Static provider

यह सबसे सरल provider है जो सभी mapping नियम सीधे कमांड लाइन (या environment) में परिभाषित करता है। कई नियम समर्थित हैं। प्रत्येक नियम 3 से 7 कॉमा-सेपरेटेड तत्व हैं server,sourceurl,destination[,ping-url[,forward-health-checks[,timeout[,throttle]]]]। उदाहरण के लिए:

श्रेणियाँ