
हल्का एज HTTP(S) सर्वर और रिवर्स प्रॉक्सी जिसमें स्वचालित SSL, Docker/Consul डिस्कवरी, प्रति-रूट प्रमाणीकरण, दर सीमा, और स्वास्थ्य-जांच-आधारित फ़ेलओवर शामिल है।
Reproxy एक सरल एज HTTP(s) सर्वर / रिवर्स प्रॉक्सी है जो विभिन्न प्रदाताओं (docker, static, file, consul catalog) का समर्थन करता है। एक या अधिक प्रदाता अनुरोधित सर्वर, अनुरोधित URL, गंतव्य URL और हेल्थ चेक URL के बारे में जानकारी प्रदान करते हैं। इसे एकल बाइनरी या docker कंटेनर के रूप में वितरित किया जाता है।
सर्वर (होस्ट) को 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 परिभाषित होना आवश्यक है। शेष पैरामीटर पूरी तरह से वैकल्पिक हैं और उनके उचित डिफ़ॉल्ट मान हैं।
उदाहरण:
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 शामिल हैं। हम arm64 और x86 दोनों deb और rpm पैकेज भी प्रदान करते हैं।
brew install umputun/apps/reproxydocker pull umputun/reproxy या docker pull ghcr.io/umputun/reproxy।नवीनतम स्थिर संस्करण में :vX.Y.Z docker टैग (:latest उपनाम के साथ) है और वर्तमान master में :master टैग है।
विभिन्न providers द्वारा प्रॉक्सी नियम प्रदान किए जाते हैं। वर्तमान में शामिल हैं - file, docker, static और consul-catalog। प्रत्येक provider प्रॉक्सी किए गए अनुरोध और static (assets) दोनों के लिए कई रूटिंग नियम परिभाषित कर सकता है। उपयोगकर्ता एक साथ कई providers सेट कर सकता है।
विभिन्न providers के उदाहरण examples में देखें
यह सबसे सरल provider है जो सभी mapping नियम सीधे कमांड लाइन (या environment) में परिभाषित करता है। कई नियम समर्थित हैं। प्रत्येक नियम 3 से 7 कॉमा-सेपरेटेड तत्व हैं server,sourceurl,destination[,ping-url[,forward-health-checks[,timeout[,throttle]]]]। उदाहरण के लिए: