• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: socks5-hostname
5Arg: <host[:port]>
6Help: SOCKS5 proxy, pass host name to proxy
7Added: 7.18.0
8Category: proxy
9Multi: single
10See-also:
11  - socks5
12  - socks4a
13Example:
14  - --socks5-hostname proxy.example:7000 $URL
15---
16
17# `--socks5-hostname`
18
19Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If
20the port number is not specified, it is assumed at port 1080.
21
22To specify proxy on a unix domain socket, use localhost for host, e.g.
23`socks5h://localhost/path/to/socket.sock`
24
25This option overrides any previous use of --proxy, as they are mutually
26exclusive.
27
28This option is superfluous since you can specify a socks5 hostname proxy with
29--proxy using a socks5h:// protocol prefix. (Added in 7.21.7)
30
31--preproxy can be used to specify a SOCKS proxy at the same time --proxy is
32used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
33connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
34HTTPS proxy.
35