proxy server

خادم وكيل على ASP.NET

يطبق هذا المشروع خادم HTTP بسيطًا في ASP.NET لتوكيل الطلبات لخدمات الطرف الثالث.

وصف

يقبل الخادم طلبات HTTP من العملاء، ويستخرج البيانات منهم، ويرسل الطلبات إلى خدمات الطرف الثالث، ويتلقى استجاباتهم، ويعيد النتيجة إلى العميل بتنسيق JSON. يتم تخزين الطلبات والاستجابات محليًا في الذاكرة.

تنسيق الطلب الوارد

يتوقع الخادم طلبًا بتنسيق JSON مع الحقول:

 {
"method": "GET",
"url": "http://example.com",
"headers": { "Authorization": "Bearer your_access_token" }
}

تنسيق الاستجابة

يجب أن تكون الاستجابة للعميل بتنسيق JSON مع الحقول التالية:

 {
"id": "requestId",
"status": <HTTP-статус ответа стороннего сервиса>,
"headers": { "массив заголовков из ответа стороннего сервиса" },
"length": <длина содержимого ответа>
}

التثبيت والإطلاق

متطلبات

• .NET SDK 8.0 أو أعلى
• عامل ميناء (للحاويات)

خطوات التثبيت:

1. استنساخ المستودع:

   git clone <URL репозитория>
   cd ProxyServer

3. بناء المشروع:

   dotnet build

5. بدء الخادم:

   dotnet run

سيتم إطلاق الخادم على http://localhost:44331.

الاستخدام

لاستخدام الخادم، أرسل طلب POST إلى http://localhost:44331/Proxy/proxy مع نص JSON يحتوي على الطريقة وعنوان URL ورؤوس الطلب:

 {
"method": "GET",
"url": "http://example.com",
"headers": {
"Authorization": "Bearer your_access_token"
}

سيرسل الخادم طلبًا إلى عنوان URL المحدد، ويتلقى استجابة من خدمة الجهة الخارجية، ويعيد استجابة JSON مع معلومات حول الطلب والاستجابة.

عامل ميناء

يمكنك أيضًا تشغيل الخادم في حاوية Docker.

بناء وتشغيل حاوية Docker:

1. بناء صورة عامل الميناء:

   docker-compose build

3. ابدأ حاوية Docker:

   docker-compose up -d

سيكون الخادم متاحًا على http://localhost:8080.

ملف تعريف

لأتمتة الأوامر، استخدم Makefile.

أوامر Makefile:

• البناء: إنشاء صورة Docker

  make build

• تشغيل: قم بتشغيل حاوية Docker

  make run

• توقف: أوقف حاوية Docker

  make stop

رابط التقديم

https://proxy-server-zro1.onrender.com/Proxy/proxy

التوثيق

يمكن العثور على مزيد من المعلومات حول المشروع على ويكي.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. راجع ملف الترخيص للحصول على التفاصيل.