Skip to content

curl Bayrakları açıklaması

Gün gün kullandığınız curl bayrakları, işe göre gruplanmış: isteği şekillendirme, başlık ayarlama, kimlik doğrulama, kimlik sunma, çıktıyı denetleme, yönlendirmeleri izleme, bağlantıyı ayarlama ve hata ayıklama. Her satır, bayrağı gerçekçi bir çağrıyla eşleştirir.

curl bir HTTP isteği gönderir ve yanıt gövdesini yazdırır. Gücünün çoğu bayraklardadır: yöntemi seçerler, başlık ve veri eklerler, kimlik doğrulamayı yönetirler ve neyin yazdırılacağına karar verirler. Daha net olduğu yerde uzun biçim gösterilir; kısa biçim tek harftir. URL'leri tırnak içine alın ki shell sorgu dizisini yutmasın.

Referans tablosu · 54 kayıt
54 of 54 rows
İstek şekli
HTTP yöntemini ayarlar.curl -X POST https://api.test
Bir istek başlığı ekler.curl -H "Accept: application/json" URL
Gövde gönderir (POST ve varsayılan içerik türünü ayarlar).curl -d "name=Ada" URL
-d değerlerini bir GET üzerine sorgu parametresi olarak ekler.curl -G -d "q=hi" URL
Multipart form verisi gönderir (dosya yüklemeleri).curl -F "file=@photo.png" URL
URL kodlaması uygulanmış form verisi gönderir.curl --data-urlencode "name=Ada Lovelace" URL
PUT ile bir dosya yükler.curl -T big.zip URL
Yüklemeyi uzak dosyayı değiştirmek yerine ona ekler.curl -a -T log.txt ftp://server.test/logs/log.txt
JSON ve API'ler
Doğru içerik türüyle JSON gönderir.curl -H "Content-Type: application/json" -d '{"a":1}' URL
Bir dosyanın içeriğini gövde olarak gönderir.curl -d @body.json URL
Başlıkları elle ayarlamadan JSON gönderir (curl 7.82+).curl --json '{"a":1}' URL
Kimlik doğrulama
Kullanıcı adı ve parolayla HTTP Basic kimlik doğrulaması.curl -u ada:s3cr3t URL
Bir OAuth bearer token'ı gönderir.curl --oauth2-bearer TOKEN URL
Herhangi bir token şemasını elle gönderir.curl -H "Authorization: Bearer TOKEN" URL
Karşılıklı TLS için istemci sertifikasını ve anahtarını sunar.curl --cert client.pem --key key.pem URL
Sunucuyu tek bir CA paket dosyasına karşı doğrular.curl --cacert ca.pem URL
Sunucuyu bir CA dizinine karşı doğrular.curl --capath /etc/ssl/certs URL
İsteği bir proxy üzerinden gönderir.curl -x http://proxy.test:8080 URL
Yalnızca proxy atlaması için TLS doğrulamasını atlar.curl -x https://proxy.test:8443 --proxy-insecure URL
En düşük sürüm olarak TLS 1.3 gerektirir.curl --tlsv1.3 URL
Kimlik
Özel bir User-Agent dizisi gönderir.curl -A "Mozilla/5.0" URL
Bir Referer başlığı gönderir.curl -e https://example.com/page URL
İstekle birlikte çerez gönderir.curl -b "session=abc123" URL
Yanıt çerezlerini bir dosyaya kaydeder.curl -c cookies.txt URL
Çıktı
Gövdeyi bir dosyaya yazar.curl -o page.html URL
Gövdeyi uzak dosya adını kullanarak kaydeder.curl -O https://site/file.tgz
Yanıt başlıklarını gövdenin üstüne yazdırır.curl -i URL
Yalnızca başlıkları alır (HEAD gönderir).curl -I URL
İlerleme ölçeri ve hataları gizler.curl -s URL
Gövdeden sonra bir biçim dizisi yazdırır (zamanlama, durum).curl -w "%{http_code}\n" -o /dev/null URL
HTTP hatalarında sıfır olmayan kodla çıkar ve hata gövdesini atlar.curl -f URL
HTTP hatalarında sıfır olmayan kodla çıkar ama gövdeyi yine de yazdırır.curl --fail-with-body URL
Kaydedilen dosyayı Content-Disposition başlığından adlandırır.curl -OJ URL
Yarıda kalan aktarımı kaldığı yerden sürdürür.curl -C - -O URL
Varsayılan ölçer yerine bir ilerleme çubuğu gösterir.curl -# -O URL
Sessiz çalışırken bile hataları yazdırır.curl -sS URL
Yanıt başlıklarını bir dosyaya yazar.curl -D headers.txt URL
Sıkıştırılmış yanıt ister ve kodunu çözer.curl --compressed URL
-o yolunda eksik dizinleri oluşturur.curl -o cache/api/data.json --create-dirs URL
Yönlendirmeler ve bağlantı
3xx yönlendirmelerini izler.curl -L URL
TCP bağlantısı için beklenecek azami saniye.curl --connect-timeout 5 URL
Tüm istek için azami saniye.curl --max-time 30 URL
TLS sertifika doğrulamasını atlar.curl -k https://self-signed.test
Geçici hataları en fazla N kez yeniden dener.curl --retry 3 URL
Yalnızca geçici olanlar değil her hatada yeniden dener.curl --retry 3 --retry-all-errors URL
Bağlantıyı IPv4 veya IPv6 üzerinden zorlar.curl -4 URL
Bir ana makineyi ve portu bir adrese eşler, DNS'i atlar.curl --resolve api.test:443:127.0.0.1 https://api.test
Aktarımı bir ağ arayüzüne veya adrese bağlar.curl --interface eth0 URL
Birden çok URL'yi aynı anda aktarır.curl -Z URL1 URL2
Aktarım için HTTP/2 veya HTTP/3 kullanır.curl --http3 URL
Gövdeyi tamponlamak yerine geldikçe akıtır.curl -N URL
Daha fazla bayrağı bir yapılandırma dosyasından okur.curl -K flags.cfg URL
Hata ayıklama
Tam istek ve yanıt alışverişini yazdırır.curl -v URL
Gönderilen ve alınan her şeyi hex-dump eder.curl --trace - URL