راهنما · curl

استفاده از پروکسی با curl

ابزار curl سریع‌ترین روش برای بررسی فعال بودن پروکسی، بدون وابستگی به مرورگر یا افزونه است. دستور curl به‌صورت پیش‌فرض در Linux، macOS و Windows 10، 11 وجود دارد. این راهنما شامل مثال‌های دستوری، نحوه خواندن خروجی برای عیب‌یابی خطاها و تنظیم پروکسی پیش‌فرض برای تمام دستورات است.

نویسنده: Bùi Toàn · به‌روزرسانی: 19/11/2026

دستورات پایه‌ای

  • برای فرمت ip:port:user:pass، این دستور را اجرا کنید: curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • یا در یک رشته واحد ترکیب کنید: curl -x http://user:pass@IP:PORT https://api.ipify.org
  • خروجی باید IP پروکسی باشد. مشاهده IP مربوط به ISP شما به این معنی است که درخواست از پروکسی عبور نکرده است.
  • برای بررسی کشور نیز، URL مقصد را با https://ipinfo.io/json جایگزین کنید.
  • اگر پروکسی در حالت SOCKS5 یا HTTP + SOCKS5 کار می‌کند: curl -x socks5h://user:pass@IP:PORT https://api.ipify.org (گزینه socks5h اجازه می‌دهد پروکسی نام‌های دامنه را ریزالو کند)، یا curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org.

در Windows

در PowerShell 5.1، عبارت "curl" یک نام مستعار برای Invoke-WebRequest است و curl واقعی نیست. به‌جای curl از curl.exe استفاده کنید: curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org. در Command Prompt (cmd) و PowerShell 7 یا بالاتر، دستور curl همان curl واقعی است.

چگونه در curl از پروکسی با کاراکترهای خاص در رمز عبور استفاده کنیم؟

هنگام استفاده از فرمت user:pass@IP، کاراکترهای خاص مانند @ : / # % در رمز عبور باید URL-encode شوند—برای مثال @ به %40 و # به %23 تبدیل می‌شود. استفاده از -U "user:pass" (داخل دابل کوتیشن) نیازی به انکودینگ ندارد و خطاها را کاهش می‌دهد. در Linux و macOS، اگر رمز عبور شامل $ یا ! است از سینگل کوتیشن استفاده کنید.

چگونه خروجی curl را برای عیب‌یابی خطاهای پروکسی بررسی کنیم؟

برای بررسی مرحله به مرحله، آرگومان -v را اضافه کنید: خط "200 Connection established" نشان‌دهنده پذیرش اتصال توسط پروکسی است، در حالی که پیام‌های خطای زیر آن مشخص می‌کنند مشکل از اطلاعات ورود، پورت‌ها، شبکه یا سایت مقصد است.

افزودن -v برای جزئیات کامل

برای سایت‌های HTTPS، دستور curl یک درخواست CONNECT به پروکسی ارسال می‌کند. خط "< HTTP/1.1 200 Connection established" به این معنی است که پروکسی اتصال را پذیرفته است. خط "407 Proxy Authentication Required" نشان‌دهنده اشتباه بودن نام کاربری یا رمز عبور است.

خطای Failed to connect … Connection refused

اتصال به IP:port بلافاصله رد شد (refused): پورت اشتباه است، پروکسی منقضی شده یا غیرفعال است. راهنمای خطاهای connection refused را ببینید.

خطای Connection timed out

هیچ پاسخی دریافت نشد: IP اشتباه است، اختلال شبکه وجود دارد یا فایروال پورت را مسدود کرده است. برای جلوگیری از انتظار طولانی، گزینه --connect-timeout 10 را اضافه کنید.

خطای CONNECT tunnel failed، پاسخ 502 یا 503

پروکسی در حال اجرا است اما نتوانست با سایت مقصد ارتباط برقرار کند. وب‌سایت دیگری را امتحان کنید تا مشخص شود مشکل از سایت مقصد است یا پروکسی.

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

متغیرهای محیطی را طوری تنظیم کنید که تمام دستورات curl (و بسیاری از ابزارهای دیگر) به‌طور خودکار از پروکسی استفاده کنند: export https_proxy="http://user:pass@IP:PORT" و export http_proxy="$https_proxy" در Linux و macOS. برای دور زدن پروکسی در یک تک دستور از --noproxy "*" استفاده کنید. همچنین می‌توانید خط proxy = "http://user:pass@IP:PORT" را به فایل ~/.curlrc خود اضافه کنید.

هنوز پروکسی ندارید؟ خرید پروکسی اختصاصی با فعال‌سازی خودکار

پروکسی اختصاصی IPv4 در 9 کشور از 20.000₫/IP/ماه برای خرید از 2.000 IP (39.000₫ برای 1 IP)، به‌همراه پروکسی استاتیک ISP ویتنام و US. پروتکل‌های HTTP(S) و SOCKS5 با نام کاربری و رمز عبور، پهنای باند نامحدود، تحویل خودکار پس از پرداخت. پروکسی‌های ویتنام در حال حاضر از پروتکل HTTP(S) استفاده می‌کنند؛ SOCKS5 هنوز در دسترس نیست.

خرید فوری پروکسی

پرسش‌های متداول

چرا مقدار https_proxy همچنان با http:// شروع می‌شود؟+

این پیشوند نحوه اتصال curl به پروکسی را مشخص می‌کند، نه سایت مقصد. هنگام ارتباط با پروکسی ONET از طریق HTTP، سایت‌های HTTPS همچنان از طریق متد CONNECT در دسترس هستند. در پروتکل SOCKS5، مقدار با socks5h:// شروع می‌شود.

آیا می‌توانم از --socks5 با پروکسی‌های ONET استفاده کنم؟+

بله، زمانی که پروکسی در حالت SOCKS5 یا HTTP + SOCKS5 کار می‌کند: curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org، یا -x socks5h://user:pass@IP:PORT. از socks5h یا --socks5-hostname استفاده کنید تا نام‌های دامنه در سمت پروکسی ریزالو شوند. توجه داشته باشید که پروکسی‌های ویتنام در حال حاضر فقط از پروتکل HTTP(S) استفاده می‌کنند؛ SOCKS5 هنوز در دسترس نیست.