راهنماها · اتوماسیون مرورگر

استفاده از پروکسی با Puppeteer، Playwright و Selenium

مرورگرهای خودکار برای جداسازی IP بین جلسات کاری مختلف یا مرور صفحات به عنوان کاربری در کشوری دیگر، به پروکسی نیاز دارند. چالش رایج این است که Chrome نام کاربری و رمز عبور را در آرگومان --proxy-server نادیده می‌گیرد؛ از این رو هر کتابخانه روش اختصاصی خود را برای مدیریت احراز هویت پروکسی ارائه می‌دهد.

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

Playwright (Node.js، Python)

  • هنگام راه‌اندازی مرورگر: chromium.launch({ proxy: { server: "http://IP:PORT", username: "user", password: "pass" } }).
  • یک پروکسی به ازای هر context: browser.newContext({ proxy: { server, username, password } }). یک نمونه مرورگر واحد می‌تواند چندین context را اجرا کند که هر کدام IP اختصاصی خود را دارند و بار پردازشی بسیار کمتری نسبت به اجرای چند مرورگر مصرف می‌کنند.
  • زبان Python از ساختاری مشابه با یک دیکشنری استفاده می‌کند: p.chromium.launch(proxy={"server": "http://IP:PORT", "username": "user", "password": "pass"}).
  • مرورگرهای Firefox و WebKit در Playwright دقیقاً همان پیکربندی پروکسی را می‌پذیرند.

Puppeteer

  1. راه‌اندازی مرورگر با فلگ خط فرمان: puppeteer.launch({ args: ["--proxy-server=http://IP:PORT"] }).
  2. برای هر صفحه، پیش از فراخوانی page.goto، متد await page.authenticate({ username: "user", password: "pass" }) را صدا بزنید.
  3. اگر در یک مرورگر واحد به چند پروکسی نیاز دارید، در نسخه‌های مدرن Puppeteer از browser.createBrowserContext({ proxyServer: "http://IP:PORT" }) به همراه page.authenticate در هر صفحه استفاده کنید.
  4. با رفتن به https://api.ipify.org و خواندن بدنه پاسخ، برقراری اتصال را بررسی کنید.

آیا Selenium می‌تواند از پروکسی‌های دارای نام کاربری و رمز عبور استفاده کند؟

بله، اما نه به‌طور مستقیم. ChromeDriver پارامتری برای نام کاربری و رمز عبور پروکسی ندارد و کادر احراز هویت پروکسی در Chrome با Selenium استاندارد قابل کنترل نیست. راهکارهای رایج عبارتند از: استفاده از کتابخانه selenium-wire (در Python) که پروکسی را با فرمت http://user:pass@IP:PORT می‌پذیرد؛ ایجاد یک افزونه کوچک Chrome برای مدیریت رویدادهای احراز هویت و بارگذاری آن هنگام راه‌اندازی؛ یا استفاده از Firefox با پروفایلی که اطلاعات ورود پروکسی در آن ذخیره شده است. برای پروژه‌های جدید، Playwright این فرآیند را بسیار ساده‌تر می‌کند.

هنگام اجرای طولانی‌مدت Playwright و Puppeteer با پروکسی چه نکاتی را باید رعایت کرد؟

مهلت زمانی (timeout) و تلاش مجدد برای خطاهای شبکه تنظیم کنید، صفحات و کانتکست‌ها را پس از اتمام ببندید و جلسات همزمان به ازای هر IP را محدود نمایید تا از خطای 429 جلوگیری شود.

  • تایم‌اوت‌های معقول برای بارگذاری (30–60 ثانیه) تنظیم کنید و منطق تلاش مجدد را برای خطاهای موقت شبکه پیاده‌سازی نمایید.
  • صفحات و contextها را پس از اتمام کار فوراً ببندید تا از نشت اتصالات غیرفعال جلوگیری شود.
  • تعداد جلسات همزمان روی یک IP واحد را محدود کنید؛ در صورت بالا بودن حجم درخواست‌ها از یک آدرس، سرویس‌های مقصد ممکن است خطای 429 بازگردانند.
  • منطقه زمانی و زبان (locale) محیط context را با کشور پروکسی هماهنگ کنید (پارامترهای timezoneId و locale در Playwright).

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

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

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

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

چرا --proxy-server=http://user:pass@IP:PORT کار نمی‌کند؟+

مرورگر Chrome نام کاربری و رمز عبور را در این آرگومان نادیده می‌گیرد. به جای آن از page.authenticate (در Puppeteer) یا پارامترهای داخلی پروکسی در Playwright استفاده کنید.

آیا می‌توان از پروکسی‌های ONET در مرورگرهای بدون سر (headless) استفاده کرد؟+

بله. عملکرد پروکسی‌ها چه در حالت headless و چه در حالت GUI کاملاً یکسان است.