# Proxy ile net::ERR_TUNNEL_CONNECTION_FAILED: nedenler ve çözümler

> Chrome, Playwright veya Puppeteer’da proxy ile net::ERR_TUNNEL_CONNECTION_FAILED: CONNECT tüneli başarısız oldu. Gizli durumu bulun ve düzeltin.

- URL: https://crawlrelay.com/tr/docs/errors/err-tunnel-connection-failed/
- Son güncelleme: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Chromium ağ hatası: her araçta tam hata mesajı, olası nedenler sırasıyla ve işe yarayan çözüm.

**Hızlı cevap — Konut proxy ile ERR_TUNNEL_CONNECTION_FAILED ne anlama gelir?**

**net::ERR_TUNNEL_CONNECTION_FAILED** demek Chrome’un proxy’den HTTPS sitesi için bir tünel açmasını istediği ama proxy’nin `200 Connection established` ile yanıt vermediği anlamına gelir. Tarayıcı gerçek durumu gizler. CrawlRelay yerleşik proxylerde sebep genellikle Playwright veya Puppeteer’da eksik kimlik bilgileri, ardından gateway’in ulaşamadığı bir hedeftir. Gerçek kodu görmek için `curl -v` ile yeniden üretin.

## ERR_TUNNEL_CONNECTION_FAILED hızlı bakış

| Özellik | Değer |
| --- | --- |
| Hata | ERR_TUNNEL_CONNECTION_FAILED |
| Tür | Chromium ağ hatası |
| Gönderen | Proxy CONNECT isteği reddettikten veya başarısız olduktan sonra tarayıcınız |
| Tanımlandığı yer | CONNECT method: RFC 9110, section 9.3.6 |
| Tekrar denemek ister misiniz? | Arkasındaki durumu bulduktan sonra |
| İlk kontrol | Gerçek durumu görmek için curl -v ile yeniden üretin |

## ERR_TUNNEL_CONNECTION_FAILED ne anlama gelir?

Bir HTTP proxy üzerinden HTTPS sayfası yüklemek için tarayıcı önce `CONNECT host:443` gönderir. Proxy 200 yanıt verirse, tarayıcı tünel içinde TLS başlatır. Başka bir yanıt (407, 403, 502 gibi) denemeyi bitirir ve Chromium bir genel hata bildirir.

Bu yüzden hata, başarısızlığın nedenini değil, nerede olduğunu (tünelde) gösterir. Neden ise proxy’nin gönderdiği durum kodudur, bunu curl ile görebilirsiniz.

## Python, curl, Node.js ve tarayıcılarda ERR_TUNNEL_CONNECTION_FAILED nasıl görünür?

Aynı başarısızlık her araçta farklı şekilde görünür. Loglarınızda aramanız gereken mesajlar şunlardır:

- **Playwright:** `page.goto: net::ERR_TUNNEL_CONNECTION_FAILED at https://...`
- **Puppeteer:** `Error: net::ERR_TUNNEL_CONNECTION_FAILED at https://...`
- **Chrome adres çubuğu:** 'Bu siteye ulaşılamıyor' ve kod `ERR_TUNNEL_CONNECTION_FAILED`
- **Chrome ile Selenium:** içindeki aynı kod `WebDriverException`

## ERR_TUNNEL_CONNECTION_FAILED neden olur?

Öncelikle en olası sebep:

- **Kimlik bilgisi gönderilmedi** (gizli 407). Chrome, `--proxy-server` içindeki kullanıcı adı ve şifreyi yok sayar.
- **Reddedilen hedef** (gizli 403), örneğin proxy kullanım politikasıyla engellenen bir kategori.
- **Ulaşılamayan hedef** (gizli 502 veya 504): ölü bir ana bilgisayar, yazım hatası veya çıkışta DNS hatası.
- **Yanlış port:** Tarayıcıyı SOCKS5 portuna HTTP gibi veya tam tersi şekilde yönlendirmek.

## ERR_TUNNEL_CONNECTION_FAILED nasıl adım adım teşhis edilir?

1. Aynı URL'yi `-v` ile curl üzerinden (aşağıdaki komut) çalıştırın ve `CONNECT` sonrasındaki satırı okuyun.
2. Bir `407` kimlik bilgisi anlamına gelir; bir `403` reddedilen hedef; `502` veya `504` ise hedef veya çıkış.
3. Tarayıcının `http://` proxy sunucusu için HTTP portunu kullandığını doğrulayın.
4. Gerçek hedefiniz öncesi `https://api.ipify.org` gibi basit bir sayfayı test edin.

*Başarısız URL'yi curl ile test edin (HTTP portu, detaylı çıktı)*

```bash
# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:PASSWORD@gw.crawlrelay.com:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL
```

## ERR_TUNNEL_CONNECTION_FAILED nasıl düzeltilir?

