Úvod
Přenos dat na a ze serveru vyžaduje nástroje, které podporují potřebné síťové protokoly. Linux má pro tento účel vytvořeno několik nástrojů, z nichž nejoblíbenější jsou curl a wget.
Tento tutoriál vám ukáže, jak používat curl a poskytne vám vyčerpávající seznam dostupných možností.
Předpoklady
- Přístup k terminálu
- Přístup k internetu
- vlnka nainstalována
Co je příkaz curl?
vlnit (zkratka pro "Client URL") je nástroj příkazového řádku, který umožňuje přenos dat přes různé síťové protokoly. Komunikuje s webovým nebo aplikačním serverem zadáním relevantní adresy URL a dat, která je třeba odeslat nebo přijmout.
vlnit využívá libcurl, přenosnou knihovnu pro přenos adres URL na straně klienta. Můžete jej použít přímo na příkazovém řádku nebo jej zahrnout do skriptu. Nejběžnější případy použití vlnění jsou:
- Stahování souborů z internetu
- Testování koncového bodu
- Ladění
- Protokolování chyb
syntaxe curl
Základní kudrna syntaxe je následující:
curl [options/URLs]Například:
curl https://www.gnu.org/gnu/gnu.html
Systém vypíše obsah HTML nalezený na adrese URL uvedené za curl příkaz.
Pokud zadáte adresu URL, která vede k souboru, můžete použít curl pro stažení souboru do místního systému:
curl [url] > [local-file]Ukazatel průběhu ukazuje, kolik souboru bylo dosud staženo.
Syntaxe adres URL, které jsou součástí příkazu, závisí na protokolu. Více adres URL, které se v jedné části liší, je zapsáno společně pomocí složených závorek:
http://example.{first,second,third}.comAlfanumerické řady se píší se závorkami:
ftp://ftp.url.com/file[1-100].txtZatímco vnořené sekvence nejsou podporovány, více sekvencí je povoleno:
http://url.com/archive[2010-2020]/vol[1-4]/part{a,b,c}.htmlprotokoly curl
curl podporuje četné protokoly pro přenos dat. Kompletní seznam naleznete níže.
| Protokol | Popis |
|---|---|
| DICT | Síťový protokol slovníku pro dotazování serverů slovníků na významy slov. |
| SOUBOR | Schéma URL pro získání souboru z místního souborového systému pomocí curl. |
| FTP, FTPS | Protokol přenosu souborů, používaný pro přenos souborů mezi klienty a servery. FTPS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| GOPHER, GOPHERS | Starý protokol pro vyhledávání, získávání a distribuci internetových dokumentů, předchůdce HTTP. GOPHERS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| HTTP, HTTPS | Hypertext Transfer Protocol, používaný pro webový a internetový přenos dat. HTTPS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| IMAP, IMAPS | Internet Message Access Protocol, používaný pro přístup k e-mailu a jeho správu. IMAPS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| LDAP, LDAPS | Lightweight Directory Access Protocol, používaný pro distribuovaný přístup k informacím o adresáři a jejich správu. LDAPS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| MQTT | Message Queuing Telemetry Transport – protokol pro výměnu dat mezi malými zařízeními, obvykle systémy IoT. |
| POP3, POP3S | Post Office Protocol verze 3 – protokol pro získávání e-mailů ze serveru. POP3S je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| RTMP | Real-Time Messaging Protocol – streamovací protokol pro zvuk, video a další data. |
| RTSP | Protokol streamování v reálném čase, používaný pro správu serverů streamování médií. |
| SCP | Secure Copy – protokol pro kopírování souborů na a ze serveru SSH. |
| SFTP | SSH File Transfer Protocol – verze File Transfer Protocol využívající připojení SSH. |
| SMB, SMBS | Server Message Block – protokol pro správu sdíleného přístupu k souborům a periferním zařízením počítače. SMBS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| SMTP, SMPTS | Simple Mail Transfer Protocol – e-mailový protokol pro snadný přenos e-mailů. SMTPS je verze stejného protokolu s přidanou vrstvou zabezpečení SSL/TLS. |
| TELNET | Protokol aplikační vrstvy pro obousměrnou interaktivní textově orientovanou komunikaci. |
| TFTP | Trivial File Transfer Protocol, používaný pro nahrávání nebo stahování souborů na nebo ze vzdáleného hostitele. |
Možnosti příkazu curl
vlnit přijímá širokou škálu možností, což z něj dělá extrémně univerzální příkaz. Možnosti začínají jednou nebo dvěma pomlčkami. Pokud nevyžadují další hodnoty, lze volby s jednou pomlčkou zapsat společně. Například příkaz, který využívá -O , -L a -v možnosti lze zapsat jako:
curl -OLv [url]Seznam všech dostupných možností je uveden níže.
| Možnost | Popis |
|---|---|
--abstract-unix-socket | Připojte se přes abstraktní Unixový socket místo přes síť. Příklad: curl --abstract-unix-socket socketpath https://example.com |
--alt-svc | Povolit analyzátor alt-svc. Příklad: curl --alt-svc svc.txt https://example.com |
--anyauth | Curl najde a použije nejbezpečnější metodu ověřování pro danou HTTP URL. Příklad: curl --anyauth --user me:pass https://example.com |
-a, --append | Připojit k cílovému souboru. Příklad: curl --upload-file local --append ftp://example.com/ |
--aws-sigv4 | Použijte ověřování podpisu AWS V4. Příklad: curl --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" https://example.com |
--základní | Použít základní ověřování HTTP. Příklad: curl -u název:heslo --basic https://example.com |
--cacert | Použijte zadaný soubor pro ověření certifikátu. Příklad: curl --cacert CA-file.txt https://example.com |
--capath | K vyhledání certifikátů použijte zadaný adresář. Příklad: curl --capath /local/adresar https://example.com |
--cert-status | Ověřte stav certifikátu serveru. Příklad: curl --cert-status https://example.com |
--cert-type | Uveďte typ poskytnutého certifikátu. Rozpoznané typy jsou PEM (výchozí), DER , ENG a P12 . Příklad: curl --cert-type ENG --cert soubor https://example.com |
-E, --cert | Při práci s protokolem založeným na SSL použijte dodaný soubor certifikátu. Příklad: curl --cert certfile --key keyfile https://example.com |
--ciphers | Poskytněte šifry, které se mají použít v připojení. Příklad: curl --ciphers ECDHE-ECDSA-AES256-CCM8 https://example.com |
--compressed-ssh | Povolit vestavěnou kompresi SSH. Příklad: curl --compressed-ssh sftp://example.com/ |
--komprimovaný | Požadavek na přijetí komprimované odpovědi. Příklad: curl --compressed https://example.com |
-K, --config | Poskytněte textový soubor s argumenty curl, místo abyste je zapisovali na příkazový řádek. Příklad: curl --config file.txt https://example.com |
--connect-timeout | Uveďte maximální dobu, po kterou může spojení zvlněním trvat. Příklad: curl --connect-timeout 30 https://example.com |
--connect-to | Poskytněte pravidlo připojení pro směrování požadavků na konkrétní uzel serverového clusteru. Příklad: curl --connect-to example.com:443:example.net:8443 https://example.com |
-C, --continue-at | Obnovit přenos souboru se zadaným posunem. curl -C 400 https://example.com |
-c, --cookie-jar | Určete soubor pro ukládání souborů cookie. curl -c store.txt https://example.com |
-b, --cookie | Načíst soubory cookie ze souboru. Příklad: curl -b soubor cookie https://example.com |
--create-dirs | Vytvořte místní adresáře pro --output volba. Příklad: curl --create-dirs --output local/dir/file https://example.com |
--create-file-mode | Upřesněte, který režim se má nastavit při vytváření souboru. Příklad: curl --create-file-mode 0777 -T localfile sftp://example.com/new |
--crlf | Převést LF na CRLF. curl --crlf -T soubor ftp://example.com/ |
--crlfile | Poskytněte seznam odvolaných certifikátů pro rovnocenné certifikáty. curl --crlfile revoke.txt https://example.com |
--křivky | Zadejte křivky pro vytvoření relace SSL. Příklad: curl --curves X25519 https://example.com |
--data-ascii | Viz -d , --data . Příklad: curl --data-ascii @soubor https://example.com |
--data-binary | Odešlete data podle specifikace, bez dalšího zpracování. curl --data-binary @filename https://example.com |
--data-raw | Stejné jako -d , --data , ale se znakem @ se nezachází jinak než se zbytkem. curl --data-raw "@[email protected]@" https://example.com |
--data-urlencode | Stejné jako -d , --data , ale proveďte kódování URL. Příklad: curl --data-urlencode name=val https://example.com |
-d, --data | Odešlete data na server HTTP v požadavku POST. Příklad: curl -d "name=curl" https://example.com |
-- delegování | Uveďte, kdy může server delegovat pověření. Příklad: curl --delegace "vždy" https://example.com |
--digest | Povolit ověřování HTTP Digest. Příklad: curl -u název:heslo --digest https://example.com |
--disable-eprt | Zakažte příkazy EPRT a LPRT pro aktivní přenosy FTP. Příklad: curl --disable-eprt ftp://example.com/ |
--disable-epsv | Zakažte EPSV pro pasivní přenosy FTP. Příklad: curl --disable-epsv ftp://example.com/ |
-q, --disable | Zakažte čtení konfiguračního souboru curlrc. curl -q https://example.com |
--disallow-username-in-url | Pokud je poskytnuta adresa URL, která obsahuje uživatelské jméno, ukončete. Příklad: curl --disallow-username-in-url https://example.com |
--dns-interface | Určete rozhraní pro odchozí požadavky DNS. Příklad: curl --dns-interface eth0 https://example.com |
--dns-ipv4-addr | Uveďte adresu IPv4, ze které budou přicházet požadavky DNS. Příklad: curl --dns-ipv4-addr 10.1.2.3 https://example.com |
--dns-ipv6-addr | Uveďte adresu IPv6, ze které budou přicházet požadavky DNS. Příklad: curl --dns-ipv6-addr 2a04:4e42::561 https://example.com |
--dns-servers | Uveďte svůj vlastní seznam serverů DNS. Příklad: curl --dns-servers 192.168.0.1, 192.168.0.2 https://example.com |
--doh-cert-status | --cert-status pro DNS-over-HTTPS. Příklad: curl --doh-cert-status --doh-url https://doh.server https://example.com |
-doh-insecure | -k , --nezabezpečené pro DoH. Příklad: curl --doh-insecure --doh-url https://doh.server https://example.com |
--doh-url | Uveďte server DoH pro překlad názvu hostitele. Příklad: curl --doh-url https://doh.server https://example.com |
-D, --dump-header | Určete soubor pro zápis záhlaví protokolu. Příklad: curl --dump-header store.txt https://example.com |
--egd-file | Zadejte cestu pro zásuvku EGD. Příklad: curl --egd-file /cesta/zde https://example.com |
-- engine | Určete šifrovací modul OpenSSL. Příklad: curl -- příchuť motoru https://example.com |
--etag-compare | Požádat o přečtení ETag ze souboru. Příklad: curl --etag-compare etag.txt https://example.com |
--etag-save | Uložte HTTP ETag do souboru. Příklad: curl --etag-save etag.txt https://example.com |
--expect100-timeout | Maximální doba čekání na odpověď se 100 pokračováními. Příklad: curl --expect100-timeout 2.5 -T soubor https://example.com |
-fail-early | Řekněte curl, aby selhal, a ukončete jej, když zjistí první chybu při přenosu. Příklad: curl --fail-early https://example.com https://two.example |
-fail-with-body | Pokud server vrátí chybu s kódem 400 nebo vyšším, curl uloží obsah a vrátí chybu 22. Příklad: curl --fail-with-body https://example.com |
-f, --fail | Pokud server vrátí chybu, curl tiše selže a vrátí chybu 22. Příklad: curl --fail https://example.com |
-false-start | Použít falešný start pro TLS handshake. Příklad: curl --false-start https://example.com |
--form-string | Podobné jako -F , --form , ale hodnotové řetězce jsou zpracovány doslova. Příklad: curl --form-string "data" https://example.com |
-F, --form | Emulace formuláře pomocí Odeslat tlačítko, které bylo stisknuto. @ znak vynutí, aby byl obsah souboru. < sign extrahuje pouze obsahovou část souboru. Příklad: curl --form "name=curl" --form "[e-mail chráněný]" https://example.com |
--ftp-account | Zadejte data účtu pro server FTP. Příklad: curl --ftp-account "account_data" ftp://example.com/ |
--ftp-alternative-to-user | Uveďte příkaz, který se má odeslat, pokud se ověření uživatelského jména a hesla nezdaří. Příklad: curl --ftp-alternative-to-user "U53r" ftp://example.com |
--ftp-create-dirs | Pokud zadaný adresář neexistuje, curl se jej pokusí vytvořit. Příklad: curl --ftp-create-dirs -T soubor ftp://example.com/adresar/one/soubor |
--ftp-method | Uveďte metodu, která se má použít pro získávání souborů přes FTP. Dostupné metody jsou multicwd , nocwd a singlecwd . Příklad: curl --ftp-method multicwd ftp://example.com/dir1/dir2/file |
--ftp-pasv | Použijte režim pasivního datového připojení. Příklad: curl --ftp-pasv ftp://example.com/ |
-P, --ftp-port | Změňte výchozí role pro připojení FTP. Příklad: curl -P eth0 ftp:/example.com |
--ftp-pret | Před PASV/EPSV odešlete příkaz PRET. Příklad: curl --ftp-pret ftp://example.com/ |
--ftp-skip-pasv-ip | Nepoužívejte IP adresu navrženou serverem. curl bude používat IP ovládacího připojení. Příklad: curl --ftp-skip-pasv-ip ftp://example.com/ |
--ftp-ssl-ccc-mode | Nastavte režim Clear Command Channel (CCC). Příklad: curl --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/ |
--ftp-ssl-ccc | Po dokončení ověřování je vrstva SSL/TLS odstraněna, což umožňuje nešifrovanou komunikaci. Příklad: curl --ftp-ssl-ccc ftps://example.com/ |
--ftp-ssl-control | Pro přihlášení použijte SSL/TLS, zastavte šifrování při zahájení přenosu dat. Příklad: curl --ftp-ssl-control ftp://example.com |
-G, --get | Použít požadavek HTTP GET namísto POST. Příklad: curl --get -d "tool=curl" -d "age=old" https://example.com |
-g, --globoff | Zakažte analyzátor globbingu URL. Příklad: curl -g "https://example.com/{[]}}}}" |
--happy-eyeballs-timeout-ms | Pro připojení k hostitelům se dvěma zásobníky použijte algoritmus Happy Eyeballs. Příklad: curl --happy-eyeballs-timeout-ms 500 https://example.com |
--haproxy-protocol | Použít záhlaví protokolu HAProxy PROXY v1. Příklad: curl --haproxy-protocol https://example.com |
-I, --head | Získejte pouze záhlaví. Příklad: curl -I https://example.com |
-H, --header | Uveďte další hlavičku, která se má odeslat v požadavku HTTP. Příklad: curl -H "X-First-Name:Joe" https://example.com |
-h, --help | Viz nápovědu pro konkrétní kategorii. vše uvádí všechny dostupné možnosti. Příklad: curl --help all |
--hostpubmd5 | Předejte 32místný hexadecimální řetězec. Příklad: curl --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/ |
--hsts | Povolit HSTS. Příklad: curl --hsts cache.txt https://example.com |
--http0.9 | Přijměte odpověď HTTP verze 0.9. Příklad: curl --http0.9 https://example.com |
-0, --http1.0 | Používejte HTTP verze 1.0. Příklad: curl --http1.0 https://example.com |
--http1.1 | Používejte HTTP verze 1.1. Příklad: curl --http1.1 https://example.com |
--http2-prior-knowledge | Používejte HTTP verze 2.0. Tuto možnost použijte, pokud víte, že server podporuje tuto verzi HTTP. Příklad: curl --http2-prior-knowledge https://example.com |
--http2 | Pokuste se použít HTTP verze 2.0. Příklad: curl --http2 https://example.com |
--http3 | Používejte HTTP verze 3.0. Toto je experimentální možnost. Příklad: curl --http3 https://example.com |
--ignore-content-length | Záhlaví Content-Length ignorujte. Příklad: curl --ignore-content-length https://example.com |
-i, --include | Upřesněte, že výstup by měl obsahovat hlavičky odpovědi HTTP. Příklad: curl -i https://example.com |
-k, --insecure | Umožněte zvlnění pracovat s nezabezpečenými připojeními. Příklad: curl --insecure https://example.com |
-- rozhraní | Určete rozhraní pro provedení akce. Příklad: curl --interface eth0 https://example.com |
-4, --ipv4 | Názvy překládejte pouze na adresy IPv4. Příklad: curl --ipv4 https://example.com |
-6, --ipv6 | Názvy překládejte pouze na adresy IPv6. Příklad: curl --ipv6 https://example.com |
-j, --junk-session-cookies | Zrušte soubory cookie relace. Příklad: curl --junk-session-cookies -b cookies.txt https://example.com |
--keepalive-time | Upřesněte dobu nečinnosti pro připojení, než se odešle sondy pro udržení naživu. Příklad: curl --keepalive-time 30 https://example.com |
--key-type | Uveďte typ soukromého klíče. Dostupné typy jsou PEM (výchozí), DER a ENG . Příklad: curl --key-type ENG --key here https://example.com |
--klíč | Uveďte soubor obsahující soukromý klíč. Příklad: curl --cert certificate --key here https://example.com |
--krb | Povolte a použijte ověřování Kerberos. Dostupné úrovně jsou jasné , bezpečné , důvěrné a soukromé (výchozí). Příklad: curl --krb clear ftp://example.com/ |
--libcurl | Získejte zdrojový kód C pro zadanou operaci příkazového řádku. Příklad: curl --libcurl client.c https://example.com |
--limit-rate | Uveďte maximální přenosovou rychlost odesílání a stahování. Příklad: curl --limit-rate 100 kB https://example.com |
-l, --list-only | Vynutit zobrazení pouze se jménem. Příklad: curl --list-only ftp://example.com/dir/ |
--local-port <číslo/rozsah> | Uveďte čísla portů, která se mají použít pro připojení. Příklad: curl --local-port 1000-3000 https://example.com |
-location-trusted | Podobné jako -L , --location , ale umožňuje odeslat jméno a heslo na všechna přesměrování. Příklad: curl --location-trusted -u user:pass https://example.com |
-L, --location | Povolit curl sledovat všechna přesměrování. Příklad: curl -L https://example.com |
--login-options | Upřesněte možnosti přihlášení pro ověření e-mailového serveru. Příklad: curl --login-options 'AUTH=*' imap://example.com |
--mail-auth | Uveďte jednu adresu jako identitu. Příklad: curl --mail-auth [e-mail chráněný] -T mail smtp://example.com/ |
--mail-from | Uveďte jednu adresu odesílatele. Příklad: curl --mail-from [e-mail chráněný] -T mail smtp://example.com/ |
--mail-rcpt-allowfails | Umožňuje curl pokračovat v konverzaci SMTP, pokud jeden z příjemců selže. Příklad: curl --mail-rcpt-allowfails --mail-rcpt [e-mail chráněný] smtp://example.com |
--mail-rcpt | Uveďte jednu adresu „komu“. Příklad: curl --mail-rcpt [e-mail chráněný] smtp://example.com |
-M, --manual | Přečtěte si příručku ke zvlnění. Příklad: curl --manual |
--max-filesize | Uveďte maximální velikost souboru ke stažení. Příklad: curl --max-filesize 500 kB https://example.com |
--max-redirs | Uveďte maximální počet přesměrování, když --location je aktivní. Příklad: curl --max-redirs 3 --location https://example.com |
-m, --max-time | Zadejte maximální dobu operace. Příklad: curl --max-time 5,52 https://example.com |
--metalink | Uveďte zdroj metallinku. Tato možnost je v nejnovějších verzích curl zakázána. Příklad: curl --soubor metalink https://example.com |
--vyjednat | Povolit ověřování SPNEGO. Příklad: curl --negotiate -u :https://example.com |
--netrc-file | Jako --n , --netrc , ale umožňuje zadat soubor, který se má použít. Příklad: curl --netrc-file netrc https://example.com |
--netrc-optional | Jako --n , --netrc , ale použití netrc je volitelné. Příklad: curl --netrc-volitelné https://example.com |
-n, --netrc | Vyhledejte v souboru netrc přihlašovací údaje. Příklad: curl --netrc https://example.com |
-:, --next | Použijte možnost oddělit požadavky na adresy URL. Příklad: curl -I https://example.com --další https://example.net/ |
--no-alpn | Zakázat rozšíření ALPN TLS. Příklad: curl --no-alpn https://example.com |
-N, --no-buffer | Zakázat vyrovnávací paměť výstupního proudu. Příklad: curl --no-buffer https://example.com |
--no-keepalive | Zakázat zprávy o udržování stavu. Příklad: curl --no-keepalive https://example.com |
--no-npn | Zakázat rozšíření NPN TLS. Příklad: curl --no-npn https://example.com |
--no-progress-meter | Deaktivujte ukazatel průběhu, ale zobrazte jakoukoli jinou zprávu. Příklad: curl --no-progress-meter -o store https://example.com |
--no-sessionid | Zakažte ukládání SSL session-ID do mezipaměti. Příklad: curl --no-sessionid https://example.com |
--noproxy | Uveďte seznam hostitelů, kteří by neměli používat proxy. Příklad: curl --noproxy "www.example" https://example.com |
--ntlm-wb | Jako --ntlm , ale také předá ověření ntlmauth. Příklad: curl --ntlm-wb -u user:password https://example.com |
--ntlm | Povolit ověřování NTLM. Příklad: curl --ntlm -u user:password https://example.com |
--oauth2-bearer | Poskytněte token nosiče pro OAUTH 2.0. Příklad: curl --oauth2-bearer "mF_9.B5f-4.1JqM" https://example.com |
--output-dir | Uveďte adresář výstupního souboru. Příklad: curl --output-dir "tmp" -O https://example.com |
-o, --output | Uložte výstup do souboru. Výstup není zobrazen v stdout. Příklad: curl -o soubor https://example.com -o soubor2 https://example.net |
--parallel-immediate | Upřednostňujte paralelní připojení před čekáním na nová připojení nebo multiplexované toky. Příklad: curl --parallel-immediate -Z https://example.com -o soubor1 https://example.com -o soubor2 |
--parallel-max | Uveďte maximální počet paralelních připojení. Příklad: curl --parallel-max 100 -Z https://example.com ftp://example.com/ |
-Z, --paralelní | Provádějte přenosy paralelně. Příklad: curl --paralelní https://example.com -o soubor1 https://example.com -o soubor2 |
--pass | Zadejte přístupovou frázi soukromého klíče. Příklad: curl --pass secret --key file https://example.com |
--path-as-is | Zabraňte zvlnění ve sloučení /./ a /../ sekvence. Příklad: curl --path-as-is https://example.com/../../etc/passwd |
--pinnedpubkey | Uveďte veřejný klíč, který má curl použít. Příklad: curl --pinnedpubkey keyfile https://example.com |
--post301 | Zabraňte curl v převodu požadavků POST na GET po přesměrování 301. Příklad: curl --post301 --location -d "data" https://example.com |
--post302 | Zabraňte curl v převodu požadavků POST na GET po přesměrování 302. curl --post302 --location -d "data" https://example.com |
--post303 | Zabraňte curl v převodu požadavků POST na GET po přesměrování 303. Příklad: curl --post303 --location -d "data" https://example.com |
--preproxy [protocol://]hostitel[:port] | Používejte proxy server SOCKS jako pre-proxy. Příklad: curl --preproxy socks5://proxy.example -x http://http.example https://example.com |
-#, --progress-bar | Použijte jednoduchý ukazatel průběhu. Příklad: curl -# -O https://example.com |
--proto-default | Uveďte, který protokol curl by měl být použit pro adresy URL bez názvu schématu. Příklad: curl --proto-default https ftp.example.com |
--proto-redir | Uveďte, které protokoly má curl použít při přesměrování. Příklad: curl --proto-redir =http,https://example.com |
--proto | Upřesněte, které protokoly má curl používat pro přenosy. Příklad: curl --proto =http,https,sftp https://example.com |
--proxy-anyauth | Curl by si měl vybrat vhodnou metodu ověřování. Příklad: curl --proxy-anyauth --proxy-user user:passwd -x proxy https://example.com |
--proxy-basic | Pro komunikaci s proxy použijte HTTP Basic. Příklad: curl --proxy-basic --proxy-user user:passwd -x proxy https://example.com |
--proxy-cacert | --cacert for HTTPS proxies. Příklad: curl --proxy-cacert CA-file.txt -x https://proxy https://example.com |
--proxy-capath | --capath for HTTPS proxies. Příklad: curl --proxy-capath /local/directory -x https://proxy https://example.com |
--proxy-cert-type | --cert-type for HTTPS proxies. Příklad: curl --proxy-cert-type PEM --proxy-cert file -x https://proxy https://example.com |
--proxy-cert | -E , --cert for HTTPS proxies. Příklad: curl --proxy-cert file -x https://proxy https://example.com |
--proxy-ciphers | --ciphers for HTTPS proxies. curl --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy https://example.com |
--proxy-crlfile | --crlfile for HTTPS proxies. Příklad: curl --proxy-crlfile rejects.txt -x https://proxy https://example.com |
--proxy-digest | Use HTTP Digest authentication with a proxy. Příklad: curl --proxy-digest --proxy-user user:passwd -x proxy https://example.com |
--proxy-header | -H , --header for proxy communication. Příklad: curl --proxy-header "Host:" -x http://proxy https://example.com |
--proxy-insecure | -k , --insecure for HTTPS proxies. Příklad: curl --proxy-insecure -x https://proxy https://example.com |
--proxy-key-type | --key-type for HTTPS proxies. Příklad: curl --proxy-key-type DER --proxy-key here -x https://proxy https://example.com |
--proxy-key | --key for HTTPS proxies. Příklad: curl --proxy-key here -x https://proxy https://example.com |
--proxy-negotiate | --negotiate for proxy communication. Příklad: curl --proxy-negotiate --proxy-user user:passwd -x proxy https://example.com |
--proxy-ntlm | Use HTTP NTLM authentication with a proxy. Příklad: curl --proxy-ntlm --proxy-user user:passwd -x http://proxy https://example.com |
--proxy-pass | --pass for HTTPS proxies. Příklad: curl --proxy-pass secret --proxy-key here -x https://proxy https://example.com |
--proxy-pinnedpubkey | Specify the public key for proxy verification. Příklad: curl --proxy-pinnedpubkey keyfile https://example.com |
--proxy-service-name | Specify the service name for proxy communciation. Příklad: curl --proxy-service-name "shrubbery" -x proxy https://example.com |
--proxy-ssl-allow-beast | --ssl-allow-beast for HTTPS proxies. Příklad: curl --proxy-ssl-allow-beast -x https://proxy https://example.com |
--proxy-ssl-auto-client-cert | --ssl-auto-client-cert for HTTPS proxies. Příklad: curl --proxy-ssl-auto-client-cert -x https://proxy https://example.com |
--proxy-tls13-ciphers | Specifies the list of cipher suites to use in negotiating TLS 1.3 for proxies. Příklad: curl --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy https://example.com |
--proxy-tlsauthtype | --tlsauthtype for HTTPS proxies. Příklad: curl --proxy-tlsauthtype SRP -x https://proxy https://example.com |
--proxy-tlspassword | --tlspassword for HTTPS proxies. Příklad: curl --proxy-tlspassword passwd -x https://proxy https://example.com |
--proxy-tlsuser | --tlsuser for HTTPS proxies. Příklad: curl --proxy-tlsuser smith -x https://proxy https://example.com |
--proxy-tlsv1 | -1 , --tlsv1 for HTTPS proxies. Příklad: curl --proxy-tlsv1 -x https://proxy https://example.com |
-U, --proxy-user | Specify the username and password for authenticating with a proxy. Příklad: curl --proxy-user name:pwd -x proxy https://example.com |
-x, --proxy [protocol://]host[:port] | Specify a proxy to use. Příklad: curl --proxy http://proxy.example https://example.com |
--proxy1.0 | Specify a HTTP 1.0 proxy to use. Příklad: curl --proxy1.0 -x http://proxy https://example.com |
-p, --proxytunnel | Create a proxy tunnel. Příklad: curl --proxytunnel -x http://proxy https://example.com |
--pubkey | Provide a file containing a public key. Příklad: curl --pubkey file.pub sftp://example.com/ |
-Q, --quote | Send a command to a FTP or SFTP server, to be executed before the transfer. Příklad: curl --quote "rm file" ftp://example.com/foo |
--random-file | Specify a file containing random data. This file will be used for seeding the random engine. Příklad: curl --random-file rubbish https://example.com |
-r, --range | Obtain a range of bytes. Příklad: curl --range 40-80 https://example.com |
--raw | Disable HTTP content decoding and obtain raw data. Příklad: curl --raw https://example.com |
-e, --referer | Send Referrer Page information. Příklad: curl --referer "https://test.example" https://example.com |
-J, --remote-header-name | Use header name specified by the server instead of obtaining it from the URL. Příklad: curl -OJ https://example.com/file |
--remote-name-all | Apply the -O , --remote-name option to all the URLs. Příklad: curl --remote-name-all ftp://example.com/file1 ftp://example.com/file2 |
-O, --remote-name | Specify that the local file should have the name of the remote file that was downloaded. Příklad: curl -O https://example.com/filename |
-R, --remote-time | Specify that the local file should have the timestamp of the remote file that was downloaded. Příklad: curl --remote-time -o foo https://example.com |
--request-target | Specify an alternative target path. Příklad: curl --request-target "*" -X OPTIONS https://example.com |
-X, --request | Specify a request method for communication with the server. Příklad: curl -X "DELETE" https://example.com |
--resolve <[+]host:port:addr[,addr]...> | Specify a custom address for a host/port. Příklad: curl --resolve example.com:443:127.0.0.1 https://example.com |
--retry-all-errors | Force retrying on all errors. Příklad: curl --retry-all-errors https://example.com |
--retry-connrefused | Add ECONNREFUSED to the list of errors that are eligible for --retry . Příklad: curl --retry-connrefused --retry https://example.com |
--retry-delay | Specify the amount of time between retries. Příklad: curl --retry-delay 5 --retry https://example.com |
--retry-max-time | Specify the maximum amount of time for --retry attempts. Příklad: curl --retry-max-time 30 --retry 10 https://example.com |
--retry | Specify the number of retries after curl encounters and error. Příklad: curl --retry 7 https://example.com |
--sasl-authzid | Specify an additional authentication identity for SASL PLAIN authentication. Příklad: curl --sasl-authzid zid imap://example.com/ |
--sasl-ir | Enable initial response during SASL authentication. Příklad: curl --sasl-ir imap://example.com/ |
--service-name | Specify the SPNEGO service name. Příklad: curl --service-name sockd/server https://example.com |
-S, --show-error | Show an error message event with the -s , --silent option enabled. Příklad: curl --show-error --silent https://example.com |
-s, --silent | Turn on the silent mode. This option mutes curl. Příklad: curl -s https://example.com |
--socks4 | Specify a SOCKS4 proxy. Příklad: curl --socks4 hostname:4096 https://example.com |
--socks4a | Specify a SOCKS4a proxy. Příklad: curl --socks4a hostname:4096 https://example.com |
--socks5-basic | Use the basic authentication method (username/password) with a SOCKS5 proxy. Příklad: curl --socks5-basic --socks5 hostname:4096 https://example.com |
--socks5-gssapi-nec | Allow protection mode negotiation to be unprotected. Příklad: curl --socks5-gssapi-nec --socks5 hostname:4096 https://example.com |
--socks5-gssapi-service | Change the name of a socks server. Příklad: curl --socks5-gssapi-service sockd --socks5 hostname:4096 https://example.com |
--socks5-gssapi | Use GSS-API authentication with a SOCKS5 proxy. Příklad: curl --socks5-gssapi --socks5 hostname:4096 https://example.com |
--socks5-hostname | Specify the SOCKS5 proxy to use. Příklad: curl --socks5-hostname proxy.example:7000 https://example.com |
--socks5 | Specify the SOCKS5 proxy to use. The hostname is resolved locally. Příklad: curl --socks5 proxy.example:7000 https://example.com |
-Y, --speed-limit | Set the lower limit for the download speed. Příklad: curl --speed-limit 300 --speed-time 10 https://example.com |
-y, --speed-time | Set the time period for the speed limit measurement. Příklad: curl --speed-limit 300 --speed-time 10 https://example.com |
--ssl-allow-beast | Tell curl to ignore the BEAST security flaw in the SSL3 and TLS1.0 protocols. Příklad: curl --ssl-allow-beast https://example.com |
--ssl-auto-client-cert | Obtain and use a client certificate automatically. Příklad: curl --ssl-auto-client-cert https://example.com |
--ssl-no-revoke | Do not check for certificate revocation. Příklad: curl --ssl-no-revoke https://example.com |
--ssl-reqd | Require SSL/TLS. Příklad: curl --ssl-reqd ftp://example.com |
--ssl-revoke-best-effort | Ignore certificate revocation checks if they failed because of missing distribution points. Příklad: curl --ssl-revoke-best-effort https://example.com |
--ssl | Attempt to use SSL. Příklad: curl --ssl pop3://example.com/ |
-2, --sslv2 | Use SSLv2. Newer curl versions ignore this request due to security concerns with SSLv2. Příklad: curl --sslv2 https://example.com |
-3, --sslv3 | Use SSLv3. Newer curl versions ignore this request due to security concerns with SSLv3. Příklad: curl --sslv3 https://example.com |
--stderr | Output stderr to a file. The - symbol tells curl to output stderr to stdout. Příklad: curl --stderr output.txt https://example.com |
--styled-output | Enable bold fonts for HTTP header terminal output. curl --styled-output -I https://example.com |
--suppress-connect-headers | Prevent curl from outputting CONNECT headers. Příklad: curl --suppress-connect-headers --include -x proxy https://example.com |
--tcp-fastopen | Enable TCP Fast Open. Příklad: curl --tcp-fastopen https://example.com |
--tcp-nodelay | Enable TCP_NODELAY. Příklad: curl --tcp-nodelay https://example.com |
-t, --telnet-option | Pass the TTYPE , XDISPLOC , and NEW_ENV options to the telnet protocol. Příklad: curl -t TTYPE=vt100 telnet://example.com/ |
--tftp-blksize | Set the value of TFTP BLKSIZE. Must be a value larger than 512. Příklad: curl --tftp-blksize 1024 tftp://example.com/file |
--tftp-no-options | Prevents curl from sending requests for TFTP options. Příklad: curl --tftp-no-options tftp://192.168.0.1/ |
-z, --time-cond | Request a document that was modified after a certain date and time. For documents modified before the time, prefix the date expression with a dash. Příklad: curl -z "Wed 01 Sep 2021 12:18:00" https://example.com |
--tls-max | Specify the newest TLS version that is supported. Příklad: curl --tls-max 1.2 https://example.com |
--tls13-ciphers | Specifies the list of cipher suites to use in negotiating TLS 1.3 Příklad: curl --tls13-ciphers TLS_AES_128_GCM_SHA256 https://example.com |
--tlsauthtype | Specify the TLS authentication type. Příklad: curl --tlsauthtype SRP https://example.com |
--tlspassword | Specify the TLS password. Příklad: curl --tlspassword pwd --tlsuser user https://example.com |
--tlsuser | Specify the TLS username. Příklad: curl --tlspassword pwd --tlsuser user https://example.com |
--tlsv1.0 | Tell curl to use TLS1.0 or newer. Příklad: curl --tlsv1.0 https://example.com |
--tlsv1.1 | Tell curl to use TLS1.1 or newer. Příklad: curl --tlsv1.1 https://example.com |
--tlsv1.2 | Tell curl to use TLS1.2 or newer. Příklad: curl --tlsv1.2 https://example.com |
--tlsv1.3 | Tell curl to use TLS1.3 or newer. Příklad: curl --tlsv1.3 https://example.com |
-1, --tlsv1 | Specify that curl should use at least 1.x version of TLS. Příklad: curl --tlsv1 https://example.com |
--tr-encoding | Ask for a compressed Transfer-Encoding response. Příklad: curl --tr-encoding https://example.com |
--trace-ascii | Enable a full trace dump to a file. Eliminates the hex part and shows only ASCII. Příklad: curl --trace-ascii log.txt https://example.com |
--trace-time | Require a time stamp on each trace or verbose line. Příklad: curl --trace-time --trace-ascii output https://example.com |
--trace | Enable a full trace dump to a file. Příklad: curl --trace log.txt https://example.com |
--unix-socket | Specify a Unix socket path. Příklad: curl --unix-socket socket-path https://example.com |
-T, --upload-file | Upload a file to the URL. Příklad: curl -T "img[1-1000].png" ftp://ftp.example.com/ |
--url | Provide a URL to be fetched. Příklad: curl --url https://example.com |
-B, --use-ascii | Enable ASCII transfer. Příklad: curl -B ftp://example.com/README |
-A, --user-agent | Specify the user agent name. Příklad: curl -A "Agent 007" https://example.com |
-u, --user | Provide the username and password for authentication. Příklad: curl -u user:secret https://example.com |
-v, --verbose | Tell curl to be verbose. Příklad: curl --verbose https://example.com |
-V, --version | See the installed versions of curl and libcurl. Příklad: curl --version |
-w, --write-out | Tell curl to show information about the completed transfer on stdout. Příklad: curl -w '%{http_code}\n' https://example.com |
--xattr | Store file metadata in file attributes. Příklad: curl --xattr -o storage https://example.com |
For comprehensive descriptions of the options, execute the curl --manual command in the terminal.