Integração com Puppeteer e Playwright

Um guia para programadores com exemplos de código completos para encaminhar scrapers automatizados de Puppeteer e Playwright através dos canais móveis da XProxy, incluindo o tratamento da autenticação do proxy e a rotação automática de IP.

Exportação de proxy e definições de porta na consola XProxy

Integração do Puppeteer (Node.js)

O Puppeteer permite-lhe passar um servidor proxy nos argumentos de arranque. Se a sua XProxy exigir autenticação, deve usar page.authenticate() antes de navegar.

puppeteer_example.js
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    headless: true,
    args: [
      // Route all traffic through XProxy SOCKS5 or HTTP port
      '--proxy-server=socks5://192.168.6.7:5001' 
    ]
  });

  const page = await browser.newPage();

  // If XProxy auth is enabled, authenticate here:
  await page.authenticate({
    username: 'your_xproxy_username',
    password: 'your_xproxy_password'
  });

  await page.goto('https://httpbin.org/ip');
  const body = await page.evaluate(() => document.body.innerText);
  console.log('Exit IP:', body);

  await browser.close();
})();

Integração do Playwright (Node.js)

O Playwright suporta configurações de proxy de forma nativa nas opções de arranque do navegador, incluindo os parâmetros de credenciais. Isto dispensa a necessidade de um passo separado de autenticação da página.

playwright_example.js
const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({
    proxy: {
      server: 'socks5://192.168.6.7:5001',
      // Optional credentials if authentication is enabled in XProxy Settings:
      username: 'your_xproxy_username',
      password: 'your_xproxy_password'
    }
  });

  const context = await browser.newContext();
  const page = await context.newPage();

  await page.goto('https://httpbin.org/ip');
  const body = await page.locator('body').innerText();
  console.log('Exit IP:', body);

  await browser.close();
})();

Integração do Playwright (Python)

Para programadores de Python que executam automação web ou verificadores de classificação SEO:

playwright_example.py
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(
        proxy={
            "server": "socks5://192.168.6.7:5001",
            # Optional credentials:
            "username": "your_xproxy_username",
            "password": "your_xproxy_password"
        }
    )
    
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print("Exit IP:", page.inner_text("body"))
    
    browser.close()

Acionar a rotação de IP em scripts

Se precisar de um novo endereço IP em cada execução ou ciclo do seu script, faça um simples pedido HTTP GET à API de rotação baseada em posição da XProxy antes de navegar:

Acionador de rotação em Node.js
const axios = require('axios');

async function rotateIP() {
  try {
    const response = await axios.get('http://192.168.6.7:8081/api/v1/rotate_ip/position/1');
    console.log('Rotate response:', response.data);
    // Wait 5-8 seconds for 4G/5G cellular reconnection to complete
    await new Promise(resolve => setTimeout(resolve, 6000));
  } catch (error) {
    console.error('IP rotation failed:', error.message);
  }
}

Why High-Quality SOCKS5 UDP & Mobile Proxies Matter for Puppeteer & Playwright

Using cheap datacenter proxies or basic HTTP proxies in antidetect profiles leads to instant account suspensions on Facebook, Google, TikTok, and Amazon. Here is why XProxy's self-hosted 4G/5G mobile proxies deliver superior anonymity and trust:

  • SOCKS5 with Full UDP Support: Unlike standard HTTP proxies that drop UDP packets, XProxy SOCKS5 proxies fully support UDP datagrams. This ensures WebRTC, DNS queries, and real-time audio/video sockets route securely through your proxy without revealing your real IP address.
  • Instant REST API IP Rotation: Trigger cellular IP rotation on demand via simple HTTP GET requests (e.g. http://192.168.6.7:8081/api/v1/rotate_ip/position/1). Reconnect 4G/5G USB modems in 3 to 8 seconds with zero proxy dropouts.
  • 100% WebRTC & DNS Leak Protection: Combined with XProxy's local LAN gateway and TCP OS Spoofing, your browser profiles maintain pristine anonymity scores on BrowserLeaks, Whoer, Pixelscan, and IPhey.
  • Carrier-Grade NAT (CGNAT) Trust: Mobile carrier IPs are shared by thousands of active smartphone users. Major platforms never ban mobile IP ranges, granting your accounts maximum trust.
🚀 Build Your Own 4G/5G Proxy Farm

Stop Paying Monthly Rented Proxy Fees

XProxy hardware & software lets you own private mobile proxy channels with unlimited data, zero bandwidth caps, SOCKS5 UDP support, and instant REST API IP rotation (Puppeteer & Playwright).

XProxy XH22 4G 5G Mobile Proxy Hardware Kit