blob: 5be20712bbda023a764ba3817bc1d6c02e1a9741 [file] [log] [blame]
xf.li6c8fc1e2023-08-12 00:11:09 -07001c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
2SPDX-License-Identifier: curl
3Long: preproxy
4Arg: [protocol://]host[:port]
5Help: Use this proxy first
6Added: 7.52.0
7Category: proxy
8Example: --preproxy socks5://proxy.example -x http://http.example $URL
9See-also: proxy socks5
10Multi: single
11---
12Use the specified SOCKS proxy before connecting to an HTTP or HTTPS --proxy. In
13such a case curl first connects to the SOCKS proxy and then connects (through
14SOCKS) to the HTTP or HTTPS proxy. Hence pre proxy.
15
16The pre proxy string should be specified with a protocol:// prefix to specify
17alternative proxy protocols. Use socks4://, socks4a://, socks5:// or
18socks5h:// to request the specific SOCKS version to be used. No protocol
19specified will make curl default to SOCKS4.
20
21If the port number is not specified in the proxy string, it is assumed to be
221080.
23
24User and password that might be provided in the proxy string are URL decoded
25by curl. This allows you to pass in special characters such as @ by using %40
26or pass in a colon with %3a.