Black FridaySpecial - USA & Europe - 100 MBPS: $2,000.00 yerine $999.00. Kupon: BLACKFRIDAY, 27 Kasım tarihine kadar.Paketi gör
WeProxy

Rehber

Playwright ve Puppeteer ile Proxy: Tarayıcı Otomasyonunda Doğru Kurulum

11 dk okuma

Playwright’ta proxy launch veya newContext çağrısındaki proxy nesnesiyle, Puppeteer’da --proxy-server ya da createBrowserContext ve page.authenticate ile tanımlanır. Context başına ayrı IP, şifreli SOCKS5 sınırı, sticky oturum, trafik tasarrufu ve hata tablosu.

Kısa cevap

  • Playwright’ta proxy, chromium.launch() ya da browser.newContext() çağrısına proxy: { server, username, password } nesnesiyle verilir; parola ayrı alanda olduğu için yüzde kodlaması gerekmez.
  • Puppeteer’da proxy adresi --proxy-server argümanıyla ya da createBrowserContext({ proxyServer }) ile verilir; kullanıcı adı ve şifre her sayfada page.goto() öncesinde page.authenticate() ile girilir.
  • Chromium kullanıcı adı ve şifreli SOCKS5 proxy’yi desteklemez: Playwright başlatma hatası verir, Puppeteer ERR_NO_SUPPORTED_PROXIES döndürür. Çözüm paketin HTTP adresi ya da proxy-chain ile yerel köprüdür.
  • Puppeteer yanlış proxy parolasında hata fırlatmaz, page.goto() 407 durumlu bir yanıt döndürür; bu yüzden yanıtın status() değeri kontrol edilmelidir.
  • Sticky oturumda her session kimliği için ayrı bir context açmak, çerezleri ve çıkış IP’sini aynı birimde tutar; GB başına ödenen paketlerde görselleri engellemek trafiği düşürür.

Playwright’ta proxy, chromium.launch() ya da browser.newContext() çağrısına verilen proxy: { server, username, password } nesnesiyle tanımlanır. Puppeteer’da adres Chrome’a --proxy-server argümanıyla ya da createBrowserContext({ proxyServer }) ile verilir, kullanıcı adı ve şifre ise page.authenticate() ile girilir. İki araçta da Chromium kullanıcı adı ve şifreli SOCKS5 proxy’yi desteklemez; bu durumda paketin HTTP adresi ya da yerel bir köprü kullanılır.

Tarayıcı otomasyonunda proxy ayarı, requests veya fetch gibi HTTP istemcilerinden farklı çalışır. Sayfanın yüklediği her görsel, script ve API çağrısı aynı proxy’den çıkar; kimlik doğrulamayı da tarayıcının kendisi yapar. Örneklerde WeProxy gateway adresi gw.weproxy.com.tr:8989 kullanılıyor. USER ve PASSWORD müşteri panelindeki bilgilerinizdir. Bütün örnekler Playwright 1.65, Puppeteer 25 ve Chrome 158 ile yerel bir test proxy’sinde çalıştırıldı.

Playwright ve Puppeteer’da proxy adresi nasıl yazılır?

İki araç da proxy sunucusunu şema://host:port biçiminde ister. Hedef site HTTPS olsa bile HTTP proxy adresi http:// ile başlar; tarayıcı proxy’ye CONNECT isteği gönderir ve TLS bağlantısını bu tünelin içinde kurar. Playwright şemasız yazılan gw.weproxy.com.tr:8989 adresini HTTP proxy sayar.

Kullanıcı adı ve şifreyi adresin içine yazmayın. Playwright bunları proxy nesnesinin ayrı alanlarında alır, Puppeteer’da ise page.authenticate() ile verilir. Bu yüzden parolada @ veya : geçse de yüzde kodlaması gerekmez; test proxy’sinde p@ss:word parolası iki araçta da kodlanmadan çalıştı. Komut satırına yazılan parola, sistemin süreç listesinde de görünür.

Kimlik bilgilerini koda gömmek yerine ortam değişkeninde tutun:

export WEPROXY_USERNAME="USER"
export WEPROXY_PASSWORD="PASSWORD"

Panelden ip:port:user:pass biçiminde liste aldıysanız proxy format dönüştürücü satırları ayırmanıza yardım eder. Biçimlerin ayrıntısı proxy formatları rehberinde.

Playwright’ta proxy nasıl kullanılır?

En kısa yol, proxy’yi tarayıcıyı başlatırken vermektir. Bu tarayıcıdan açılan bütün context ve sayfalar aynı proxy’den çıkar:

