Síť a vzdálený přístup

Příkaz curl

Odesílejte požadavky HTTP a stahujte data

Linux · příklady Bash · příkazy spuštěné na vybraném serveru

Kdy použít curl

Použijte curl ke kontrole odpovědí HTTP, stažení zdroje nebo volání API ze serveru. Oddělte úspěšnost přenosu od úspěchu aplikace, nastavte rozumné časové limity a udržujte ověřovací tokeny mimo uložené příklady příkazů.

Syntaxe

curl [PARAMETERS] URL

Hranaté závorky označují volitelné argumenty; elipsa znamená opakování. Nahraďte vzorové názvy souborů, uživatelská jména a adresy serverů svými vlastními hodnotami.

Společné možnosti a argumenty

-I
Vyžádá pouze hlavičky HTTP pomocí metody HEAD.
-f
Při stavovém kódu HTTP 400 a vyšším vrátí chybu.
-L
Sledujte přesměrování; -o určuje výsledný soubor.

Příklady použití

Zkontrolujte záhlaví stránek

curl -I https://example.com

Je proveden požadavek pouze na záhlaví; některé služby to řeší jinak než normální požadavek na obsah.

Stáhnout soubor se zpracováním chyb HTTP

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

Přesměrování jsou následována a tělo odpovědi nahradí pojmenovaný místní soubor; Chybové stavy HTTP způsobují selhání.

Vyžádejte si JSON s časovým limitem

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

Je požadována odpověď JSON s omezenou celkovou dobou trvání; koncový bod musí ve skutečnosti poskytovat API.

Poznámky a omezení

  • U HTTPS je certifikát standardně ověřen; nezakazujte kontrolu přes -k bez zvláštního důvodu.
  • Neumisťujte skutečné tokeny nebo hesla do historie příkazů a nespouštějte stažené skripty bez ověření.

Běžné otázky a odstraňování problémů

Proč curl uspěje, když server vrátí chybovou stránku?

Bez možnosti selhání může být přijetí chybové odpovědi HTTP stále považováno za úspěšný přenos. Zkontrolujte stav HTTP i stav ukončení příkazu.

Mám zakázat ověřování certifikátu, abych opravil HTTPS?

Nevynechávejte důvěru jako rutinní opravu. Místo toho zkontrolujte název hostitele, systémový čas, řetězec certifikátů serveru a konfiguraci důvěryhodného CA.

Další pomoc

Možnosti se liší podle verze a distribuce. Zkontrolujte nainstalovanou dokumentaci pomocí tohoto příkazu: man curl.