cURL

TL;DR

# Send a single GET request and show its output on stdout.
curl http://url.of/file

# Be quiet.
curl --silent https://www.example.com
curl -s --show-error https://www.example.com

# Download files.
curl http://url.of/file -o path/to/file
curl -O http://url.of/file1 -O http://url.of/file2
curl http://url.of/file[1-24]

# Resume downloads.
curl -C - -o partial_file http://url.of/file

# Limit downloads bandwidth.
curl --limit-rate 1000B -O http://url.of/file

# Follow redirects.
curl -L http://url.of/file

# Only fetch HTTP headers from a response.
curl -I http://example.com

# Only return the HTTP status code.
curl -o /dev/null -w '%{http_code}\n' -s -I http://example.com

# Send different request types.
curl --request PUT http://example.com

# Specify headers.
curl http://example.com -H "Content-Type:application/json" http://example.com

# Skip certificate validation.
curl --insecure https://example.com

# Pass certificates for a resource.
curl --cert client.pem --key key.pem -k https://example.com
curl --cacert ca.pem https://example.com

# Authenticate.
curl -u username:password http://url.of/file
curl -u username:password -O ftp://url.of/file
curl ftp://username:password@example.com

# POST to a form.
curl -F "name=user" -F "password=test" http://example.com
curl --data 'name=bob' http://example.com/form

# Send data.
curl http://example.com -H "Content-Type:application/json" -d '{"name":"bob"}' -X POST
curl http://example.com -H "Content-Type:application/json" -d @file.json -X POST

# Use a proxy.
curl http://example.com --proxy socks5://localhost:19999

# Forcefully resolve a host to a given address.
curl https://example.com --resolve example.com:443:google.com

Apply settings to all connections

Unless the -q option is used, curl always checks for a default config file on invocation and uses it if found.

The default configuration file is looked for in the following places, in this order:

$CURL_HOME/.curlrc
$XDG_CONFIG_HOME/.curlrc, added in 7.73.0
$HOME/.curlrc
on Windows only: %USERPROFILE%\.curlrc
on Windows only: %APPDATA%\.curlrc
on Windows only: %USERPROFILE%\Application Data\.curlrc

On Non-Windows hosts, curl uses getpwuid to find the user's home directory.

On Windows, if curl finds no .curlrc file in the sequence described above, it will check for one in the same dir the curl executable is placed.

# ~/.curlrc
# Accepts both short and long options.
# Options in long format are accepted without the leading two dashes to make it
# easier to read.
# Arguments must be provided on the same line of the option.
# Arguments can be separated by space, '=' and ':'

location
--insecure
--user-agent "my-agent"
request = "PUT"
config: "~/.config/curl"

3.1 KiB Raw Blame History

cURL

TL;DR

Apply settings to all connections

Sources

3.1 KiB

Raw Blame History