بروكسي مخصص لفيتنام: فرض عنوان IP خروج جديد

تغطي هذه الصفحة المنتج المعروض على الرف باسم بروكسي فيتنام الدوار المخصص للسكن، ويُباع بفترات يوم واحد وسبعة أيام وثلاثين يومًا. وهو نفس المنتج الذي تسميه بعض القوائم والأدلة الأقدم "VN Exclusive". إذا كنت تبحث عن هذا الاسم في الكتالوج فلن تجده، لذا ابحث عن "Vietnam Dedicated" بدلاً من ذلك.

ولا تغطي هذه الصفحة بروكسي فيتنام الدوار المشترك للسكن، فهو منتج مختلف. سيرفض العنوان أدناه حسابًا مشتركًا، لأن هذا الحساب لا يملك مفتاحًا خاصًا به للتدوير.

إنه يغيّر عنوان IP بالفعل دون تدخل منك

من المفيد معرفة هذا قبل كتابة أي كود للتعامل مع هذا المنتج، لأنه يغيّر ما إذا كنت بحاجة إلى ذلك. يقوم البروكسي المخصص بتدوير عنوان IP الصادر تلقائيًا كل ثلاث دقائق تقريبًا. هذا هو المنتج، وهو مذكور في القائمة.

ما يفعله الطلب أدناه هو فرض هذا التدوير مبكرًا، للأوقات التي لا يكون فيها انتظار انتهاء الدورة مقبولاً. ليست هذه هي الطريقة الوحيدة للحصول على عنوان IP جديد؛ إنها طريقة الحصول عليه الآن.

أمران يبقيان ثابتين طوال الوقت. المضيف والمنفذ لا يتغيران، وكذلك اسم المستخدم وكلمة المرور. تستمر في استخدام نفس host:port:username:password تمامًا كما كان من قبل، والعنوان الذي يخرج منه حركة المرور فقط هو الذي يختلف.

ما تحتاجه

• اسم المستخدم وكلمة المرور للبروكسي من طلبك، نفس الزوج في host:port:username:password.
• عنوان API الأساسي، https://proxy-api.lunaproxy.online.

الطلب

• الطريقة: POST
• المسار: /api/v1/proxy/change-ip
• المصادقة: Basic عبر HTTP، باستخدام اسم المستخدم وكلمة المرور للبروكسي. لا يوجد مفتاح API ولا رمز مميز يجب جلبه أولاً.
• الاستجابة: JSON، بصيغة {"success": true|false, "message"?: string, "error"?: string}

كأمر واحد، مع بيانات اعتمادك الخاصة بدلاً من العناصر النائبة:

curl -X POST "https://proxy-api.lunaproxy.online/api/v1/proxy/change-ip" \
  -u "YOUR_PROXY_USERNAME:YOUR_PROXY_PASSWORD"

لاحظ أن بيانات الاعتماد توضع في ترويسة المصادقة الأساسية، وهذا ما يبنيه -u، وليس في جسم الطلب. لا يوجد جسم طلب إطلاقًا.

ماذا تعني الاستجابات

النتيجة	HTTP	ما يجب فعله
مقبول	200	{"success":true,"message":"Change-IP request sent"}. الطلبات التي ترسلها عبر البروكسي بعد هذا ستستخدم عنوان IP الصادر الجديد.
غير مصادق	401	ترويسة المصادقة الأساسية مفقودة أو بيانات الاعتماد غير مقبولة. إرسال أي ترويسة يعيد Basic auth required (proxy username:password). تحقق من أنك تستخدم بيانات اعتماد البروكسي وليس تسجيل دخولك إلى الموقع.
غير مؤهل	400	الحساب ليس بروكسي فيتنام مخصصًا، أو لا يوجد مفتاح معين له. البروكسي المشترك يصل إلى هنا. إذا كنت تعتقد أنك اشتريت المنتج المخصص، ارفع الأمر إلى الدعم.
الطلب غير موجود	404	تم حذف الطلب أو لم يكن موجودًا أبدًا. تواصل مع الدعم.
قريب جدًا	429	أنت داخل فترة التهدئة. اقرأ ترويسة الاستجابة Retry-After، التي تعطي مدة الانتظار بالثواني، واستخدمها بدلاً من تخمين ثابت. انظر أدناه لمعرفة سبب وجود فترة الانتظار.
الخادم العلوي مشغول	502	لا يتوفر عنوان IP جديد في تلك اللحظة. انتظر وأعد المحاولة.
خطأ في الخدمة	503	خلل في الخادم العلوي أو داخلي. اقرأ حقل error في الجسم.
خطأ في الخادم	500	غير متوقع. اقرأ حقل error، وأعد المحاولة مرة واحدة، وتواصل مع الدعم إذا استمر.

لماذا توجد فترة تهدئة

لأن دورة التدوير الأساسية تبلغ حوالي ثلاث دقائق، وفرض التغيير لا يقصر تلك الدورة، بل يقدم موضعك داخلها فقط. اطلب مرة أخرى فورًا ولن يكون هناك شيء جديد لتعطيه لك بعد، وهذا ما يعنيه رمز 429.

لذا قم ببناء الانتظار في الكود بدلاً من إعادة المحاولة في حلقة. ترويسة Retry-After على 429 تخبرك بالمدة، وهي الرقم الوحيد الجدير بالثقة؛ الرقم الدقيق يتغير. الحلقة التي تتجاهلها ستنتج سلسلة من 429s دون نتيجة أسرع.

إذا لم يعمل

1. 401 في كل استدعاء. تأكد من أنك ترسل اسم المستخدم وكلمة المرور للبروكسي، وليس تسجيل دخول حسابك هنا. إنها بيانات اعتماد مختلفة، وزوج البروكسي هو المطبوع على طلبك.
2. 400 في كل استدعاء. تحقق من منتج فيتنام الذي اشتريته. فقط المخصص لديه مفتاح للتدوير؛ المشترك لا يملكه.
3. 200، لكن عنوان IP يبدو دون تغيير. تحقق منه عبر البروكسي وليس في متصفح قد يبقي اتصالاً مفتوحًا. الاتصال القائم لا يُعاد بناؤه بالتدوير.
4. لا يعمل شيء إطلاقًا من الساعة الأولى. ارفع الأمر في نفس اليوم. الضمان على هذه القوائم اثنتا عشرة ساعة من التسليم، وهي أقصر مما يتوقع معظم الناس، ويسري سواء اختبرت أم لا.