import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.weproxy.com.tr:8989',
    username: process.env.WEPROXY_USERNAME,
    password: process.env.WEPROXY_PASSWORD,
  },
});

const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body')); // {"ip":"<proxy çıkış IP’si>"}

await browser.close();

Python’daki karşılığı aynı alanları sözlük olarak alır:

import os
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.weproxy.com.tr:8989",
        "username": os.environ["WEPROXY_USERNAME"],
        "password": os.environ["WEPROXY_PASSWORD"],
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))
    browser.close()

Bazı adreslerin proxy’ye gitmemesi gerekiyorsa bypass alanına virgülle ayrılmış alan adları yazılır, örneğin bypass: 'localhost, .internal.example'. Test ortamındaki yerel servisler için kullanışlıdır. Python’da tarayıcı dışında istek atmanız gerekiyorsa Python ile proxy kullanımı yazısındaki requests ve httpx örneklerine bakın.

Playwright’ta her context’e ayrı proxy nasıl verilir?

Playwright’ta context, kendi çerezleri ve depolaması olan ayrı bir tarayıcı profilidir. Proxy’yi browser.newContext() çağrısına verirseniz tek tarayıcı süreciyle birden fazla çıkış IP’si kullanabilirsiniz:

import { chromium } from 'playwright';

const browser = await chromium.launch();

const proxied = await browser.newContext({
  proxy: {
    server: 'http://gw.weproxy.com.tr:8989',
    username: process.env.WEPROXY_USERNAME,
    password: process.env.WEPROXY_PASSWORD,
  },
});
const direct = await browser.newContext();

const p1 = await proxied.newPage();
const p2 = await direct.newPage();
await p1.goto('https://api.ipify.org');
await p2.goto('https://api.ipify.org');
console.log(await p1.textContent('body'), await p2.textContent('body'));

await browser.close();

Test sırasında proxy’li context’in bütün istekleri proxy’den geçti, ikinci context doğrudan bağlandı. Eski Playwright sürümlerinde Windows’ta context proxy’si için launch çağrısına da yer tutucu bir proxy vermek gerekiyordu; Playwright 1.65’te buna gerek kalmadı. Context’e verilen proxy, context.request ile atılan API isteklerinde de kullanılır; sayfa açmadan JSON uç noktası sorgulamak için ayrı bir HTTP istemcisi kurmanız gerekmez.

Puppeteer’da kullanıcı adı ve şifreli proxy nasıl kullanılır?

Puppeteer proxy’yi Chrome’un --proxy-server argümanıyla alır. Kimlik bilgileri her sayfada page.authenticate() ile verilir ve bu çağrı page.goto() öncesinde yapılmalıdır:

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://gw.weproxy.com.tr:8989'],
});

try {
  const page = await browser.newPage();
  await page.authenticate({
    username: process.env.WEPROXY_USERNAME,
    password: process.env.WEPROXY_PASSWORD,
  });

  const res = await page.goto('https://api.ipify.org?format=json');
  if (res.status() === 407) throw new Error('Proxy kimlik bilgisi reddedildi');
  console.log(await page.evaluate(() => document.body.innerText));
} finally {
  await browser.close();
}

Testte yanlış parolayla page.goto() hata fırlatmadı, 407 durum kodlu bir yanıt döndürdü; status() kontrolü olmayan bir script proxy hata sayfasını veri diye kaydedebilir. Puppeteer belgesine göre page.authenticate() arka planda istek yakalamayı (request interception) açar; çok sayıda sayfada bu küçük bir hız maliyeti getirir.

Proxy’nin IP whitelist ile çalıştığı paketlerde page.authenticate() gerekmez; kodun çalıştığı makinenin çıkış IP’si panelde kayıtlı olmalıdır. Hangi üründe hangi yöntemin geçerli olduğu proxy kimlik doğrulama rehberinde tablo halinde var. Kurulum adımlarının kısa hali Puppeteer entegrasyonu sayfasında.

Puppeteer’da context başına farklı proxy nasıl verilir?

--proxy-server bütün tarayıcıya uygulanır. Güncel Puppeteer sürümlerinde browser.createBrowserContext() çağrısı proxyServer ve proxyBypassList seçeneklerini alır; böylece tek Chrome sürecinde her context farklı bir proxy kullanabilir:

const browser = await puppeteer.launch();

const ctx = await browser.createBrowserContext({
  proxyServer: 'http://gw.weproxy.com.tr:8989',
  proxyBypassList: ['localhost'],
});
const page = await ctx.newPage();
await page.authenticate({
  username: process.env.WEPROXY_USERNAME,
  password: process.env.WEPROXY_PASSWORD,
});
await page.goto('https://api.ipify.org');

