Rete e accesso remoto

Comando curl

Invia richieste HTTP e scarica dati

Linux · Esempi Bash · i comandi vengono eseguiti sul server selezionato

Quando utilizzare curl

Utilizza curl per esaminare le risposte HTTP, scaricare una risorsa o chiamare un API dal server. Separa il successo del trasporto dal successo dell'applicazione, imposta timeout ragionevoli e mantieni i token di autenticazione fuori dagli esempi di comandi salvati.

Sintassi

curl [PARAMETERS] URL

Le parentesi quadre contrassegnano gli argomenti facoltativi; i puntini di sospensione significano ripetizione. Sostituisci nomi di file di esempio, nomi utente e indirizzi di server con i tuoi valori.

Opzioni e argomenti comuni

-I
Richiedi solo intestazioni HTTP, utilizzando il metodo HEAD.
-f
Restituisce un errore per i codici di stato HTTP 400 e successivi.
-L
Segui i reindirizzamenti; -o specifica il file dei risultati.

Esempi di utilizzo

Controlla le intestazioni del sito

curl -I https://example.com

Viene effettuata una richiesta di sola intestazione; alcuni servizi lo gestiscono in modo diverso da una normale richiesta di contenuto.

Scarica il file con l'elaborazione degli errori HTTP

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

Vengono seguiti i reindirizzamenti e il corpo della risposta sostituisce il file locale denominato; Gli stati di errore HTTP causano il fallimento.

Richiesta JSON con limite di tempo

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

Viene richiesta una risposta JSON con durata complessiva limitata; l'endpoint deve effettivamente fornire che API.

Note e limitazioni

  • Con HTTPS il certificato è verificato di default; non disabilitare il controllo tramite -k senza un motivo separato.
  • Non inserire token o password reali nella cronologia dei comandi e non eseguire script scaricati senza verifica.

Domande comuni e risoluzione dei problemi

Perché curl riesce quando il server restituisce una pagina di errore?

Senza l'opzione di errore, la ricezione di una risposta di errore HTTP può comunque essere considerata un trasferimento riuscito. Ispezionare sia lo stato HTTP che lo stato di uscita del comando.

Devo disabilitare la verifica del certificato per correggere HTTPS?

Non ignorare la fiducia come soluzione di routine. Controlla invece il nome host, l'ora del sistema, la catena di certificati del server e la configurazione della CA attendibile.

Ulteriore aiuto

Le opzioni variano in base alla versione e alla distribuzione. Controlla la documentazione installata con questo comando: man curl.