Netzwerk- und Fernzugriff

Befehl curl

Senden Sie HTTP-Anfragen und laden Sie Daten herunter

Linux · Bash-Beispiele · Befehle, die auf dem ausgewählten Server ausgeführt werden

Wann ist curl zu verwenden?

Verwenden Sie curl, um HTTP-Antworten zu überprüfen, eine Ressource herunterzuladen oder einen API vom Server aufzurufen. Trennen Sie den Transporterfolg vom Anwendungserfolg, legen Sie sinnvolle Zeitüberschreitungen fest und halten Sie Authentifizierungstokens aus gespeicherten Befehlsbeispielen fern.

Syntax

curl [PARAMETERS] URL

Eckige Klammern kennzeichnen optionale Argumente; Auslassungspunkte bedeuten Wiederholung. Ersetzen Sie Beispieldateinamen, Benutzernamen und Serveradressen durch Ihre eigenen Werte.

Gemeinsame Optionen und Argumente

-I
Fordern Sie nur HTTP-Header mit der Methode HEAD an.
-f
Gibt einen Fehler für HTTP-Statuscodes 400 und höher zurück.
-L
Folgen Sie Weiterleitungen; -o gibt die Ergebnisdatei an.

Anwendungsbeispiele

Überprüfen Sie die Site-Header

curl -I https://example.com

Es wird eine Nur-Header-Anfrage gestellt. Einige Dienste handhaben dies anders als eine normale Inhaltsanfrage.

Laden Sie die Datei mit der Verarbeitung von HTTP-Fehlern herunter

curl --fail --location --output ./page.html https://example.com

Weiterleitungen werden befolgt und der Antworttext ersetzt die benannte lokale Datei; HTTP-Fehlerstatus verursachen Fehler.

Anfrage JSON mit Zeitlimit

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Es wird eine JSON-Antwort mit begrenzter Gesamtdauer angefordert; Der Endpunkt muss diesen API tatsächlich bereitstellen.

Hinweise und Einschränkungen

  • Bei HTTPS wird das Zertifikat standardmäßig verifiziert; Deaktivieren Sie die Prüfung über -k nicht ohne gesonderten Grund.
  • Platzieren Sie keine echten Token oder Passwörter im Befehlsverlauf und führen Sie heruntergeladene Skripte nicht ohne Überprüfung aus.

Häufige Fragen und Fehlerbehebung

Warum ist curl erfolgreich, wenn der Server eine Fehlerseite zurückgibt?

Ohne die Option „Fehler“ kann der Empfang einer HTTP-Fehlerantwort immer noch als erfolgreiche Übertragung gelten. Überprüfen Sie sowohl den HTTP-Status als auch den Befehls-Exit-Status.

Sollte ich die Zertifikatsüberprüfung deaktivieren, um HTTPS zu beheben?

Lassen Sie Vertrauen nicht als Routinelösung außer Acht. Überprüfen Sie stattdessen den Hostnamen, die Systemzeit, die Serverzertifikatskette und die Konfiguration der vertrauenswürdigen Zertifizierungsstelle.

Weitere Hilfe

Die Optionen variieren je nach Version und Distribution. Überprüfen Sie die installierte Dokumentation mit diesem Befehl: man curl.