Authentification proxy Puppeteer avec des IPs proxy résidentiels et mobiles 4G

Comment configurer un proxy unique et authentifié ?

C’est le schéma minimal. Le bloc try … finally ferme Chrome même si la navigation échoue, ce qui est important sur serveurs où les instances orphelines s’empilent.

import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gw.crawlrelay.com:7777"],
});
try {
  const page = await browser.newPage();
  await page.authenticate({ username: "USERNAME-country-us", password: "PASSWORD" });
  await page.setRequestInterception(true);
  page.on("request", (req) =>
    ["image", "font", "media"].includes(req.resourceType()) ? req.abort() : req.continue()
  );
  const res = await page.goto("https://example.com/", { waitUntil: "domcontentloaded", timeout: 60000 });
  console.log(res.status(), await page.title());
} finally {
  await browser.close();
}

Comment exécuter plusieurs sessions ou pays dans un seul navigateur ?

Créez un contexte navigateur par session. Un contexte est un profil isolé avec ses cookies, cache et état réseau, ainsi les identifiants d’un contexte ne fuient pas vers un autre. Donnez à chaque contexte un nom d'utilisateur avec son pays ou ID de session propre.

import puppeteer from "puppeteer";
import { randomUUID } from "node:crypto";

const GATEWAY = "http://gw.crawlrelay.com:7777";
const browser = await puppeteer.launch();

async function visit(country, url) {
  const session = randomUUID().replaceAll("-", "").slice(0, 10);
  const context = await browser.createBrowserContext({ proxyServer: GATEWAY });
  try {
    const page = await context.newPage();
    await page.authenticate({
      username: `USERNAME-country-${country}-session-${session}-ttl-20`,
      password: "PASSWORD",
    });
    await page.goto(url, { waitUntil: "domcontentloaded", timeout: 60000 });
    return { country, session, ip: await page.evaluate(() => document.body.innerText.trim()) };
  } finally {
    await context.close();
  }
}

try {
  const results = await Promise.all([
    visit("us", "https://api.ipify.org"),
    visit("gb", "https://api.ipify.org"),
  ]);
  console.table(results);
} finally {
  await browser.close();
}

Pourquoi Puppeteer affiche-t-il 407 ou ERR_TUNNEL_CONNECTION_FAILED ?

Parce que Chrome n’a pas envoyé les bons identifiants ou aucun. Vérifiez trois points :

1. page.authenticate() s’exécute avant la première goto sur la page.
2. Le flag --proxy-server ou proxyServer ne contient que le schéma, l’hôte et le port, sans partie user:pass@.
3. Le nom d’utilisateur est sans erreur dans sa partie ciblée : testez-le avec curl d’abord, comme indiqué sur la page 407.

Si curl fonctionne avec le même nom et mot de passe mais que Puppeteer échoue, consultez ERR_TUNNEL_CONNECTION_FAILED.

Combien coûte en trafic une page Puppeteer ?

Tout ce que Chrome télécharge est facturé : HTML, scripts, styles, images, polices et appels API de la page. Le HTTP Archive Web Almanac 2025 a mesuré un poids médian de 2 164 KB sur mobile et 2 412 KB sur desktop. Bloquer images, polices et médias via interception réduit souvent à quelques centaines de kilo-octets, et retourner les réponses en cache pour scripts répétés réduit encore. Utilisez des IPs mobiles 4G rotatives seulement pour les pages qui en ont besoin : le trafic mobile coûte 1,50 $US/GB dès 5 GB, résidentiel 0,50 $US/GB dès 50 GB.