Puppeteer için WeProxy proxy kurulumu

Puppeteer'da proxy bağlantısı Chromium başlatılırken --proxy-server parametresiyle tanımlanır. Kullanıcı adı ve parola gerekiyorsa sayfa açıldıktan sonra page.authenticate() kullanılır. Bu rehber yalnızca yetkili otomasyon, test ve veri erişim senaryoları içindir; hedef sitenin kullanım koşullarına ve robots politikalarına uyun.

Puppeteer'ı Kurun

npm install puppeteer

WeProxy bilgilerini ortam değişkenlerinde tutun:

export WEPROXY_HOST="PROXY_HOST"
export WEPROXY_PORT="PROXY_PORT"
export WEPROXY_USERNAME="PROXY_USERNAME"
export WEPROXY_PASSWORD="PROXY_PASSWORD"

PowerShell kullanıyorsanız export yerine $env:DEĞİŞKEN="değer" biçimini kullanın.

Kimlik Doğrulamalı HTTP Proxy Örneği

import puppeteer from 'puppeteer';

const {
  WEPROXY_HOST,
  WEPROXY_PORT,
  WEPROXY_USERNAME,
  WEPROXY_PASSWORD,
} = process.env;

const browser = await puppeteer.launch({
  headless: true,
  args: [
    `--proxy-server=http://${WEPROXY_HOST}:${WEPROXY_PORT}`,
  ],
});

try {
  const page = await browser.newPage();

  await page.authenticate({
    username: WEPROXY_USERNAME,
    password: WEPROXY_PASSWORD,
  });

  await page.goto('https://api.ipify.org?format=json', {
    waitUntil: 'domcontentloaded',
    timeout: 30_000,
  });

  console.log(await page.evaluate(() => document.body.innerText));
} finally {
  await browser.close();
}

Kullanıcı adı ve parolayı --proxy-server parametresine eklemeyin. Chromium bu biçimi güvenilir şekilde desteklemez ve komut satırındaki sırlar sistem süreç listesinde görünebilir.

IP Doğrulamalı Proxy Kullanımı

WeProxy ürününüz IP izin listesi destekliyorsa mevcut sunucu IP'nizi panelde yetkilendirin. Bu durumda page.authenticate() çağrısı gerekmeden yalnızca host ve portla bağlantı kurulabilir.

Her Tarayıcı İçin Farklı Proxy

--proxy-server tarayıcı sürecinin tamamına uygulanır. Farklı proxyler kullanmanız gerekiyorsa her proxy için ayrı bir puppeteer.launch() süreci başlatın. Tek tarayıcıdaki farklı sayfalara yerleşik olarak farklı proxy atamak mümkün değildir.

Puppeteer Proxy Hataları

ERR_PROXY_CONNECTION_FAILED

Host, port, protokol veya paket durumu yanlıştır. Önce proxyyi paneldeki test bilgileriyle doğrulayın.

ERR_TUNNEL_CONNECTION_FAILED

Proxy HTTPS hedefe tünel kuramıyor veya kimlik doğrulama tamamlanmıyor olabilir. page.authenticate() çağrısının page.goto() işleminden önce yapıldığını kontrol edin.

407 Proxy Authentication Required

Kullanıcı adı/parola hatalıdır veya ürün IP doğrulaması bekliyordur. Paneldeki doğrulama yöntemini kontrol edin.

IPv6 hedefe erişilemiyor

WeProxy IPv6 ürünü kullanıyorsanız hedef sitenin IPv6 uyumluluğunu doğrulayın. IPv4-only hedeflerde IPv6 proxy çalışmayabilir.

Güvenli ve Kararlı Kullanım İpuçları

• Kimlik bilgilerini .env dosyasıyla kullanıyorsanız dosyayı .gitignore içine ekleyin.
• Zaman aşımı ve yeniden deneme sınırları belirleyin.
• Hedef sunucuya aşırı istek göndermeyin.
• Proxy oturum modelini iş akışınıza göre statik, sticky veya rotating olarak seçin.
• Otomasyonun hedef platformun kurallarına uygun olduğundan emin olun.

Kaynak

• Puppeteer API: page.authenticate()