Proxy Formatları: ip:port:user:pass, URL ve SOCKS5 Yazımı

Proxy formatı, bir proxy’nin host, port, kullanıcı adı, parola ve protokol bilgisinin tek satırda hangi sırayla yazıldığını gösterir. En yaygın üç biçim host:port:user:pass (panel ve liste formatı), user:pass@host:port ve http://user:pass@host:port (URL formatı) biçimleridir; SOCKS5 proxy’de aynı URL socks5:// veya socks5h:// şemasıyla yazılır.

Bilgiler her biçimde aynıdır, değişen yalnız sıra ve ayraçtır. Sorun, programların bu biçimlerden yalnız birini beklemesiyle başlar: cURL ve Python URL ister, antidetect tarayıcılar dört parçalı satırı kabul eder, Windows ve Android ise yalnız host ile port alanı gösterir. Aşağıdaki örneklerde WeProxy gateway adresi gw.weproxy.com.tr:8989 kullanılıyor; USER ve PASSWORD müşteri panelindeki bilgilerinizdir.

Proxy formatı nedir, hangi parçalardan oluşur?

Bir proxy bağlantısı en fazla beş bilgiden oluşur. Host, proxy sunucusunun alan adı ya da IP adresidir (gw.weproxy.com.tr, 203.0.113.10). Port, sunucunun bağlantı beklediği numaradır (8989). Kullanıcı adı ve parola, kimlik doğrulaması bu yolla yapılıyorsa gerekir. Protokol ise istemcinin proxy ile nasıl konuşacağını belirler (http, socks5).

Host ve port her biçimde zorunludur. Kimlik bilgisi yoksa satır host:port olarak kalır; bu durumda proxy, bağlantının geldiği IP adresine göre yetki verir (IP whitelist). Protokol çoğu formatta yazılmaz ve istemci kendi varsayılanını kullanır. Pek çok araç şemasız bir satırı HTTP proxy olarak okur; SOCKS5 proxy’yi şemasız verdiğinizde bağlantı kurulur ama ilk istekte protokol uyuşmazlığı hatası alırsınız.

HTTP ile SOCKS5 arasındaki farkı ve hangi işte hangisinin seçileceğini HTTP vs SOCKS5 yazısı anlatıyor. Hangi protokolü seçerseniz seçin, onu programa ya şema ile ya da ayrı bir açılır menüden bildirmeniz gerekir.

ip:port:user:pass formatı nasıl okunur?

ip:port:user:pass (ya da host:port:user:pass) proxy listelerinde en sık görülen biçimdir. Dört alan iki nokta üst üste ile ayrılır:

gw.weproxy.com.tr:8989:USER:PASSWORD
203.0.113.10:8989:USER:PASSWORD

Bu biçim tablolara, metin dosyalarına ve antidetect tarayıcıların toplu içe aktarma kutularına kolayca yapıştırılır. Zayıf yanı, ayracın kendisinin de veri içinde geçebilmesidir. Parolada : varsa satır beş parçaya bölünür ve hangi parçanın neye ait olduğu programın varsayımına kalır. IPv6 adresi zaten : ile yazıldığı için bu biçimde ancak köşeli parantez içinde ([2001:db8::10]:8989:USER:PASSWORD) okunabilir.

Bazı sağlayıcılar aynı dört alanı farklı sırayla verir: user:pass:host:port ya da host:port@user:pass. Program sırayı sizin listenizden tahmin etmez. İkinci alanın sayı olup olmadığına bakarak port sanır; parola yalnız rakamdan oluşuyorsa yanlış okuma hata vermeden geçer ve sonuç 407 olur. Elinizdeki listenin hangi sırayla geldiğini ilk satırdaki host ve porta bakarak doğrulayın.

URL formatı: http://user:pass@host:port nasıl yazılır?

URL biçimi, RFC 3986 ile tanımlanan genel adres yapısını kullanır:

şema://kullanıcı:parola@host:port
http://USER:[email protected]:8989

Şema proxy sunucusunun protokolünü anlatır, hedef sitenin protokolünü değil. HTTPS bir siteye HTTP proxy üzerinden gidecekseniz proxy adresi yine http:// ile başlar. İstemci proxy’ye CONNECT isteği gönderir ve TLS bağlantısı bu tünelin içinde kurulur. https:// şeması ise istemcinin proxy sunucusunun kendisiyle TLS konuşacağı anlamına gelir; proxy bunu sunmuyorsa bağlantı el sıkışmada kopar.

