
خادم HTTP(S) طرفي خفيف الوزن ووكيل عكسي مع SSL تلقائي، اكتشاف Docker/Consul، مصادقة لكل مسار، تحديد معدل الطلبات، وتحويل الفشل القائم على فحص الصحة.
Reproxy هو خادم 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 (بدون أقواس معقوفة).
يمكن استخدام مجموعات خادم 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 يشيران إلى مجموعات المسار. تُستبدل المجموعة المفقودة بسلسلة فارغة، وكذلك أي ${host.N} لخادم مطابق تمامًا أو * أو *.example.com، لأن هذه لا تحتوي على مجموعات. تُدرج قيم المضيف كما هي، دون تهريب URL، لذا احرص على إحكام مجموعات الخادم: ثبّت regex باستخدام ^ و$، والتقط فقط ما يمكن أن تحتويه تسمية المضيف، أي ([a-z0-9-]+) بدلاً من (.*)، الذي قد يطابق أيضًا .. من مضيف مثل ...example.com. قبل مطابقة المسار، يرفض reproxy رؤوس 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.comيُوزَّع Reproxy كملف ثنائي صغير مكتفٍ ذاتيًا وكذلك كصورة 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.
قواعد الوكيل يوفّرها مزوّدون متنوعون. المضمّن حاليًا - file وdocker وstatic وconsul-catalog. يمكن لكل مزوّد تعريف قواعد توجيه متعددة لكل من الطلب الموجّه والأصول الثابتة. يمكن للمستخدم تعيين عدة مزوّدين في الوقت نفسه.
راجع أمثلة لمزوّدين متنوعين في examples
هذا هو أبسط مزوّد يعرّف جميع قواعد التعيين مباشرة في سطر الأوامر (أو البيئة). تدعم قواعد متعددة. كل قاعدة تتكون من 3 إلى 7 عناصر مفصولة بفواصل server,sourceurl,destination[,ping-url[,forward-health-checks[,timeout[,throttle]]]]. على سبيل المثال:
*,^/api/(.*),https://api.example.com/$1 - توجيه جميع الطلبات إلى أي مضيف/خادم يحمل البادئة /api إلى https://api.example.comexample.com,/foo/bar,https://api.example.com/zzz,https://api.example.com/ping - توجيه جميع الطلبات إلى example.com وإلى عنوان URL يحمل /foo/bar إلى https://api.example.com/zzz، ويستخدم https://api.example.com/ping لفحص السلامة.example.com,/foo/bar,https://api.example.com/zzz,https://api.example.com/ping,true - مثل ما سبق، لكنه يمرر أيضًا طلبات /ping و/health إلى الواجهة الخلفية.example.com,^/upload/(.*),https://api.example.com/$1,,,5m - مهلة طلب لكل مسار مدتها 5 دقائق (الحقلان الرابع والخامس تُركا فارغين لتخطي ping-url وforward-health-checks).example.com,^/login,https://api.example.com/login,,,,2 - تحديد معدل لكل مسار بمقدار طلبين في الثانية لكل مستخدم (الحقول الموضعية السابقة تُركت فارغة).