| 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: socks5-hostname |
| 4 | Arg: <host[:port]> |
| 5 | Help: SOCKS5 proxy, pass host name to proxy |
| 6 | Added: 7.18.0 |
| 7 | Category: proxy |
| 8 | Example: --socks5-hostname proxy.example:7000 $URL |
| 9 | See-also: socks5 socks4a |
| 10 | Multi: single |
| 11 | --- |
| 12 | Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If |
| 13 | the port number is not specified, it is assumed at port 1080. |
| 14 | |
| 15 | To specify proxy on a unix domain socket, use localhost for host, e.g. |
| 16 | socks5h://localhost/path/to/socket.sock |
| 17 | |
| 18 | This option overrides any previous use of --proxy, as they are mutually |
| 19 | exclusive. |
| 20 | |
| 21 | This option is superfluous since you can specify a socks5 hostname proxy with |
| 22 | --proxy using a socks5h:// protocol prefix. (Added in 7.21.7) |
| 23 | |
| 24 | Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time |
| 25 | --proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to |
| 26 | the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy. |