Şemasız user:pass@host:port biçimi de yaygındır. Programların çoğu bunu HTTP proxy olarak okur, ama her araç kabul etmez. Python’daki requests ve httpx gibi kütüphaneler şemalı tam URL’yi bekler. Kütüphaneye göre örnekler Python ile proxy kullanımı yazısında.

cURL’de URL’yi -x parametresine verirsiniz. Kimlik bilgisini adresin dışında tutmak isterseniz -U kullanılır:

curl -x "http://USER:[email protected]:8989" https://api.ipify.org
curl -x "http://gw.weproxy.com.tr:8989" -U "USER:PASSWORD" https://api.ipify.org

cURL belgelerine göre -x değerinde şema yoksa adres HTTP proxy sayılır, port yazılmazsa 1080 varsayılır. Portu her zaman açıkça yazın; aksi halde istek yanlış porta gider ve Connection refused alırsınız.

SOCKS5 proxy nasıl yazılır? socks5 ve socks5h farkı

SOCKS5 proxy’nin URL biçimi HTTP ile aynıdır, yalnız şema değişir:

socks5://USER:[email protected]:8989
socks5h://USER:[email protected]:8989

İki şema arasındaki fark alan adının nerede çözüldüğüdür. socks5:// hedef alan adını sizin bilgisayarınızda çözer ve proxy’ye IP adresini gönderir. socks5h:// alan adını olduğu gibi proxy’ye iletir, DNS çözümü proxy tarafında yapılır. İkinci biçim, DNS sorgularınızın yerel ağdan çıkmasını ve hedefin proxy’nin bulunduğu ülkeye göre çözülmesini sağlar. Ayrıntılar DNS sızıntısı rehberinde.

curl -x "socks5h://USER:[email protected]:8989" https://api.ipify.org

SOCKS5’te kullanıcı adı ve parola ayrı bir alt anlaşmayla gönderilir (RFC 1929); HTTP proxy ise aynı bilgiyi Proxy-Authorization başlığında taşır. Format yazımı iki protokolde aynı kalır. SOCKS4 ise parola alanı içermez, yalnız bir kullanıcı kimliği taşır; kullanıcı adı ve parolalı bir proxy’yi socks4:// ile yazmak kimlik doğrulamasını boşa düşürür.

WeProxy ürünlerinin çoğu HTTP ve SOCKS5’i birlikte sunar. Mobil proxy uç noktaları yalnız HTTP destekler; bu ürünü socks5:// ile yazdığınızda bağlantı kurulamaz. Protokol desteği ürün sayfasındaki teknik özellikler tablosunda yazılıdır.

Proxy formatları karşılaştırması

Kod yazıyorsanız URL biçimini esas alın: protokolü taşır, standart bir ayrıştırma kuralı vardır ve özel karakter sorunu yüzde kodlamasıyla çözülür. Liste paylaşırken ya da antidetect tarayıcıya toplu proxy eklerken host:port:user:pass daha pratiktir.

Hangi araç hangi proxy formatını ister?

Tarayıcı otomasyonunda kimlik bilgisinin URL’den ayrı istenmesi bilinçli bir tasarımdır. Chrome’un --proxy-server bayrağı user:pass@ bölümünü kabul etmez. Playwright ise proxy’yi bir nesneyle alır:

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.weproxy.com.tr:8989',
    username: 'USER',
    password: 'PASSWORD',
  },
})

Playwright belgeleri şemasız host:port değerini HTTP proxy olarak okur. Chrome kendi başına kullanıcı adı ve parolalı SOCKS5 proxy’yi desteklemez; Chrome ile otomasyonda kimlik doğrulamalı proxy için HTTP şemasını tercih edin. Puppeteer’da page.authenticate() ile tam kurulum Puppeteer entegrasyonu sayfasında.

Sistem genelinde proxy ayarı yapan Windows ve Android ekranları yalnız host ile portu alır. Kimlik doğrulaması isteyen bir proxy’yi bu ekranlara girdiğinizde bazı uygulamalar parola sorar, bazıları sormadan bağlantıyı reddeder. Adım adım kurulum entegrasyonlar sayfasındaki Windows ve Android rehberlerinde var.

Özel karakterli parola ve IPv6 adresi nasıl yazılır?

URL biçiminde @, :, /, #, ? ve % karakterlerinin özel anlamı vardır. Parolada bunlardan biri geçiyorsa yüzde kodlamasıyla yazılmalıdır:

Örneğin parolanız p@ss:9 ise URL http://USER:p%40ss%[email protected]:8989 olur. Kodlanmamış @ işareti, istemcinin parolanın geri kalanını host adı sanmasına yol açar; sonuç ya çözülemeyen bir adres hatası ya da 407 Proxy Authentication Required olur. Kodlamayı elle yapmak yerine programlama dilinin kendi işlevini kullanın:

from urllib.parse import quote

password = quote("p@ss:9", safe="")  # p%40ss%3A9
proxy = f"http://USER:{password}@gw.weproxy.com.tr:8989"

Yüzde kodlaması yalnız URL biçiminde geçerlidir. host:port:user:pass satırına %40 yazarsanız çoğu program bunu parolanın gerçek karakterleri olarak gönderir. Ayrı kullanıcı adı ve parola alanı sunan araçlara (Playwright, Proxifier, antidetect tarayıcılar) parolayı her zaman kodlamadan, olduğu gibi yazın.

IPv6 adresleri URL içinde köşeli parantezle yazılır, çünkü adresin kendi : karakterleri port ayracıyla karışır:

http://USER:PASSWORD@[2001:db8::10]:8989

Parantezsiz yazılan bir IPv6 adresi, istemcinin son iki nokta üst üstesini port ayracı sanmasına yol açar. IPv6 proxy’lerin hangi sitelerde çalıştığını IPv4 vs IPv6 yazısı anlatıyor.

Proxy listesi bir formattan diğerine nasıl çevrilir?

Panelden host:port:user:pass biçiminde aldığınız bir listeyi bir script için URL’ye çevirmeniz gerektiğinde proxy format dönüştürücü satırları toplu olarak çevirir. Araç dört giriş biçimini tanır (şema://user:pass@host:port, user:pass@host:port, host:port:user:pass, host:port) ve bunları seçtiğiniz biçime yazar. Dönüşüm tarayıcınızda yapılır, liste sunucuya gönderilmez.

Araç şu kurallarla çalışır:

• Şemasız satırlar URL biçimine http:// ile çevrilir. SOCKS5 kullanacaksanız çıktıdaki şemayı değiştirin.
• URL çıktısında kullanıcı adı ve parola yüzde kodlanır; host:port:user:pass çıktısında olduğu gibi kalır.
• Dört parçalı satırda ikinci alan port olarak okunur. user:pass:host:port sırasıyla gelen bir listeyi önce doğru sıraya getirin.
• socks5h:// şemalı satırları araç tanımaz ve “atlandı” sayısına ekler. Bu satırları socks5:// ile çevirip çıktıda şemayı geri değiştirebilirsiniz.

Aynı işi bir script içinde yapmak isterseniz, parolada : geçebileceğini hesaba katarak satırı en fazla üç kez bölün:

from urllib.parse import quote

def to_url(line: str, scheme: str = "http") -> str:
    host, port, user, password = line.strip().split(":", 3)
    return f"{scheme}://{quote(user, safe='')}:{quote(password, safe='')}@{host}:{port}"

print(to_url("gw.weproxy.com.tr:8989:USER:PASSWORD"))
# http://USER:[email protected]:8989

split(":", 3) ilk üç ayraçtan böler; parolanın içindeki : karakterleri son parçada kalır. Bu yöntem IPv6 host’larla çalışmaz, o satırları ayrı işleyin.

Proxy formatı hataları ve çözümleri

Yanlış yazılmış bir proxy satırı çoğu zaman açık bir “format hatası” vermez. Hata, bağlantının farklı bir aşamasında başka bir adla görünür:

Bir satırın doğru olup olmadığını koddan bağımsız görmek için proxy checker aracına yapıştırın. Checker’da çalışan ama programınızda çalışmayan bir satır, sorunun format ya da programın proxy ayarında olduğunu gösterir. Çıkış IP’sinin ülkesini ve ağını My IP aracında kontrol edebilirsiniz. HTTP durum kodlarının hangi katmandan geldiğini ve geçici hatalar için yeniden deneme stratejisini proxy hata kodları rehberi ayrıntılı anlatıyor.

Kimlik bilgisi içeren proxy satırları paroladır. Bunları ekran görüntüsünde, destek talebinde ya da herkese açık bir depoda paylaşmayın; kodda ortam değişkeninden okuyun ve logları paylaşmadan önce URL’deki parolayı silin. Proxy’yi hangi işte kullanırsanız kullanın, hedef sitenin kullanım şartları, robots.txt dosyası ve KVKK ile GDPR yükümlülükleri geçerlidir. WeProxy hizmetlerinde izin verilen kullanımlar kabul edilebilir kullanım sayfasında yazılıdır. Dönen ve statik IP seçeneklerini karşılaştırmak için rotating residential proxy ve statik datacenter IPv4 sayfalarına bakabilirsiniz.