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