Návod · curl

Použití proxy s curl

curl představuje nejrychlejší způsob, jak ověřit funkčnost proxy nezávisle na prohlížeči či rozšíření. Příkaz curl je integrován v systémech Linux, macOS i Windows 10 a 11. Tento návod obsahuje příklady příkazů, postup čtení výstupu pro řešení chyb a nastavení výchozí proxy pro všechny příkazy.

Autor: Bùi Toàn · Aktualizováno: 19/11/2026

Základní příkazy

  • Z formátu ip:port:user:pass spusťte: curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • Nebo vše spojte do jednoho řetězce: curl -x http://user:pass@IP:PORT https://api.ipify.org
  • Výstupem musí být IP adresa proxy. Zobrazení IP adresy vašeho poskytovatele internetu (ISP) znamená, že požadavek přes proxy neprošel.
  • Chcete-li zkontrolovat také zemi: nahraďte cílovou URL adresou https://ipinfo.io/json.
  • Pokud proxy běží v režimu SOCKS5 nebo HTTP + SOCKS5: curl -x socks5h://user:pass@IP:PORT https://api.ipify.org (socks5h zajistí překlad doménových jmen na straně proxy), nebo curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org.

Ve Windows

V PowerShell 5.1 je "curl" pouze alias pro Invoke-WebRequest, nikoli skutečný curl. Místo curl použijte curl.exe: curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org. V Příkazovém řádku (cmd) a PowerShell 7 nebo novějším představuje curl již skutečný curl.

Jak používat curl se speciálními znaky v heslu k proxy?

Při použití formátu user:pass@IP musí být speciální znaky v hesle, jako například @ : / # %, zakódovány v URL formátu – například @ se změní na %40 a # na %23. Použití -U "user:pass" (v uvozovkách) kódování nevyžaduje a snižuje chybovost. Na Linuxu a macOS použijte jednoduché uvozovky, pokud heslo obsahuje $ nebo !.

Jak číst výstup nástroje curl při diagnostice chyb proxy?

Přidejte přepínač -v a zkontrolujte jednotlivé kroky: řádek „200 Connection established“ znamená, že proxy připojení přijala, zatímco chybové zprávy níže prozradí, zda problém pramení z přihlašovacích údajů, portů, sítě nebo cílového webu.

Přidejte -v pro podrobné informace

U HTTPS webů odesílá curl na proxy požadavek CONNECT. Řádek "< HTTP/1.1 200 Connection established" znamená, že proxy spojení přijala. Řádek "407 Proxy Authentication Required" značí nesprávné uživatelské jméno nebo heslo.

Failed to connect … Connection refused

Připojení k IP:port bylo okamžitě odmítnuto: nesprávný port, expirovaná nebo neaktivní proxy. Podívejte se na návod k chybám odmítnutého spojení.

Connection timed out

Nebyla přijata žádná odpověď: nesprávná IP adresa, problémy se sítí nebo firewall blokující daný port. Přidejte parametr --connect-timeout 10, abyste nemuseli čekat příliš dlouho.

CONNECT tunnel failed, response 502 or 503

Proxy sice běží, ale nepodařilo se jí navázat spojení s cílovým webem. Vyzkoušejte jinou webovou stránku a ověřte, zda je problém na straně cílového webu, nebo u samotné proxy.

Nastavení výchozí proxy

Nastavte proměnné prostředí, aby všechny příkazy curl (a řada dalších nástrojů) automaticky používaly proxy: export https_proxy="http://user:pass@IP:PORT" a export http_proxy="$https_proxy" na Linuxu a macOS. Vynechat proxy pro jednotlivý příkaz můžete pomocí --noproxy "*". Případně přidejte řádek proxy = "http://user:pass@IP:PORT" do souboru ~/.curlrc.

Ještě nemáte proxy? Kupte si dedikované proxy s automatickou aktivací

Dedikované IPv4 proxy v 9 zemích od 20.000₫/IP/měsíc při nákupu od 2.000 IP (39.000₫ za 1 IP) a navíc statické ISP proxy ve Vietnamu a USA. HTTP(S) a SOCKS5 se jménem a heslem, neomezený přenos dat, automatické zřízení po zaplacení. Vietnamské proxy v současnosti využívají protokol HTTP(S); SOCKS5 zatím není k dispozici.

Koupit proxy nyní

Často kladené otázky

Proč hodnota https_proxy stále začíná na http://?+

Tento prefix určuje, jakým způsobem se curl připojuje k proxy, nikoli k cílovému webu. Při komunikaci s proxy ONET přes HTTP jsou HTTPS weby stále dostupné prostřednictvím metody CONNECT. U SOCKS5 začíná hodnota předponou socks5h://.

Mohu u proxy od ONET použít parametr --socks5?+

Ano, pokud proxy běží v režimu SOCKS5 nebo HTTP + SOCKS5: curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org, nebo -x socks5h://user:pass@IP:PORT. Použijte socks5h nebo --socks5-hostname, aby se doménová jména překládala na straně proxy. Upozorňujeme, že vietnamské proxy v současnosti využívají pouze protokol HTTP(S); SOCKS5 zatím není k dispozici.