- **Playwright:** `server`, `username` ve `password` değerlerini her tarayıcı ya da bağlam için `proxy` seçeneğinde verin. Playwright rehberine bakın: [Playwright guide](https://crawlrelay.com/tr/docs/playwright/).
- **Puppeteer:** `--proxy-server=http://host:port` ile başlatın ve ilk `goto` öncesi `page.authenticate()` çağırın. Puppeteer rehberine bakın: [Puppeteer guide](https://crawlrelay.com/tr/docs/puppeteer/).
- **Selenium:** kimlik bilgisi ekleyen küçük bir yerel yönlendirici çalıştırın. Selenium rehberine bakın: [Selenium guide](https://crawlrelay.com/tr/docs/selenium/).
- Hedefinizi bizim [Kabul Edilebilir Kullanım Politikası](https://crawlrelay.com/tr/acceptable-use/) ile karşılaştırın.

*Playwright (Python): kimlik bilgilerini ayrı alanlar olarak kullanma*

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.crawlrelay.com:7777",
        "username": "USERNAME-country-us",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    response = page.goto("https://api.ipify.org")
    print(response.status, page.inner_text("body"))
    browser.close()
```

## ERR_TUNNEL_CONNECTION_FAILED sonrası tekrar denenmeli mi?

Sadece gizli durum öğrendikten sonra tekrar deneyin. Gizli 407 veya 403 sonsuza dek tekrarlar; yapılandırmayı düzeltin. Gizli 502 veya 504 ise yeni bir çıkışta ağ geçidi hatasında olduğu gibi tekrar edilebilir.

## ERR_TUNNEL_CONNECTION_FAILED CrawlRelay için nasıl geçerli?

CrawlRelay'in HTTP portu, tüm Chromium tabanlı araçların desteklediği `CONNECT` tünelleriyle HTTPS taşır. Tarayıcılar için HTTP portunu kullanın: Chromium, kullanıcı adı ve şifreli SOCKS5'i desteklemez.

Gateway: `gw.crawlrelay.com`, port 7777 (HTTP, HTTPS CONNECT üzerinden) ve port 7778 (SOCKS5). Kullanıcı adı formatı: `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}`. İlgili: [407 Proxy Authentication Required](https://crawlrelay.com/tr/docs/errors/407-proxy-authentication-required/) · [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/tr/docs/errors/err-proxy-connection-failed/) · [Playwright guide](https://crawlrelay.com/tr/docs/playwright/).

## ERR_TUNNEL_CONNECTION_FAILED: geliştiricilerin sorduğu sorular

### Neden curl çalışıyor ama Playwright ERR_TUNNEL_CONNECTION_FAILED gösteriyor?

Çünkü curl, proxy URL'sinden kimlik bilgilerini gönderirken Chromium, proxy sunucu adresine yazılmış kimlik bilgilerini yok sayar. Playwright'ta `username` ve `password` değerlerini `proxy` seçeneğinde ayrı alanlar olarak geçin. Puppeteer'da gezintiden önce `page.authenticate()` çağrılır.

### Chrome'da kimlik doğrulamalı SOCKS5 proxy kullanabilir miyim?

Doğrudan değil. Chromium SOCKS5 proxyleri destekler ama kullanıcı adı ve şifreli SOCKS5'i desteklemez. Bunun yerine HTTPS sitelerini CONNECT tünelleriyle yöneten gateway'in HTTP portunu kullanın veya tarayıcı için kimlik doğrulayan yerel bir yönlendirici çalıştırın.

### ERR_TUNNEL_CONNECTION_FAILED hatasına web sitesi neden olur mu?

Nadiren doğrudan olur. Tünel tarayıcı ile proxy arasındadır, dolayısıyla hata, web sitesi TLS el sıkışmasını görmeden önce gerçekleşir. Proxy bağlantı isteğine 502 veya 504 ile yanıt verip siteye ulaşılamadığında web sitesi dolaylı neden olabilir.

## Bu referanstaki diğer proxy hataları

- [401 Unauthorized vs 407](https://crawlrelay.com/tr/docs/errors/401-unauthorized/)
- [403 Forbidden](https://crawlrelay.com/tr/docs/errors/403-forbidden/)
- [407 Proxy Authentication Required](https://crawlrelay.com/tr/docs/errors/407-proxy-authentication-required/)
- [429 Too Many Requests](https://crawlrelay.com/tr/docs/errors/429-too-many-requests/)
- [502 Bad Gateway](https://crawlrelay.com/tr/docs/errors/502-bad-gateway/)
- [503 Service Unavailable](https://crawlrelay.com/tr/docs/errors/503-service-unavailable/)
- [504 Gateway Timeout](https://crawlrelay.com/tr/docs/errors/504-gateway-timeout/)
- [Cannot connect to proxy (ProxyError)](https://crawlrelay.com/tr/docs/errors/cannot-connect-to-proxy/)
- [Connection reset by peer (ECONNRESET)](https://crawlrelay.com/tr/docs/errors/connection-reset/)
- [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/tr/docs/errors/err-proxy-connection-failed/)
- [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/tr/docs/errors/err-tunnel-connection-failed/)
- [Read timed out (ReadTimeout)](https://crawlrelay.com/tr/docs/errors/read-timeout/)
- [SOCKS5 proxy errors](https://crawlrelay.com/tr/docs/errors/socks5-proxy-errors/)
- [SSL: CERTIFICATE_VERIFY_FAILED](https://crawlrelay.com/tr/docs/errors/ssl-certificate-verify-failed/)
- [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/tr/docs/errors/ssl-wrong-version-number/)

**Başarısızlık durumları için dokümanlı konut proxy'ler** $0,50/GB sitesinden süresi hiç bitmeyen CrawlRelay konut proxy [Fiyatları gör](https://crawlrelay.com/tr/pricing/) · [Hızlı başlangıç](https://crawlrelay.com/tr/docs/)

---

CrawlRelay: CrawlRelay, kazıyıcılar ve AI veri hatları için geliştirici odaklı dönen konut proxy ve 4G/5G mobil proxy hizmetidir: süresiz, kullanılan kadar ödenen trafik $0,50/GB'dan itibaren, kripto ile ödenir, kimlik yüklemesi yoktur. KYC yok — kimlik, selfie veya belge istemez. Kripto ile ödeyin.