Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия |
system:curl [2017/01/04 20:36] – mirocow | system:curl [2024/02/09 02:44] (текущий) – mirocow |
---|
| {{tag>curl fetch wget client "http client"}} |
| |
====== CURL ====== | ====== CURL ====== |
| |
| | **Method** | **Command** | |
| | **curl** | sh -c "$(curl -fsSL https://raw.site/install.sh)" | |
| | **wget** | sh -c "$(wget -O- https://raw.site/install.sh)" | |
| | **fetch** | sh -c "$(fetch -o - https://raw.site/install.sh)" | |
| |
| <code> |
| Options: (H) means HTTP/HTTPS only, (F) means FTP only |
| --anyauth Pick "any" authentication method (H) |
| -a, --append Append to target file when uploading (F/SFTP) |
| --basic Use HTTP Basic Authentication (H) |
| --cacert FILE CA certificate to verify peer against (SSL) |
| --capath DIR CA directory to verify peer against (SSL) |
| -E, --cert CERT[:PASSWD] Client certificate file and password (SSL) |
| --cert-type TYPE Certificate file type (DER/PEM/ENG) (SSL) |
| --ciphers LIST SSL ciphers to use (SSL) |
| --compressed Request compressed response (using deflate or gzip) |
| -K, --config FILE Read config from FILE |
| --connect-timeout SECONDS Maximum time allowed for connection |
| -C, --continue-at OFFSET Resumed transfer OFFSET |
| -b, --cookie STRING/FILE Read cookies from STRING/FILE (H) |
| -c, --cookie-jar FILE Write cookies to FILE after operation (H) |
| --create-dirs Create necessary local directory hierarchy |
| --crlf Convert LF to CRLF in upload |
| --crlfile FILE Get a CRL list in PEM format from the given file |
| -d, --data DATA HTTP POST data (H) |
| --data-ascii DATA HTTP POST ASCII data (H) |
| --data-binary DATA HTTP POST binary data (H) |
| --data-urlencode DATA HTTP POST data url encoded (H) |
| --delegation STRING GSS-API delegation permission |
| --digest Use HTTP Digest Authentication (H) |
| --disable-eprt Inhibit using EPRT or LPRT (F) |
| --disable-epsv Inhibit using EPSV (F) |
| --dns-servers DNS server addrs to use: 1.1.1.1;2.2.2.2 |
| --dns-interface Interface to use for DNS requests |
| --dns-ipv4-addr IPv4 address to use for DNS requests, dot notation |
| --dns-ipv6-addr IPv6 address to use for DNS requests, dot notation |
| -D, --dump-header FILE Write the headers to FILE |
| --egd-file FILE EGD socket path for random data (SSL) |
| --engine ENGINE Crypto engine (use "--engine list" for list) (SSL) |
| -f, --fail Fail silently (no output at all) on HTTP errors (H) |
| -F, --form CONTENT Specify HTTP multipart POST data (H) |
| --form-string STRING Specify HTTP multipart POST data (H) |
| --ftp-account DATA Account data string (F) |
| --ftp-alternative-to-user COMMAND String to replace "USER [name]" (F) |
| --ftp-create-dirs Create the remote dirs if not present (F) |
| --ftp-method [MULTICWD/NOCWD/SINGLECWD] Control CWD usage (F) |
| --ftp-pasv Use PASV/EPSV instead of PORT (F) |
| -P, --ftp-port ADR Use PORT with given address instead of PASV (F) |
| --ftp-skip-pasv-ip Skip the IP address for PASV (F) |
| --ftp-pret Send PRET before PASV (for drftpd) (F) |
| --ftp-ssl-ccc Send CCC after authenticating (F) |
| --ftp-ssl-ccc-mode ACTIVE/PASSIVE Set CCC mode (F) |
| --ftp-ssl-control Require SSL/TLS for FTP login, clear for transfer (F) |
| -G, --get Send the -d data with a HTTP GET (H) |
| -g, --globoff Disable URL sequences and ranges using {} and [] |
| -H, --header LINE Pass custom header LINE to server (H) |
| -I, --head Show document info only |
| -h, --help This help text |
| --hostpubmd5 MD5 Hex-encoded MD5 string of the host public key. (SSH) |
| -0, --http1.0 Use HTTP 1.0 (H) |
| --http1.1 Use HTTP 1.1 (H) |
| --http2 Use HTTP 2 (H) |
| --ignore-content-length Ignore the HTTP Content-Length header |
| -i, --include Include protocol headers in the output (H/F) |
| -k, --insecure Allow connections to SSL sites without certs (H) |
| --interface INTERFACE Use network INTERFACE (or address) |
| -4, --ipv4 Resolve name to IPv4 address |
| -6, --ipv6 Resolve name to IPv6 address |
| -j, --junk-session-cookies Ignore session cookies read from file (H) |
| --keepalive-time SECONDS Wait SECONDS between keepalive probes |
| --key KEY Private key file name (SSL/SSH) |
| --key-type TYPE Private key file type (DER/PEM/ENG) (SSL) |
| --krb LEVEL Enable Kerberos with security LEVEL (F) |
| --libcurl FILE Dump libcurl equivalent code of this command line |
| --limit-rate RATE Limit transfer speed to RATE |
| -l, --list-only List only mode (F/POP3) |
| --local-port RANGE Force use of RANGE for local port numbers |
| -L, --location Follow redirects (H) |
| --location-trusted Like '--location', and send auth to other hosts (H) |
| --login-options OPTIONS Server login options (IMAP, POP3, SMTP) |
| -M, --manual Display the full manual |
| --mail-from FROM Mail from this address (SMTP) |
| --mail-rcpt TO Mail to this/these addresses (SMTP) |
| --mail-auth AUTH Originator address of the original email (SMTP) |
| --max-filesize BYTES Maximum file size to download (H/F) |
| --max-redirs NUM Maximum number of redirects allowed (H) |
| -m, --max-time SECONDS Maximum time allowed for the transfer |
| --metalink Process given URLs as metalink XML file |
| --negotiate Use HTTP Negotiate (SPNEGO) authentication (H) |
| -n, --netrc Must read .netrc for user name and password |
| --netrc-optional Use either .netrc or URL; overrides -n |
| --netrc-file FILE Specify FILE for netrc |
| -: --next Allows the following URL to use a separate set of options |
| --no-alpn Disable the ALPN TLS extension (H) |
| -N, --no-buffer Disable buffering of the output stream |
| --no-keepalive Disable keepalive use on the connection |
| --no-npn Disable the NPN TLS extension (H) |
| --no-sessionid Disable SSL session-ID reusing (SSL) |
| --noproxy List of hosts which do not use proxy |
| --ntlm Use HTTP NTLM authentication (H) |
| --oauth2-bearer TOKEN OAuth 2 Bearer Token (IMAP, POP3, SMTP) |
| -o, --output FILE Write to FILE instead of stdout |
| --pass PASS Pass phrase for the private key (SSL/SSH) |
| --post301 Do not switch to GET after following a 301 redirect (H) |
| --post302 Do not switch to GET after following a 302 redirect (H) |
| --post303 Do not switch to GET after following a 303 redirect (H) |
| -#, --progress-bar Display transfer progress as a progress bar |
| --proto PROTOCOLS Enable/disable PROTOCOLS |
| --proto-redir PROTOCOLS Enable/disable PROTOCOLS on redirect |
| -x, --proxy [PROTOCOL://]HOST[:PORT] Use proxy on given port |
| --proxy-anyauth Pick "any" proxy authentication method (H) |
| --proxy-basic Use Basic authentication on the proxy (H) |
| --proxy-digest Use Digest authentication on the proxy (H) |
| --proxy-negotiate Use HTTP Negotiate (SPNEGO) authentication on the proxy (H) |
| --proxy-ntlm Use NTLM authentication on the proxy (H) |
| -U, --proxy-user USER[:PASSWORD] Proxy user and password |
| --proxy1.0 HOST[:PORT] Use HTTP/1.0 proxy on given port |
| -p, --proxytunnel Operate through a HTTP proxy tunnel (using CONNECT) |
| --pubkey KEY Public key file name (SSH) |
| -Q, --quote CMD Send command(s) to server before transfer (F/SFTP) |
| --random-file FILE File for reading random data from (SSL) |
| -r, --range RANGE Retrieve only the bytes within RANGE |
| --raw Do HTTP "raw"; no transfer decoding (H) |
| -e, --referer Referer URL (H) |
| -J, --remote-header-name Use the header-provided filename (H) |
| -O, --remote-name Write output to a file named as the remote file |
| --remote-name-all Use the remote file name for all URLs |
| -R, --remote-time Set the remote file's time on the local output |
| -X, --request COMMAND Specify request command to use |
| --resolve HOST:PORT:ADDRESS Force resolve of HOST:PORT to ADDRESS |
| --retry NUM Retry request NUM times if transient problems occur |
| --retry-delay SECONDS Wait SECONDS between retries |
| --retry-max-time SECONDS Retry only within this period |
| --sasl-ir Enable initial response in SASL authentication |
| -S, --show-error Show error. With -s, make curl show errors when they occur |
| -s, --silent Silent mode (don't output anything) |
| --socks4 HOST[:PORT] SOCKS4 proxy on given host + port |
| --socks4a HOST[:PORT] SOCKS4a proxy on given host + port |
| --socks5 HOST[:PORT] SOCKS5 proxy on given host + port |
| --socks5-hostname HOST[:PORT] SOCKS5 proxy, pass host name to proxy |
| --socks5-gssapi-service NAME SOCKS5 proxy service name for GSS-API |
| --socks5-gssapi-nec Compatibility with NEC SOCKS5 server |
| -Y, --speed-limit RATE Stop transfers below RATE for 'speed-time' secs |
| -y, --speed-time SECONDS Trigger 'speed-limit' abort after SECONDS (default: 30) |
| --ssl Try SSL/TLS (FTP, IMAP, POP3, SMTP) |
| --ssl-reqd Require SSL/TLS (FTP, IMAP, POP3, SMTP) |
| -2, --sslv2 Use SSLv2 (SSL) |
| -3, --sslv3 Use SSLv3 (SSL) |
| --ssl-allow-beast Allow security flaw to improve interop (SSL) |
| --stderr FILE Where to redirect stderr (use "-" for stdout) |
| --tcp-nodelay Use the TCP_NODELAY option |
| -t, --telnet-option OPT=VAL Set telnet option |
| --tftp-blksize VALUE Set TFTP BLKSIZE option (must be >512) |
| -z, --time-cond TIME Transfer based on a time condition |
| -1, --tlsv1 Use => TLSv1 (SSL) |
| --tlsv1.0 Use TLSv1.0 (SSL) |
| --tlsv1.1 Use TLSv1.1 (SSL) |
| --tlsv1.2 Use TLSv1.2 (SSL) |
| --trace FILE Write a debug trace to FILE |
| --trace-ascii FILE Like --trace, but without hex output |
| --trace-time Add time stamps to trace/verbose output |
| --tr-encoding Request compressed transfer encoding (H) |
| -T, --upload-file FILE Transfer FILE to destination |
| --url URL URL to work with |
| -B, --use-ascii Use ASCII/text transfer |
| -u, --user USER[:PASSWORD] Server user and password |
| --tlsuser USER TLS username |
| --tlspassword STRING TLS password |
| --tlsauthtype STRING TLS authentication type (default: SRP) |
| -A, --user-agent STRING Send User-Agent STRING to server (H) |
| -v, --verbose Make the operation more talkative |
| -V, --version Show version number and quit |
| -w, --write-out FORMAT Use output FORMAT after completion |
| --xattr Store metadata in extended file attributes |
| -q Disable .curlrc (must be first parameter) |
| </code> |
| |
===== GET ===== | ===== GET ===== |
<code bash> | <code bash> |
$ curl -X GET -L http:// | $ curl -X GET -L http:// |
| </code> |
| |
| ==== Бесшумное ==== |
| |
| <code bash> |
| $ curl -s -X GET -L http:// |
</code> | </code> |
| |
<code bash> | <code bash> |
$ curl -X POST -L http:// | $ curl -X POST -L http:// |
| </code> |
| |
| или |
| |
| <code bash> |
| $ curl --request POST -L http:// |
| </code> |
| |
| ==== Fields ==== |
| |
| <code bash> |
| $ curl -X POST --data "param1=value1¶m2=value2" -L http:// |
| </code> |
| |
| ==== Multipart (Fields + File) ==== |
| |
| <code bash> |
| $ curl -X POST --form "fileupload=@my-file.txt" --form param1=value1 --form param2=value2 -L http:// |
| </code> |
| |
| ==== Multipart + progress ==== |
| |
| <code bash> |
| $ curl --tr-encoding -X POST -v -# -o output -T filename.dat -L http://file-download.dat |
| </code> |
| |
| ===== Proxy ===== |
| |
| <code bash> |
| $ curl -x my.proxy.com:3128 -O http://example.net/myfile.zip |
| </code> |
| ===== Добавить header ===== |
| |
| Для открытия xml документа |
| |
| <code bash> |
| $ curl -X POST --header "Content-Type:text/xml" -L http:// |
| </code> |
| |
| Для открытия json документа |
| |
| <code bash> |
| $ curl -X POST --header "Content-Type:application/json" -L http:// |
</code> | </code> |