Kimlik bilgisi context düzeyinde değil sayfa düzeyinde verildiği için context içinde açtığınız her yeni sayfada page.authenticate() çağrısını tekrarlayın. Eski Puppeteer sürümlerinde bu seçenek yoksa her proxy için ayrı puppeteer.launch() süreci açmak gerekir.

Tarayıcı otomasyonunda SOCKS5 proxy nasıl kullanılır?

Chromium, SOCKS5 proxy’de kullanıcı adı ve şifre doğrulamasını desteklemez. Playwright bu durumda tarayıcıyı hiç başlatmaz ve Browser does not support socks5 proxy authentication hatası verir. Puppeteer’da kimlik bilgisini --proxy-server=socks5://user:pass@host:port biçiminde yazarsanız sayfa net::ERR_NO_SUPPORTED_PROXIES ile açılmaz. Kimlik doğrulamasız SOCKS5 proxy iki araçta da sorunsuz çalışır.

Paketiniz HTTP de sunuyorsa tarayıcıda HTTP adresini kullanın; sayfa trafiğinde SOCKS5’in bir avantajı yoktur. SOCKS5 şartsa çözüm, makinede kimlik doğrulamasız yerel bir HTTP köprüsü açmaktır. proxy-chain paketi bunu tek satırda yapar:

import puppeteer from 'puppeteer';
import { anonymizeProxy, closeAnonymizedProxy } from 'proxy-chain';

const user = encodeURIComponent(process.env.WEPROXY_USERNAME);
const pass = encodeURIComponent(process.env.WEPROXY_PASSWORD);
const local = await anonymizeProxy(`socks5://${user}:${pass}@gw.weproxy.com.tr:8989`);
// local: http://127.0.0.1:<port>

const browser = await puppeteer.launch({ args: [`--proxy-server=${local}`] });
const page = await browser.newPage();
await page.goto('https://api.ipify.org');
console.log(await page.evaluate(() => document.body.innerText));

await browser.close();
await closeAnonymizedProxy(local, true);

Köprü adresi URL olduğu için burada parola encodeURIComponent ile kodlanır. Yerel köprü yalnız 127.0.0.1 üzerinde dinler; aynı yöntem Playwright’ta server: local olarak da kullanılabilir. HTTP ile SOCKS5 arasındaki farkları HTTP vs SOCKS5 yazısı anlatıyor. Gerçek SIM’li Mobil 5G Proxy yalnız HTTP ile çalıştığı için bu üründe köprüye gerek kalmaz.

Playwright ve Puppeteer proxy ayarları karşılaştırması

ÖzellikPlaywrightPuppeteer
Tarayıcı geneli proxylaunch({ proxy: { server } })args: ['--proxy-server=...']
Context başına proxynewContext({ proxy })createBrowserContext({ proxyServer })
Kullanıcı adı ve şifreproxy.username, proxy.passwordHer sayfada page.authenticate()
Proxy dışında kalacak adreslerbypass: 'a.com, .b.com'proxyBypassList veya --proxy-bypass-list
Şifreli SOCKS5Desteklenmez, başlatma hatasıDesteklenmez, ERR_NO_SUPPORTED_PROXIES
Yanlış parolada davranışpage.goto() hata fırlatırpage.goto() 407 yanıtı döndürür
Dil desteğiJavaScript, Python, Java, .NETJavaScript

Playwright’ta kimlik bilgisi proxy ayarının parçası olduğu için çok context’li işlerde kod daha kısa kalır. Puppeteer ile kurulmuş bir proje varsa araç değiştirmeye gerek yok; createBrowserContext aynı esnekliği sağlar.

Hangi proxy türü tarayıcı otomasyonuna uygun?

Tarayıcı, HTTP istemcisine göre çok daha fazla trafik üretir. Tek bir ürün sayfası görselleri, fontları ve scriptleriyle birkaç megabayt tutabilir. Bu yüzden ürün seçimi hem hedefe hem de ödeme modeline göre yapılır:

İşUygun ürünNeden
Çok sayfalı scraping, SERP ve fiyat kontrolüRotating Residential IPv4Sticky ve rotating oturum, ülke ve şehir hedefleme, HTTP ve SOCKS5
Yüksek hacimli, korumasız hedeflerRotating Datacenter IPv4GB başına ödeme, 1–5 dakikalık sticky oturum
Login gerektiren uzun oturum, hesap başına sabit IPISP Proxy veya Statik Residential IPv4IP dönem boyunca değişmez; Statik Residential’da trafik sınırı yok
Mobil görünüm ve uygulama testiMobil 5G ProxyGerçek SIM, yalnız HTTP ve kullanıcı adı/şifre

