بازگشت به وبلاگ

تنظیم پروکسی در Postman برای تست API: راهنمای کامل با مثال‌ها

بیاموزید چگونه پروکسی را در Postman به درستی برای تست API تنظیم کنید: تنظیمات جهانی و فردی، کار با HTTP/SOCKS5، احراز هویت و حل مشکلات رایج.

📅۹ اسفند ۱۴۰۴
```html

Postman یکی از محبوب‌ترین ابزارها برای تست API است که توسط توسعه‌دهندگان، مهندسان QA و متخصصان بک‌اند در سرتاسر جهان استفاده می‌شود. اما اگر نیاز دارید API را تست کنید که فقط از یک منطقه خاص قابل دسترسی است، مسدودیت‌ها را دور بزند یا نیاز به بررسی درخواست‌ها از مکان‌های مختلف دارد، چه باید کرد؟ راه‌حل، تنظیم پروکسی سرور در Postman است.

در این راهنما یاد خواهید گرفت که چگونه پروکسی را به درستی در Postman برای سناریوهای مختلف تنظیم کنید: از مسیریابی ساده ترافیک تا کار با نقاط پایانی جغرافیایی محدود و اشکال‌زدایی درخواست‌ها از طریق پروکسی‌های شرکتی. ما تنظیمات جهانی و فردی پروکسی، کار با پروتکل‌های HTTP و SOCKS5، احراز هویت و حل مشکلات رایج را بررسی خواهیم کرد.

چرا به پروکسی در تست API نیاز داریم

پروکسی سرورها در زمینه تست API چندین وظیفه حیاتی را انجام می‌دهند که نمی‌توان آنها را با ابزارهای استاندارد Postman انجام داد. درک این سناریوها به شما کمک می‌کند تا نوع پروکسی را به درستی انتخاب کرده و آن را برای نیازهای خاص خود تنظیم کنید.

تست API جغرافیایی محدود. بسیاری از API‌های مدرن بسته به موقعیت جغرافیایی مشتری داده‌های متفاوتی را برمی‌گردانند. به عنوان مثال، API‌های خدمات آب و هوا، پلتفرم‌های استریم، برنامه‌های مالی یا بازارها. برای تست اینکه برنامه شما چگونه برای کاربران از آلمان، ایالات متحده یا ژاپن کار می‌کند، به یک پروکسی سرور با آدرس IP از کشور مربوطه نیاز دارید. بدون پروکسی، شما به طور فیزیکی نمی‌توانید رفتار API را برای کاربران از مناطق دیگر شبیه‌سازی کنید.

دور زدن محدودیت نرخ و مسدودیت‌های IP. هنگام تست شدید API ممکن است با محدودیت‌هایی در تعداد درخواست‌ها از یک آدرس IP مواجه شوید. بسیاری از خدمات از محدودیت نرخ در سطح IP استفاده می‌کنند - به عنوان مثال، حداکثر 100 درخواست در دقیقه از یک آدرس. چرخش پروکسی به شما این امکان را می‌دهد که درخواست‌ها را بین چندین آدرس IP توزیع کنید و تست را بدون تأخیر ادامه دهید. این موضوع به ویژه در تست بار یا بررسی‌های خودکار مهم است.

کار از طریق پروکسی‌های شرکتی. اگر در شرکتی با سیاست‌های شبکه سختگیرانه کار می‌کنید، تمام ترافیک خروجی ممکن است از طریق پروکسی سرور شرکتی عبور کند. در این صورت، تنظیم پروکسی در Postman نه یک گزینه، بلکه یک ضرورت است. بدون پیکربندی صحیح، درخواست‌های شما به سادگی به API‌های خارجی نخواهند رسید.

اشکال‌زدایی و نظارت بر ترافیک. پروکسی سرورها می‌توانند برای ضبط و تحلیل ترافیک HTTP/HTTPS استفاده شوند. ابزارهایی مانند Charles Proxy، Fiddler یا mitmproxy به شما این امکان را می‌دهند که جزئیات هر درخواست و پاسخ، از جمله هدرها، بدنه درخواست و زمان اجرا را مشاهده کنید. با تنظیم Postman برای کار از طریق چنین پروکسی، شما یک ابزار قدرتمند برای اشکال‌زدایی تعاملات پیچیده API دریافت می‌کنید.

مهم: برای تست API با محدودیت‌های جغرافیایی، توصیه می‌شود از پروکسی‌های مسکونی استفاده کنید، زیرا آنها از آدرس‌های IP واقعی کاربران خانگی استفاده می‌کنند و به عنوان پروکسی سرورها توسط خدمات شناسایی نمی‌شوند. این موضوع برای دقت تست بسیار حیاتی است.

تنظیمات جهانی پروکسی در Postman

Postman دو روش اصلی برای تنظیم پروکسی ارائه می‌دهد: جهانی (که به تمام درخواست‌ها اعمال می‌شود) و فردی (برای مجموعه‌ها یا درخواست‌های خاص). بیایید با تنظیمات جهانی شروع کنیم که در منوی تنظیمات برنامه قرار دارد.

راهنمای گام به گام برای دسترسی به تنظیمات پروکسی:

  1. Postman را باز کنید و روی آیکون چرخ‌دنده (Settings) در گوشه بالا سمت راست برنامه کلیک کنید، یا از کلیدهای میانبر Ctrl+, (Windows/Linux) یا Cmd+, (macOS) استفاده کنید.
  2. در پنجره تنظیمات باز شده، به تب Proxy بروید.
  3. در اینجا چندین گزینه پیکربندی پروکسی سرور را مشاهده خواهید کرد که در زیر به تفصیل بررسی خواهیم کرد.

در بخش تنظیمات پروکسی، شما سه حالت اصلی کار با پروکسی را خواهید یافت:

  • استفاده از پروکسی سیستم — استفاده از تنظیمات پروکسی سیستم عامل شما
  • اضافه کردن پیکربندی پروکسی سفارشی — تنظیم پروکسی سرور خود به صورت دستی
  • پیکربندی پروکسی جهانی — پیکربندی جهانی با امکان تعیین پروکسی‌های مختلف برای HTTP و HTTPS

هر یک از این حالت‌ها مزایای خاص خود را دارد و برای سناریوهای مختلف استفاده مناسب است. بیایید آنها را به تفصیل بررسی کنیم.

استفاده از تنظیمات سیستم پروکسی

ساده‌ترین روش برای تنظیم پروکسی در Postman، استفاده از تنظیمات سیستم است. این حالت به ویژه زمانی راحت است که شما در یک محیط شرکتی کار می‌کنید که پروکسی در سطح سیستم عامل از قبل تنظیم شده است، یا اگر از کلاینت‌های VPN استفاده می‌کنید که به طور خودکار پروکسی سیستم را پیکربندی می‌کنند.

چگونه استفاده از پروکسی سیستم را فعال کنیم:

  1. به Settings → Proxy در Postman بروید.
  2. علامت را در کنار استفاده از پروکسی سیستم فعال کنید.
  3. Postman به طور خودکار تنظیمات پروکسی را از پیکربندی سیستم عامل شما شناسایی خواهد کرد.
  4. برای ذخیره تغییرات، روی دکمه Update کلیک کنید.

پس از فعال‌سازی این گزینه، Postman از همان تنظیمات پروکسی که مرورگر یا برنامه‌های دیگر شما استفاده می‌کنند، استفاده خواهد کرد. این بدان معناست که اگر شما پروکسی را در Windows (تنظیمات → شبکه و اینترنت → پروکسی)، macOS (تنظیمات سیستم → شبکه → پیشرفته → پروکسی) یا Linux (از طریق متغیرهای محیطی) تنظیم کرده‌اید، Postman به طور خودکار این پارامترها را دریافت خواهد کرد.

محدودیت: تنظیمات سیستم اجازه نمی‌دهد که به طور انعطاف‌پذیر پروکسی را برای درخواست‌های مختلف مدیریت کنید. اگر نیاز دارید API را از مناطق مختلف تست کنید یا بین پروکسی‌های مختلف جابجا شوید، بهتر است از پیکربندی سفارشی استفاده کنید.

تنظیم پروکسی سرور سفارشی

تنظیم پروکسی سفارشی به شما کنترل کامل بر روی مسیریابی ترافیک می‌دهد. شما می‌توانید پروکسی سرور خاص، پورت، نوع پروتکل و حتی پروکسی‌های مختلف برای درخواست‌های HTTP و HTTPS را تنظیم کنید. این روش برای تست با استفاده از خدمات پروکسی تجاری یا زیرساخت پروکسی خودتان ایده‌آل است.

راهنمای گام به گام برای تنظیم پروکسی سفارشی:

  1. به Settings → Proxy در Postman بروید.
  2. اطمینان حاصل کنید که گزینه استفاده از پروکسی سیستم غیرفعال است.
  3. گزینه اضافه کردن پیکربندی پروکسی سفارشی را فعال کنید.
  4. در فیلد نوع پروکسی پروتکل را انتخاب کنید: HTTP، HTTPS یا SOCKS5.
  5. در فیلد پروکسی سرور آدرس پروکسی سرور خود را وارد کنید (به عنوان مثال، proxy.example.com یا آدرس IP 192.168.1.100).
  6. در فیلد پورت پروکسی پورت را مشخص کنید (معمولاً 8080 برای HTTP، 1080 برای SOCKS5، اما بستگی به ارائه‌دهنده شما دارد).
  7. اگر پروکسی نیاز به احراز هویت دارد، گزینه احراز هویت پروکسی را فعال کرده و نام کاربری و رمز عبور را وارد کنید.
  8. برای اعمال تنظیمات روی Update کلیک کنید.

پس از ذخیره تنظیمات، تمام درخواست‌های خروجی از Postman از طریق پروکسی سرور مشخص شده عبور خواهند کرد. شما می‌توانید صحت تنظیمات را با ارسال یک درخواست تست به سرویس بررسی IP، به عنوان مثال:

GET https://api.ipify.org?format=json

در پاسخ باید آدرس IP پروکسی سرور شما را ببینید، نه آدرس IP واقعی شما. اگر IP تغییر نکرد، صحت داده‌های وارد شده را بررسی کرده و اطمینان حاصل کنید که پروکسی سرور کار می‌کند.

تنظیم پروکسی‌های مختلف برای HTTP و HTTPS

Postman به شما این امکان را می‌دهد که پروکسی‌های جداگانه‌ای برای ترافیک HTTP و HTTPS تنظیم کنید. این موضوع زمانی مفید است که شما با زیرساخت شرکتی کار می‌کنید که برای اتصالات امن از پروکسی جداگانه‌ای با بازرسی SSL استفاده می‌کند.

برای تنظیم جداگانه:

  1. در بخش تنظیمات پروکسی، پیکربندی پروکسی جهانی را فعال کنید.
  2. شما دو بلوک جداگانه خواهید دید: پروکسی HTTP و پروکسی HTTPS.
  3. برای هر بلوک، سرور، پورت و اطلاعات احراز هویت خود را مشخص کنید.
  4. تغییرات را ذخیره کنید.

اکنون درخواست‌های HTTP از طریق یک پروکسی و درخواست‌های HTTPS از طریق پروکسی دیگر خواهند رفت. این موضوع به ویژه برای تست در زیرساخت‌های هیبریدی مهم است.

کار با پروکسی، که نیاز به احراز هویت دارند

اکثر خدمات پروکسی تجاری و پروکسی‌های شرکتی برای دسترسی نیاز به احراز هویت دارند. Postman احراز هویت HTTP پایه (Basic Auth) را برای پروکسی سرورها پشتیبانی می‌کند که به شما این امکان را می‌دهد که اطلاعات کاربری را به صورت ایمن ارسال کنید.

تنظیم احراز هویت پروکسی:

  1. در تنظیمات پروکسی (Settings → Proxy) گزینه احراز هویت پروکسی را فعال کنید.
  2. در فیلد نام کاربری نام کاربری که توسط ارائه‌دهنده پروکسی شما ارائه شده است را وارد کنید.
  3. در فیلد رمز عبور رمز عبور را وارد کنید.
  4. برای ذخیره، روی Update کلیک کنید.

Postman به طور خودکار هدر Proxy-Authorization را به هر درخواستی که از طریق پروکسی عبور می‌کند، اضافه می‌کند. اطلاعات کاربری به صورت کدگذاری شده (Base64) ارسال می‌شود، اما برای حداکثر امنیت، توصیه می‌شود از پروکسی HTTPS یا SOCKS5 با رمزگذاری استفاده کنید.

نکته: اگر از پروکسی یک ارائه‌دهنده تجاری استفاده می‌کنید، اطلاعات کاربری معمولاً به صورت username:password@host:port مشخص می‌شود. در Postman باید این داده‌ها را به صورت جداگانه وارد کنید: سرور و پورت در فیلدهای مربوطه و نام کاربری و رمز عبور در بخش احراز هویت پروکسی.

مثال تنظیم با پروکسی مسکونی

فرض کنید شما از پروکسی‌های مسکونی برای تست API استفاده می‌کنید که محتوای متفاوتی برای کاربران از ایالات متحده و اروپا برمی‌گرداند. ارائه‌دهنده پروکسی شما داده‌های زیر را ارائه کرده است:

  • سرور: us.residential.proxy.com
  • پورت: 8080
  • نام کاربری: user_12345
  • رمز عبور: SecurePass789

تنظیم در Postman به این صورت خواهد بود:

  • نوع پروکسی: HTTP
  • پروکسی سرور: us.residential.proxy.com
  • پورت پروکسی: 8080
  • احراز هویت پروکسی: فعال
  • نام کاربری: user_12345
  • رمز عبور: SecurePass789

پس از اعمال تنظیمات، تمام درخواست‌های شما با آدرس‌های IP از ایالات متحده ارسال خواهند شد که به شما این امکان را می‌دهد تا رفتار geo-specific API را تست کنید.

تنظیم پروکسی SOCKS5 در Postman

SOCKS5 یک پروتکل پروکسی چندمنظوره‌تر نسبت به HTTP/HTTPS است. این پروتکل در سطح پایین‌تری از پشته شبکه کار می‌کند و می‌تواند هر نوع ترافیکی را پروکسی کند، نه فقط HTTP. SOCKS5 به ویژه برای تست API‌هایی که از پروتکل‌های غیرمعمول استفاده می‌کنند یا زمانی که حداکثر ناشناسی مورد نیاز است، مفید است.

مزایای SOCKS5 برای تست API:

  • پشتیبانی از هر نوع پروتکل (HTTP، HTTPS، WebSocket، FTP و غیره)
  • هدرهای درخواست را تغییر نمی‌دهد (برخلاف پروکسی HTTP)
  • پشتیبانی از ترافیک UDP (مناسب برای برخی API‌های زمان واقعی)
  • پشتیبانی داخلی از احراز هویت در سطح پروتکل
  • عملکرد بهتر برای اتصالات HTTPS (بدون دو بار handshake SSL)

تنظیم SOCKS5 در Postman:

  1. به Settings → Proxy بروید.
  2. گزینه اضافه کردن پیکربندی پروکسی سفارشی را فعال کنید.
  3. در فیلد نوع پروکسی SOCKS5 را انتخاب کنید.
  4. آدرس سرور SOCKS5 و پورت را وارد کنید (معمولاً 1080، اما بستگی به ارائه‌دهنده دارد).
  5. اگر نیاز به احراز هویت است، احراز هویت پروکسی را فعال کرده و اطلاعات کاربری را وارد کنید.
  6. تنظیمات را ذخیره کنید.

مهم است که توجه داشته باشید که همه ارائه‌دهندگان پروکسی از SOCKS5 پشتیبانی نمی‌کنند. اگر به این پروتکل برای تست نیاز دارید، از ارائه‌دهنده خود در مورد در دسترس بودن نقاط پایانی SOCKS5 بپرسید. به عنوان مثال، پروکسی‌های موبایل معمولاً SOCKS5 را علاوه بر HTTP/HTTPS برای حداکثر انعطاف‌پذیری ارائه می‌دهند.

تنظیم قوانین دور زدن پروکسی

گاهی اوقات شما نیاز دارید که بخشی از درخواست‌ها از طریق پروکسی و بخشی به طور مستقیم انجام شود. به عنوان مثال، شما یک API خارجی را از طریق پروکسی تست می‌کنید، اما همچنین با یک سرور محلی توسعه (localhost) کار می‌کنید که باید به طور مستقیم در دسترس باشد. برای چنین سناریوهایی، Postman تنظیم قوانین دور زدن پروکسی (Proxy Bypass) را ارائه می‌دهد.

چگونه قوانین دور زدن را تنظیم کنیم:

  1. در Settings → Proxy بخش Bypass proxy for these hosts & domains را پیدا کنید.
  2. لیست دامنه‌ها یا آدرس‌های IP که باید پروکسی را دور بزنند، وارد کنید و آنها را با کاما جدا کنید.
  3. ماسک‌ها پشتیبانی می‌شوند: به عنوان مثال، *.internal.company.com تمام زیر دامنه‌ها را استثنا می‌کند.
  4. تغییرات را ذخیره کنید.

نمونه‌هایی از قوانین دور زدن:

  • localhost — دور زدن برای میزبان محلی
  • 127.0.0.1 — دور زدن برای آدرس loopback
  • 192.168.*.* — دور زدن برای تمام شبکه محلی
  • *.dev.company.com — دور زدن برای سرورهای داخلی dev
  • api.internal.service — دور زدن برای یک API داخلی خاص

قوانین دور زدن به ویژه در محیط‌های هیبریدی مفید هستند، جایی که شما به طور همزمان API‌های خارجی (از طریق پروکسی برای هدف‌گذاری جغرافیایی یا دور زدن محدودیت‌ها) و خدمات داخلی (به طور مستقیم برای سرعت و سهولت اشکال‌زدایی) را تست می‌کنید.

مثال عملی: شما یک برنامه موبایل توسعه می‌دهید که با یک API خارجی جغرافیایی کار می‌کند (نیاز به پروکسی از کشورهای مختلف دارد) و یک API داخلی احراز هویت در auth.mycompany.local. *.mycompany.local را به قوانین دور زدن اضافه کنید و درخواست‌های داخلی به طور مستقیم انجام می‌شوند، در حالی که درخواست‌های خارجی از طریق پروکسی انجام می‌شوند.

سناریوهای عملی استفاده از پروکسی در Postman

تئوری خوب است، اما بیایید سناریوهای واقعی استفاده از پروکسی را در تست API بررسی کنیم. این مثال‌ها به شما کمک می‌کند تا بفهمید چگونه تنظیمات پروکسی را برای حل مسائل خاص اعمال کنید.

سناریو 1: تست API جغرافیایی محدود سرویس استریم موسیقی

وظیفه: شرکت شما یک برنامه موبایل برای استریم موسیقی توسعه می‌دهد. API بسته به کشور کاربر، کاتالوگ‌های متفاوتی از آهنگ‌ها را برمی‌گرداند به دلیل محدودیت‌های مجوز. شما باید تست کنید که کاربران از ایالات متحده، آلمان و ژاپن محتوای صحیح را مشاهده می‌کنند.

راه‌حل:

  1. پروکسی‌های مسکونی از سه کشور: ایالات متحده، آلمان، ژاپن دریافت کنید.
  2. در Postman سه محیط (Environments) ایجاد کنید: "تست ایالات متحده"، "تست آلمان"، "تست ژاپن".
  3. در هر محیط متغیرهایی برای تنظیمات پروکسی ایجاد کنید (اگرچه Postman از متغیرها در تنظیمات پروکسی به طور مستقیم پشتیبانی نمی‌کند، می‌توانید آنها را در توضیحات محیط مستند کنید).
  4. به صورت دستی پروکسی را در Settings → Proxy قبل از تست هر منطقه تغییر دهید.
  5. درخواست به API ارسال کنید: GET https://api.musicservice.com/v1/catalog
  6. نتایج را مقایسه کنید: در پاسخ باید آهنگ‌های متفاوتی برای هر کشور وجود داشته باشد.

برای خودکارسازی این فرآیند می‌توانید از Newman (نسخه CLI Postman) با پارامترهای پروکسی استفاده کنید که به شما این امکان را می‌دهد تا تست‌ها را از CI/CD pipeline با تغییر خودکار پروکسی اجرا کنید.

سناریو 2: دور زدن محدودیت نرخ در تست بار

وظیفه: شما در حال تست عملکرد یک API عمومی هستید که محدودیت 100 درخواست در دقیقه از یک IP دارد. برای تست بار کامل، شما نیاز به ارسال 1000 درخواست در دقیقه دارید.

راه‌حل:

  1. از یک مجموعه از 10+ پروکسی سرور با چرخش استفاده کنید.
  2. Postman Collection Runner را با درخواست تست خود تنظیم کنید.
  3. در Pre-request Script منطقی برای چرخش پروکسی اضافه کنید (توجه: Postman از تغییر پروکسی به صورت برنامه‌نویسی در اسکریپت‌ها پشتیبانی نمی‌کند، بنابراین این سناریو بهتر است از طریق Newman با اسکریپت خارجی پیاده‌سازی شود).
  4. گزینه دیگر: از ارائه‌دهنده پروکسی با چرخش خودکار IP استفاده کنید (جلسات چسبنده با TTL کوتاه).

برای چنین سناریویی، پروکسی‌های دیتاسنتر با چرخش ایده‌آل هستند — آنها سرعت بالایی را فراهم می‌کنند و به شما این امکان را می‌دهند که بار را بین چندین آدرس IP توزیع کنید.

سناریو 3: اشکال‌زدایی API HTTPS با بازرسی SSL

وظیفه: شما با یک API خارجی ادغام می‌شوید که خطاهای 500 را برمی‌گرداند، اما جزئیات خطا مشخص نیست. شما باید محتوای کامل درخواست و پاسخ HTTPS را ببینید، از جمله تمام هدرها و بدنه.

راه‌حل:

  1. ابزاری برای ضبط ترافیک HTTPS نصب کنید: Charles Proxy، Fiddler یا mitmproxy.
  2. ابزار را برای گوش دادن به پورت تنظیم کنید (معمولاً 8888 برای Charles، 8888 برای Fiddler).
  3. گواهی SSL ابزار را در سیستم نصب کنید (دستورالعمل‌ها معمولاً در خود برنامه موجود است).
  4. در Postman Settings → Proxy پروکسی را روی localhost:8888 تنظیم کنید.
  5. تأیید SSL را در Postman غیرفعال کنید (Settings → General → SSL certificate verification → OFF) برای اهداف تست.
  6. درخواست مشکل‌دار را از Postman ارسال کنید.
  7. در Charles/Fiddler شما دپوی کامل درخواست و پاسخ را خواهید دید، از جمله ترافیک HTTPS رمزگشایی شده.

این روش برای اشکال‌زدایی مشکلات پیچیده API ضروری است، به ویژه زمانی که مستندات ناقص است یا خطاها در سمت سرور رخ می‌دهد.

سناریو 4: تست API از طریق پروکسی شرکتی با لیست سفید

وظیفه: شما در یک شرکت بزرگ کار می‌کنید که تمام ترافیک خروجی از طریق پروکسی شرکتی عبور می‌کند. پروکسی فقط به دامنه‌های موجود در لیست سفید دسترسی می‌دهد. شما باید یک API خارجی جدید را تست کنید که هنوز به لیست سفید اضافه نشده است.

راه‌حل:

  1. درخواست به بخش IT برای اضافه کردن دامنه API به لیست سفید ارسال کنید (این ممکن است چند روز یا هفته طول بکشد).
  2. برای تست فوری: از اینترنت موبایل شخصی استفاده کنید یا VPN تنظیم کنید.
  3. در Postman دامنه API را به قوانین دور زدن پروکسی اضافه کنید (Bypass proxy for these hosts).
  4. به یک شبکه جایگزین متصل شوید (hotspot موبایل، Wi-Fi خانگی از طریق VPN).
  5. تست را انجام دهید.
  6. پس از اضافه شدن دامنه به لیست سفید شرکتی، قانون دور زدن را حذف کنید و از طریق پروکسی استاندارد کار کنید.

این سناریو اهمیت تنظیم انعطاف‌پذیر پروکسی و قوانین دور زدن را در محیط‌های شرکتی نشان می‌دهد.

حل مشکلات رایج در کار با پروکسی

حتی با تنظیمات صحیح، ممکن است مشکلاتی پیش بیاید. بیایید رایج‌ترین خطاها و راه‌حل‌های آنها را بررسی کنیم.

مشکل 1: "Could not get any response" یا "Error: connect ETIMEDOUT"

دلایل:

  • پروکسی سرور در دسترس نیست یا آدرس/پورت به درستی مشخص نشده است
  • پروکسی نیاز به احراز هویت دارد، اما اطلاعات کاربری مشخص نشده است
  • Firewall اتصال به پروکسی را مسدود می‌کند
  • پروکسی سرور شلوغ یا به طور موقت در دسترس نیست

راه‌حل‌ها:

  1. دسترس‌پذیری پروکسی را از طریق ترمینال بررسی کنید: curl -x http://proxy:port https://api.ipify.org
  2. اطمینان حاصل کنید که آدرس و پورت به درستی مشخص شده‌اند (بدون فاصله‌های اضافی، پروتکل صحیح)
  3. بررسی کنید که آیا احراز هویت فعال است و نام کاربری/رمز عبور به درستی وارد شده‌اند
  4. پروکسی سرور دیگری از مجموعه خود را امتحان کنید
  5. به طور موقت پروکسی را در Postman غیرفعال کنید و بررسی کنید که آیا درخواست به طور مستقیم کار می‌کند

مشکل 2: "407 Proxy Authentication Required"

دلیل: پروکسی نیاز به احراز هویت دارد، اما اطلاعات کاربری ارائه نشده یا نادرست است.

راه‌حل‌ها:

  1. احراز هویت پروکسی را در تنظیمات Postman فعال کنید
  2. درستی نام کاربری و رمز عبور را بررسی کنید (به حروف بزرگ و کوچک، نمادهای خاص توجه کنید)
  3. اطمینان حاصل کنید که آدرس IP شما در لیست سفید ارائه‌دهنده پروکسی مجاز است (اگر قابل اجرا باشد)
  4. مدت اعتبار اطلاعات کاربری را بررسی کنید (برخی از ارائه‌دهندگان رمزهای عبور موقتی تولید می‌کنند)

مشکل 3: خطاهای SSL/TLS هنگام استفاده از پروکسی HTTPS

خطاهای رایج: "مشکل گواهی SSL"، "نمی‌توان اولین گواهی را تأیید کرد"، "گواهی خود امضا شده در زنجیره گواهی".

دلایل:

  • پروکسی بازرسی SSL را انجام می‌دهد و گواهی خود را جایگزین می‌کند
  • گواهی پروکسی در سیستم شما به عنوان گواهی معتبر نصب نشده است
  • مشکلات با زنجیره گواهی در سمت API

راه‌حل‌ها:

  1. برای اهداف تست: تأیید SSL را در Postman غیرفعال کنید (Settings → General → SSL certificate verification → OFF). توجه: از این در محیط تولید استفاده نکنید!
  2. برای محیط تولید: گواهی ریشه پروکسی را در سیستم و Postman نصب کنید (Settings → Certificates → CA Certificates)
  3. از پروکسی بدون بازرسی SSL استفاده کنید (SOCKS5 یا پروکسی HTTP با عبور SSL)
  4. با مدیر پروکسی برای دریافت گواهی صحیح تماس بگیرید

مشکل 4: سرعت کند درخواست‌ها از طریق پروکسی

دلایل:

  • پروکسی سرور جغرافیایی از شما یا API هدف دور است
  • پروکسی شلوغ است (به ویژه برای پروکسی‌های رایگان یا ارزان)
  • کانال ارتباطی کند ارائه‌دهنده پروکسی
  • دو بار رمزگذاری SSL (مشتری شما → پروکسی → API)

راه‌حل‌ها:

  1. پروکسی سروری را انتخاب کنید که به API هدف نزدیک‌تر باشد (اگر API در ایالات متحده است، از پروکسی‌های ایالات متحده استفاده کنید)
  2. به نوع پروکسی سریع‌تری تغییر دهید (به عنوان مثال، از پروکسی‌های مسکونی به دیتاسنتر برای کارهایی که geo مهم نیست، تغییر دهید)
  3. از SOCKS5 به جای HTTP برای درخواست‌های HTTPS استفاده کنید (overhead کمتری دارد)
  4. پروکسی‌های پریمیوم با ظرفیت تضمینی را در نظر بگیرید
  5. برای درخواست‌های غیر بحرانی به طور موقت پروکسی را غیرفعال کنید

مشکل 5: آدرس IP تغییر نمی‌کند، در حالی که پروکسی تنظیم شده است

دلایل:

  • پروکسی تنظیم شده، اما فعال نشده است (فراموش کرده‌اید روی Update کلیک کنید)
  • دامنه API به قوانین دور زدن پروکسی اضافه شده است
  • پروکسی سیستم تنظیمات Postman را نادیده می‌گیرد
  • درخواست‌های DNS به طور مستقیم انجام می‌شوند (DNS leak)

راه‌حل‌ها:

  1. بررسی کنید که پروکسی واقعاً فعال است: یک درخواست به https://api.ipify.org ارسال کنید و IP را در پاسخ بررسی کنید
  2. اطمینان حاصل کنید که گزینه استفاده از پروکسی سیستم غیرفعال است، اگر از پروکسی سفارشی استفاده می‌کنید
  3. لیست دامنه‌های دور زدن را بررسی کنید و اگر دامنه هدف در آنجا وجود دارد، آن را حذف کنید
  4. پس از تغییر تنظیمات پروکسی، Postman را دوباره راه‌اندازی کنید

نکته اشکال‌زدایی: یک درخواست تست به سرویس بررسی IP (به عنوان مثال، https://api.ipify.org، https://ifconfig.me یا https://api.myip.com) ایجاد کنید و آن را در یک مجموعه جداگانه "آزمایش پروکسی" ذخیره کنید. این درخواست را پس از هر تغییر تنظیمات پروکسی برای بررسی سریع ارسال کنید.

نتیجه‌گیری

تنظیم پروکسی در Postman یک ابزار قدرتمند برای گسترش قابلیت‌های تست API است. شما یاد گرفته‌اید که چگونه پروکسی‌های سیستم و سفارشی را تنظیم کنید، با پروتکل‌های HTTP و SOCKS5 کار کنید، احراز هویت و قوانین دور زدن را تنظیم کنید. این مهارت‌ها به شما این امکان را می‌دهد که به طور مؤثر API‌های جغرافیایی محدود را تست کنید، محدودیت‌های نرخ را دور بزنید، از طریق پروکسی‌های شرکتی کار کنید و مشکلات پیچیده را با استفاده از ابزارهای ضبط ترافیک اشکال‌زدایی کنید.

نکات اصلی این...

```