Guide: Using Proxies with Puppeteer

Puppeteer is a powerful Node.js library that provides a high-level API for automating web browsers, mainly used for web scraping, testing, and automation tasks. In this guide, we will walk you through the process of using proxies with Puppeteer, enabling you to route your browser requests through different IP addresses and enhance your scraping or testing capabilities. Let’s get started!

Table of Contents

1. Introduction to Proxies and Puppeteer

Proxies act as intermediaries between your web browser and the websites you visit, allowing you to route your requests through different IP addresses and locations. This can be beneficial for various purposes, including bypassing restrictions, maintaining anonymity, and avoiding IP-based blocking.

Puppeteer, on the other hand, provides a powerful automation framework for controlling and interacting with web browsers programmatically. By combining Puppeteer with proxies, you can enhance your scraping or testing capabilities, simulate browsing from different locations, and avoid detection.

2. Installing Puppeteer and Required Dependencies

Before we begin, make sure you have Node.js installed on your system. You can download the latest version of Node.js from the official website ( Once Node.js is installed, open your terminal or command prompt and execute the following command to install Puppeteer:

npm install puppeteer

Puppeteer relies on a specific version of Chromium, which is automatically downloaded during the installation process.

3. Configuring Proxy Settings in Puppeteer

To use proxies with Puppeteer, you need to configure the launch method to include proxy settings. Here’s an example of how you can set up Puppeteer with a proxy:

const puppeteer = require('puppeteer');

async function run() {
  const browser = await puppeteer.launch({
    args: [

  // Rest of your Puppeteer code goes here

  await browser.close();


Replace proxy_address and proxy_port with the actual IP address and port of your proxy server. This configuration ensures that all browser requests made through Puppeteer will be routed through the specified proxy.

4. Testing the Proxy Setup

After configuring the proxy settings in Puppeteer, it’s essential to test the setup to ensure that your browser requests are being routed through the proxy successfully. You can achieve this by opening a website and checking if the IP address displayed matches the proxy IP.

const page = await browser.newPage();
await page.goto('');

The above code opens the “What is my IP” website and retrieves the displayed IP address. Compare the displayed IP with the IP of your proxy server to verify the successful proxy configuration.

5. Handling Proxy Authentication

If your proxy server requires authentication, you can provide the username and password as part of the proxy configuration. Modify the args array in the launch method to include the authentication details:

const browser = await puppeteer.launch({
  args: [

Replace username and password with the actual credentials for your proxy server. This configuration enables Puppeteer to authenticate with the proxy server before establishing a connection.

6. Proxy Rotation and Session Management

To enhance your web scraping or testing activities, you may need to rotate proxies or manage sessions effectively. Puppeteer allows you to create multiple browser instances, each with its own proxy configuration and session. This enables you to switch between different proxies or IP addresses seamlessly.

// Create a new browser instance with a specific proxy configuration
const browser = await puppeteer.launch({
  args: [

// Create another browser instance with a different proxy configuration
const anotherBrowser = await puppeteer.launch({
  args: [

// Use each browser instance for specific tasks
// ...

await browser.close();
await anotherBrowser.close();

By utilizing multiple browser instances, you can simulate user behavior from different locations and avoid detection or IP-based restrictions.

7. Best Practices for Proxy Usage

To ensure optimal usage of proxies with Puppeteer, consider the following best practices:

  • Choose reputable proxy providers that offer reliable and high-performance proxy servers.
  • Keep track of proxy server health and performance to ensure uninterrupted automation tasks.
  • Rotate proxies periodically to avoid detection and prevent IP-based restrictions.
  • Monitor response statuses, logs, and any errors related to proxy connections for troubleshooting purposes.
  • Abide by website terms of service and usage policies when scraping or automating tasks using proxies.

In this guide, we have explored the process of using proxies with Puppeteer, allowing you to route your browser requests through different IP addresses and locations. By leveraging Puppeteer’s automation capabilities and combining them with proxies, you can enhance your scraping or testing activities, maintain anonymity, and overcome IP-based restrictions.

Infinite Proxies

InfiniteProxies offers fast, reliable, and affordable proxy servers for businesses, marketers, and individuals seeking unbeatable online privacy and security. Access geo-restricted content and bypass internet censorship easily. Experience ultimate protection today.

Press ESC to close