GB başına ödenen ürünlerde görselleri ve medyayı engellemek trafiği belirgin şekilde düşürür. Playwright’ta context düzeyinde bir route yeterlidir:

await context.route('**/*', (route) => {
  const type = route.request().resourceType();
  return ['image', 'media', 'font'].includes(type) ? route.abort() : route.continue();
});

Fiyat veya stok okumak gibi işlerde sayfanın görünümü gerekmez; çoğu zaman metin ve JSON-LD verisi yeterlidir. Kampanya dönemlerinde fiyat izleme kurgusu Efsane Cuma fiyat takibi rehberinde ayrıntılı. Scraping işlerinde IP türü ve oturum seçimi web scraping sayfasında da anlatılıyor.

Sticky oturum tarayıcı context’leriyle nasıl eşleştirilir?

Rotating bir gateway’de proxy adresi aynı kalır, çıkış IP’si havuzdan değişir. Login, sepet veya çok adımlı form akışında ise bütün adımların aynı IP’den gitmesi gerekir. WeProxy residential havuzlarında bunun için kullanıcı adına bir session kimliği eklenir. Kullanıcı adının biçimini ve oturum süresini ürüne göre panelden alın.

Tarayıcı otomasyonunda en temiz eşleşme, her oturum için ayrı bir context açmaktır. Böylece çerezler, depolama ve çıkış IP’si aynı birimde kalır:

import { chromium } from 'playwright';

// Kullanıcı adları panelden kopyalanır; her profil kendi session ID’sini taşır.
const PROFILES = ['USER_WITH_SESSION_1', 'USER_WITH_SESSION_2'];

const browser = await chromium.launch();
for (const username of PROFILES) {
  const context = await browser.newContext({
    proxy: {
      server: 'http://gw.weproxy.com.tr:8989',
      username,
      password: process.env.WEPROXY_PASSWORD,
    },
    locale: 'tr-TR',
    timezoneId: 'Europe/Istanbul',
  });
  const page = await context.newPage();
  await page.goto('https://api.ipify.org');
  console.log(username, await page.textContent('body'));
  await context.close();
}
await browser.close();

locale ve timezoneId, sitenin dili ve tarih biçimini proxy ülkesine uygun göstermesini sağlar; Türkiye IP’siyle açılan sayfanın İngilizce tarih ya da başka para birimi göstermesini önler. İki context aynı session kimliğini paylaşmamalı. Hangi işin sticky, hangisinin rotating istediğini sticky mi rotating mi rehberi senaryo tablosuyla anlatıyor. Antidetect tarayıcılarda aynı uyum ayarları antidetect tarayıcı + proxy yazısında.

Proxy’nin çalıştığını nasıl doğrularsınız ve hatalar ne anlama gelir?

En kısa test, aynı tarayıcıda proxy’li ve proxy’siz iki context açıp api.ipify.org sonucunu karşılaştırmaktır. İki değer aynıysa proxy ayarı tarayıcıya ulaşmıyordur. Çıkış IP’sinin ülkesini ve ağını My IP aracı gösterir. Proxy’yi koddan bağımsız test etmek için proxy checker aracını kullanın; orada çalışıp tarayıcıda çalışmayan bir proxy, sorunun script ayarında olduğunu gösterir.

Test proxy’sinde Chrome 158 ile alınan hatalar:

DurumPlaywrightPuppeteer
Kimlik bilgisi hiç verilmedinet::ERR_INVALID_AUTH_CREDENTIALSnet::ERR_INVALID_AUTH_CREDENTIALS
Parola yanlışnet::ERR_HTTP_RESPONSE_CODE_FAILUREHata yok, yanıt durumu 407
Proxy’ye bağlanılamadınet::ERR_PROXY_CONNECTION_FAILEDnet::ERR_PROXY_CONNECTION_FAILED
HTTP proxy https:// ile yazıldınet::ERR_PROXY_CONNECTION_FAILEDnet::ERR_PROXY_CONNECTION_FAILED
Şifreli SOCKS5Browser does not support socks5 proxy authenticationnet::ERR_NO_SUPPORTED_PROXIES

