Komut Satırı Temelleri: Ağ İstekleri
Günümüzün dijital dünyasında, ağlar ve veri alışverişi her şeyin merkezinde yer almaktadır. Bir web sitesini ziyaret etmekten, bir API’ye veri göndermeye, bir sunucuyla iletişim kurmaya kadar her etkileşim, temelinde bir ağ isteğidir. Geliştiriciler, sistem yöneticileri ve hatta meraklı kullanıcılar için bu ağ isteklerini anlamak, oluşturmak ve hata ayıklamak kritik bir beceridir. Çoğu zaman bu işlemler için grafik arayüzlü (GUI) araçlar tercih edilse de, komut satırı araçları benzersiz bir esneklik, otomasyon potansiyeli ve düşük seviyeli kontrol sunar. Bu makale, komut satırı üzerinden ağ istekleri yapmanın temellerini ve bu alandaki en güçlü araçları derinlemesine inceleyecektir.
Komut satırı araçları, özellikle sunucu ortamlarında GUI’nin bulunmadığı durumlarda veya tekrarlayan görevleri otomatikleştirmek gerektiğinde vazgeçilmezdir. Ağ istekleri, bir web sayfasını indirmek, bir REST API’sine veri göndermek, bir sunucunun durumunu kontrol etmek veya sadece bir portun açık olup olmadığını anlamak gibi çeşitli amaçlara hizmet edebilir. Bu makalede curl, wget, httpie ve netcat gibi temel araçların kullanımı, özellikleri ve pratik uygulamaları ele alınacaktır.
Ağ İsteklerinin Temel Kavramları
Komut satırı araçlarına dalmadan önce, bir ağ isteğinin arkasındaki temel mekanizmaları anlamak önemlidir. Özellikle HTTP (Hypertext Transfer Protocol) ve HTTPS (HTTP Secure) protokolleri, web üzerindeki veri alışverişinin bel kemiğini oluşturur.
HTTP/HTTPS Metotları
Bir istemci (tarayıcınız, komut satırı aracınız) bir sunucuya istek gönderdiğinde, bu isteğin amacını belirten bir HTTP metodu kullanılır. En yaygın metotlar şunlardır:
- GET: Sunucudan veri almak için kullanılır. Örnek: Bir web sayfasını veya bir API kaynağından bilgi çekmek. Veri, URL parametreleri aracılığıyla gönderilir.
- POST: Sunucuya veri göndermek için kullanılır. Örnek: Bir form göndermek, yeni bir kaynak oluşturmak. Veri, isteğin gövdesinde (body) bulunur.
- PUT: Sunucudaki mevcut bir kaynağı güncellemek veya yeni bir kaynak oluşturmak için kullanılır. Genellikle idempotenttir (aynı isteği birden çok kez göndermek aynı sonucu verir).
- DELETE: Sunucudaki bir kaynağı silmek için kullanılır.
- HEAD: GET isteğiyle aynıdır, ancak sunucu yanıtın gövdesini göndermez, sadece başlıkları gönderir. Bir kaynağın varlığını veya meta verilerini kontrol etmek için kullanışlıdır.
- OPTIONS: Bir sunucunun belirli bir URL için hangi HTTP metotlarını desteklediğini öğrenmek için kullanılır.
HTTP Başlıkları (Headers)
HTTP başlıkları, istemci ve sunucu arasında istekle veya yanıtla ilgili meta verileri taşır. Örneğin:
User-Agent:İsteği yapan istemcinin türünü belirtir (örn. tarayıcı,curl).Content-Type:İsteğin veya yanıtın gövdesindeki verinin formatını belirtir (örn.application/json,text/html).Authorization:Kimlik doğrulama bilgileri (örn. API anahtarı, Bearer token) içerir.Accept:İstemcinin hangi medya türlerini kabul edebileceğini belirtir.
İstek Gövdesi (Request Body)
POST, PUT gibi metotlarla sunucuya gönderilen asıl veri, isteğin gövdesinde yer alır. Bu veri genellikle JSON, XML veya URL kodlu form verisi formatında olabilir.
HTTP Durum Kodları (Status Codes)
Sunucu, her isteğe bir durum kodu ile yanıt verir. Bu kodlar, isteğin başarılı olup olmadığını veya bir hata oluşup oluşmadığını gösterir:
- 1xx (Informational): İstek alındı, işlem devam ediyor.
- 2xx (Success): İstek başarıyla alındı, anlaşıldı ve kabul edildi. En yaygın olanı
200 OK‘dir. - 3xx (Redirection): İsteği tamamlamak için ek işlem yapılması gerekiyor. Örn.
301 Moved Permanently,302 Found. - 4xx (Client Error): İstekte bir hata var. Örn.
400 Bad Request,401 Unauthorized,403 Forbidden,404 Not Found. - 5xx (Server Error): Sunucuda bir hata oluştu. Örn.
500 Internal Server Error,503 Service Unavailable.
curl: Komut Satırının İsviçre Çakısı
curl (Client URL), komut satırından URL söz dizimi ile veri transferi yapmak için kullanılan güçlü ve çok yönlü bir araçtır. HTTP, HTTPS, FTP, FTPS, SCP, SFTP gibi birçok protokolü destekler ve hemen hemen her Linux/macOS sisteminde ön yüklü olarak gelir. Windows’ta da kolayca kurulabilir.
Temel GET İstekleri
Bir web sayfasının içeriğini almak için en basit curl komutu:
curl https://example.com
Bu komut, example.com adresindeki HTML içeriğini doğrudan terminale yazdırır.
Başlıkları Görüntüleme ve Kaydetme
Sadece HTTP yanıt başlıklarını görmek için -I (veya --head) parametresini kullanın:
curl -I https://example.com
Yanıt gövdesiyle birlikte başlıkları görmek için -i (veya --include) kullanın:
curl -i https://example.com
Çıktıyı bir dosyaya kaydetmek için -o (küçük o) veya -O (büyük O) parametrelerini kullanabilirsiniz. -o ile dosya adını siz belirlersiniz, -O ise URL’deki dosya adını kullanır:
curl -o anasayfa.html https://example.com
curl -O https://example.com/resim.jpg # resim.jpg olarak kaydeder
POST İstekleri ve Veri Gönderme
curl ile POST isteği yapmak oldukça yaygındır. Veriyi -d (veya --data) parametresiyle gönderebilirsiniz. Varsayılan olarak application/x-www-form-urlencoded formatında gönderir:
curl -X POST -d "isim=Ahmet&yas=30" https://api.example.com/kullanici
JSON verisi göndermek için Content-Type başlığını belirtmek önemlidir:
curl -X POST \
-H "Content-Type: application/json" \
-d '{"isim": "Ayşe", "yas": 25}' \
https://api.example.com/kullanici
Veriyi bir dosyadan okumak için @ işaretini kullanın:
curl -X POST \
-H "Content-Type: application/json" \
-d @veri.json \
https://api.example.com/kullanici
Özel Başlıklar ve Kimlik Doğrulama
Özel başlıklar eklemek için -H (veya --header) parametresini kullanın:
curl -H "User-Agent: MyCustomApp/1.0" \
-H "X-API-Key: abcdef12345" \
https://api.example.com/data
Temel kimlik doğrulama (Basic Authentication) için -u (veya --user) kullanın:
curl -u kullaniciadi:parola https://api.example.com/private
Bearer token ile kimlik doğrulama için Authorization başlığını kullanın:
curl -H "Authorization: Bearer my_secret_token" https://api.example.com/secure
Yönlendirmeleri Takip Etme ve Hata Ayıklama
HTTP 3xx yönlendirmelerini otomatik olarak takip etmek için -L (veya --location) kullanın:
curl -L http://kisa.link/ornek
Daha fazla bilgi (istek ve yanıt başlıkları, SSL bilgileri vb.) görmek için -v (veya --verbose) ile ayrıntılı çıktı alabilirsiniz. Bu, hata ayıklama için çok faydalıdır:
curl -v https://api.example.com/status
SSL Sertifikalarını Atlamak
Geliştirme ortamlarında veya kendi imzalı sertifikalarla çalışırken SSL/TLS sertifika doğrulamayı atlamak için -k (veya --insecure) kullanabilirsiniz. Ancak bu, üretim ortamlarında kesinlikle tavsiye edilmez:
curl -k https://test.internal.com/data
wget: Dosya İndirme Uzmanı
wget, ağ üzerinden dosya indirmek için tasarlanmış, ücretsiz ve etkileşimli olmayan bir komut satırı aracıdır. Özellikle büyük dosyaları indirmek ve internet sitelerinin tamamını veya bir kısmını kopyalamak için çok kullanışlıdır. curl‘dan farklı olarak, wget varsayılan olarak indirdiği dosyaları yerel dizine kaydeder ve indirme işlemlerini duraklatıp devam ettirme yeteneğine sahiptir.
Temel Dosya İndirme ve Kaydetme
Bir dosyayı indirmek için basitçe URL’yi belirtin; dosya mevcut dizininize URL’deki adıyla kaydedilir:
wget https://example.com/buyuk_dosya.zip
İndirilen dosyayı farklı bir adla kaydetmek için -O (büyük O) parametresini kullanın:
wget -O yeni_ad.zip https://example.com/buyuk_dosya.zip
İndirmeye Devam Etme ve Arka Planda Çalıştırma
Kesintiye uğramış bir indirme işlemini devam ettirmek için -c (veya --continue) kullanın. Bu özellik, özellikle büyük dosyaları indirirken ağ bağlantısı kesintileri yaşandığında hayat kurtarıcıdır:
wget -c https://example.com/cok_buyuk_dosya.iso
İndirme işlemini arka planda çalıştırmak için -b (veya --background) kullanın. Bu, terminali serbest bırakır ve indirme işlemini bir log dosyasına kaydeder:
wget -b https://example.com/dev_dosya.tar.gz
Tüm Bir Web Sitesini Kopyalama (Recursive)
wget‘in en güçlü özelliklerinden biri, bir web sitesinin veya dizinin tamamını yerel olarak kopyalama yeteneğidir. -r (recursive) parametresiyle bunu yapabilirsiniz:
wget -r -l 1 -np -k https://example.com/docs/
-r: Özyinelemeli (recursive) indirmeyi etkinleştirir.-l 1: Maksimum özyineleme derinliğini 1 olarak ayarlar (sadece belirtilen URL’nin altındaki ilk seviye bağlantıları indirir).-np: Üst dizinlere gitmez (no parent).-k: İndirilen HTML belgelerindeki bağlantıları, yerel olarak çalışacak şekilde dönüştürür.
wget, POST istekleri de yapabilse de, bu tür senaryolar için genellikle curl daha esnek ve uygun bir seçimdir.
httpie: İnsanlar İçin HTTP Komut Satırı İstemcisi
httpie (okunuşu “aitçipi”), curl‘a modern, kullanıcı dostu ve JSON odaklı bir alternatif sunar. Basit sözdizimi, renkli çıktı ve otomatik JSON işleme gibi özellikleriyle özellikle API geliştiricileri arasında popülerdir. Python ile yazılmıştır ve pip aracılığıyla kolayca kurulabilir.
Kurulum
pip install httpie
Temel GET İstekleri
httpie ile GET isteği yapmak son derece basittir:
http https://api.github.com/users/octocat
httpie, varsayılan olarak yanıtı güzelce biçimlendirilmiş (pretty-printed) ve renkli olarak gösterir, bu da okunabilirliği artırır.
POST İstekleri ve JSON Verisi
httpie‘nin en güçlü yanlarından biri, JSON verisi göndermeyi ne kadar kolaylaştırdığıdır. Anahtar-değer çiftlerini doğrudan argüman olarak geçirebilirsiniz, httpie otomatik olarak JSON’a dönüştürür ve Content-Type: application/json başlığını ekler:
http POST https://api.example.com/kullanicilar isim=Can soyisim=Yılmaz yas:=30
Not: yas:=30 syntax’ı, 30‘un bir sayı olarak işlenmesini sağlar, aksi takdirde string olarak kabul edilirdi.
Bir dosyadan JSON verisi göndermek için:
http POST https://api.example.com/kullanicilar < veri.json
Başlıklar Ekleme
Başlıkları doğrudan komut satırında belirtebilirsiniz:
http GET https://api.example.com/data Authorization:"Bearer my_token" User-Agent:"HttpieClient"
Kimlik Doğrulama
Temel kimlik doğrulama için -a (veya --auth) kullanın:
http -a kullaniciadi:parola https://api.example.com/secure
Dosya Yükleme
Dosya yüklemek için @ sözdizimini kullanın:
http POST https://api.example.com/upload file@/path/to/my/document.pdf
Çıktı Kontrolü
Sadece başlıkları görmek için -h, sadece gövdeyi görmek için -b kullanın:
http -h https://example.com # Sadece yanıt başlıklarını gösterir
http -b https://example.com # Sadece yanıt gövdesini gösterir
netcat (nc): Ağın Ham Gücü
netcat veya kısaca nc, TCP/IP protokolleri üzerinden veri okuma ve yazma için tasarlanmış, basit ama inanılmaz derecede çok yönlü bir ağ yardımcı programıdır. Genellikle "ağın İsviçre çakısı" olarak anılır çünkü port taramadan ham HTTP istekleri göndermeye kadar birçok farklı amaç için kullanılabilir. curl ve wget'in aksine, netcat HTTP protokolünü doğrudan anlamaz; bunun yerine, ham TCP/UDP soketleri üzerinde çalışır, bu da onu düşük seviyeli ağ etkileşimleri için ideal kılar.
Temel Kullanım: Bir Porta Bağlanma
Bir sunucunun belirli bir portuna bağlanmak ve manuel olarak veri göndermek için kullanabilirsiniz. Bu, bir servisin dinleyip dinlemediğini veya ham veri göndererek nasıl tepki verdiğini test etmek için faydalıdır:
nc example.com 80
Bu komut, example.com adresinin 80 numaralı portuna bir TCP bağlantısı açar. Bağlantı kurulduktan sonra, terminale yazdığınız her şey doğrudan sunucuya gönderilir.
Ham HTTP GET İsteği Yapma
netcat ile manuel olarak bir HTTP GET isteği göndermek, HTTP protokolünün nasıl çalıştığını anlamak için harika bir yoldur:
echo -e "GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n" | nc example.com 80
echo -e "...": HTTP isteği dizgesini oluşturur.\r\n, satır sonu ve satır başı karakterlerini temsil eder ve HTTP protokolünde zorunludur. İki ardışık\r\n\r\n, başlıkların bittiğini ve isteğin gövdesinin başladığını (bu örnekte boş) belirtir.|: Pipe operatörü,echokomutunun çıktısınınckomutunun girdisine yönlendirir.nc example.com 80:example.com'un 80 numaralı portuna bağlanır veecho'dan gelen veriyi gönderir.
Bu, sunucudan ham HTTP yanıtını terminale yazdıracaktır. Bu yöntem, özellikle bir HTTP sunucusunun tam olarak ne yanıt verdiğini görmek istediğinizde veya standart HTTP istemcilerinin (curl gibi) davranışını taklit etmek istediğinizde faydalıdır.
Port Taraması
netcat, bir sunucudaki açık portları kontrol etmek için de kullanılabilir. -z (zero-I/O) ve -v (verbose) parametreleriyle belirli bir port aralığını tarayabilirsiniz:
nc -zv example.com 20-100
Bu, example.com adresindeki 20 ile 100 arasındaki portları tarar ve açık olanları bildirir. Bu basit port tarama yeteneği, ağ keşfi ve güvenlik denetimleri için temel bir araçtır.
netcat'in basit dosya transferi veya geçici sohbet sunucusu/istemcisi olarak kullanımları da mevcuttur, ancak bunlar genellikle daha çok düşük seviyeli ağ iletişimini anlamak veya hızlı, geçici çözümler üretmek için tercih edilir ve doğrudan gelişmiş HTTP istekleriyle ilgili değildir.
Diğer Faydalı Komut Satırı Ağ Araçları
Ağ istekleri ve bağlantılarıyla ilgili sorun giderme ve bilgi toplama için kullanabileceğiniz başka temel komut satırı araçları da vardır:
ping
Bir ana bilgisayara ulaşılabilir olup olmadığını ve ağ gecikmesini (latency) test etmek için kullanılır. ICMP (Internet Control Message Protocol) paketleri gönderir ve yanıtları ölçer.
ping google.com
traceroute (Linux/macOS) / tracert (Windows)
Bir paketin hedef ana bilgisayara ulaşmak için izlediği yolu (router atlamaları) gösterir. Ağdaki gecikmelerin veya bağlantı sorunlarının nerede meydana geldiğini anlamak için kullanışlıdır.
traceroute google.com
nslookup / dig
DNS (Domain Name System) sorguları yapmak için kullanılır. Bir alan adının IP adresini veya diğer DNS kayıtlarını (MX, NS vb.) bulmanızı sağlar.
nslookup example.com
dig example.com
dig genellikle daha güçlü ve esnek kabul edilir.
ss / netstat
Sistemdeki mevcut ağ bağlantılarını, dinleme portlarını ve ağ istatistiklerini gösterir. ss, netstat'ın daha modern ve hızlı bir alternatifidir.
ss -tuln # TCP/UDP dinleme portlarını gösterir
netstat -tuln # Aynı işlevi görür
Neden Komut Satırı Ağ İstekleri Kullanmalı?
Grafik arayüzlü araçlar (Postman, Insomnia gibi) sunduğu kolaylıklarla popüler olsa da, komut satırı araçları birçok senaryoda üstünlük sağlar:
- Otomasyon: Komut satırı araçları, betiklere (script) kolayca entegre edilebilir. Bu, tekrarlayan görevleri otomatikleştirmek, CI/CD (Sürekli Entegrasyon/Sürekli Teslimat) süreçlerinde API testleri yapmak veya düzenli veri çekme işlemleri için idealdir.
- Hata Ayıklama ve Teşhis: Ağ sorunlarını veya API entegrasyon hatalarını ayıklarken, komut satırı araçları size ağ trafiği üzerinde düşük seviyeli ve ayrıntılı kontrol sağlar. Başlıkları, gövdeyi, durum kodlarını anında görebilirsiniz.
- Sunucu Ortamları: GUI'nin bulunmadığı uzak sunucularda veya konteynerlerde çalışırken, komut satırı araçları tek seçenektir.
- Kaynak Verimliliği: GUI uygulamalarına göre çok daha az sistem kaynağı tüketirler.
- Hız ve Verimlilik: Hızlı bir API kontrolü, bir dosya indirme veya bir port taraması için bir GUI uygulamasını açıp kapatmaktan çok daha hızlıdır.
- Öğrenme ve Anlama: Özellikle
netcatgibi araçlarla ham ağ istekleri yapmak, protokollerin nasıl çalıştığına dair derinlemesine bir anlayış geliştirmenize yardımcı olur.
En İyi Uygulamalar ve İpuçları
Komut satırı üzerinden ağ istekleri yaparken dikkat etmeniz gereken bazı önemli noktalar:
- HTTPS Kullanın: Mümkün olan her yerde HTTPS kullanın. Hassas verileri açık metin olarak göndermekten kaçının.
- Hassas Verilere Dikkat: Parolalar, API anahtarları gibi hassas bilgileri doğrudan komut satırına yazmaktan kaçının. Bu tür bilgiler komut geçmişinize (
history) kaydedilebilir. Bunun yerine, ortam değişkenleri, dosyalardan okuma (curl -d @file) veya güvenli yapılandırma dosyaları kullanın. - Durum Kodlarını Kontrol Edin: İsteklerinizin başarılı olup olmadığını anlamak için her zaman HTTP durum kodlarını kontrol edin.
- Ayrıntılı Çıktı Kullanın (
-v): Hata ayıklama yaparkencurl -vgibi ayrıntılı çıktı modlarını kullanarak isteğin ve yanıtın tüm detaylarını inceleyin. - Dokümantasyonu Okuyun: Her aracın kendi man sayfası (
man curl,man wget) ve çevrimiçi dokümantasyonu vardır. Yeni özellikler öğrenmek ve sorunları gidermek için bu kaynakları kullanmaktan çekinmeyin. - Zaman Aşımlarını Ayarlayın: Özellikle betiklerde, sonsuz bekleme durumlarını önlemek için istekleriniz için zaman aşımı (timeout) değerleri belirleyin (örn.
curl --max-time 10). - Yanıtları Filtreleyin ve İşleyin: Gelen yanıtlar genellikle büyük ve karmaşık olabilir.
jq(JSON için),grep,awk,sedgibi araçlarla yanıtları filtreleyerek veya işleyerek ihtiyacınız olan bilgiyi çıkarabilirsiniz.
Sonuç
Komut satırı, ağ istekleri yapmak ve ağ etkileşimlerini yönetmek için güçlü ve vazgeçilmez bir ortamdır. curl, wget, httpie ve netcat gibi araçlar, temel dosya indirmeden karmaşık API etkileşimlerine, düşük seviyeli port kontrolünden otomasyon betiklerine kadar geniş bir yelpazede çözümler sunar. Bu araçlarda ustalaşmak, bir geliştiricinin veya sistem yöneticisinin araç kutusunu önemli ölçüde zenginleştirir, verimliliği artırır ve ağ sorunlarını daha derinlemesine anlama yeteneği kazandırır. Komut satırının sunduğu esneklik ve kontrol, modern ağ tabanlı uygulamalarla çalışırken paha biçilmez bir avantajdır. Bu makaledeki bilgilerle, komut satırı üzerinden ağ istekleri dünyasına sağlam bir adım attığınızı umuyoruz. Şimdi sıra sizde: terminalinizi açın ve keşfetmeye başlayın!