Kimlik hatalarında yeniden denemek sonucu değiştirmez; önce paketin aktif olduğunu ve kullanıcı adının panelle aynı olduğunu kontrol edin. ERR_PROXY_CONNECTION_FAILED sürekli geliyorsa bulunduğunuz ağ ya da bulut sağlayıcınız 8989 portuna çıkışı kapatıyor olabilir. Proxy bağlantısı kurulduktan sonra hedeften gelen 403 ve 429 gibi kodların hangi katmandan geldiği proxy hata kodları rehberinde anlatılıyor. Bu kodlarda aralığı giderek açılan yeniden deneme ve daha düşük eşzamanlılık genellikle yeterlidir.

Tarayıcı otomasyonunda uyum ve güvenlik

Veri toplayan bir otomasyon yazıyorsanız istekler proxy’den çıksa da hedefin robots.txt dosyasına (RFC 9309) ve kullanım şartlarına uyun, eşzamanlı context sayısını sitenin kaldırabileceği düzeyde tutun. Kişisel veri işliyorsanız KVKK ve GDPR yükümlülükleri proxy’den bağımsız olarak geçerlidir. WeProxy hizmetlerinde izin verilen ve verilmeyen kullanımlar kabul edilebilir kullanım sayfasında yazılı.

Ekran görüntüsü ve trace dosyaları sayfa içeriğini, bazen de oturum çerezlerini içerir; bunları paylaşmadan önce kontrol edin. Proxy parolasını loglara ve hata mesajlarına yazdırmayın. Tarayıcı dışındaki istekler için Node.js ile proxy kullanımı yazısındaki undici ve axios örnekleri, Playwright ile aynı proxy bilgileriyle çalışır. Ayrıntılı API seçenekleri Playwright proxy belgesinde ve Puppeteer BrowserContextOptions belgesinde.

Sık sorulan sorular

Playwright’ta kullanıcı adı ve şifreli proxy nasıl tanımlanır?

chromium.launch() ya da browser.newContext() çağrısına proxy nesnesi verin: server alanına http://host:port adresini, username ve password alanlarına panel bilgilerinizi yazın. Kimlik bilgileri adresin içine yazılmadığı için parolada @ veya : geçse de kodlama gerekmez. Python’da aynı alanlar p.chromium.launch(proxy={...}) sözlüğüyle verilir. Bu tarayıcıdan açılan bütün context ve sayfalar aynı proxy’den çıkar.

Puppeteer’da proxy kimlik doğrulaması nasıl yapılır?

Tarayıcıyı --proxy-server=http://host:port argümanıyla başlatın, her yeni sayfada page.goto() öncesinde page.authenticate({ username, password }) çağırın. Kimlik bilgisini --proxy-server adresine eklemeyin; Chromium bu biçimi desteklemez ve parola süreç listesinde görünür. Yanlış parolada Puppeteer hata fırlatmaz, 407 durumlu yanıt döndürür; bu yüzden page.goto() sonucunun status() değerini kontrol edin.

Tek tarayıcıda farklı sayfalar farklı proxy kullanabilir mi?

Evet, context düzeyinde. Playwright’ta her browser.newContext() çağrısına ayrı proxy nesnesi verilir. Güncel Puppeteer sürümlerinde browser.createBrowserContext({ proxyServer }) aynı işi görür, kimlik bilgisi yine page.authenticate() ile girilir. Aynı context içindeki sayfalar aynı proxy’yi paylaşır; sayfa başına ayrı proxy için her sayfaya ayrı context açın.

Playwright neden “Browser does not support socks5 proxy authentication” hatası veriyor?

Chromium, SOCKS5 proxy’de kullanıcı adı ve şifre doğrulamasını desteklemez; Playwright bunu tarayıcıyı başlatmadan önce yakalar. Paketiniz HTTP de sunuyorsa tarayıcıda HTTP adresini kullanın. SOCKS5 şartsa proxy-chain paketinin anonymizeProxy fonksiyonuyla 127.0.0.1 üzerinde kimlik doğrulamasız bir HTTP köprüsü açıp tarayıcıya o adresi verin.

Tarayıcı otomasyonunda proxy trafiği nasıl azaltılır?

Görseller, fontlar ve videolar trafiğin büyük kısmını oluşturur. Playwright’ta context.route() ile image, media ve font türündeki istekleri abort edin; Puppeteer’da aynı iş page.setRequestInterception(true) ile yapılır. Fiyat, stok veya metin okuyan işlerde sayfanın görünümü gerekmez. GB başına ödenen rotating paketlerde bu ayar tüketimi belirgin şekilde düşürür.

Başlayın

Proxy Altyapınızı Bugün Test Edin

Ücretsiz araçlarla bağlantınızı kontrol edin veya size uygun paketi seçmek için satış ekibiyle konuşun.