curl-w32/docs/cmdline-opts/connect-to.md

1.1 KiB

c SPDX-License-Identifier Long Arg Help Added Category Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl connect-to <HOST1:PORT1:HOST2:PORT2> Connect to host 7.49.0 connection append
resolve
header
--connect-to example.com:443:example.net:8443 $URL

--connect-to

For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead. This option is suitable to direct requests at a specific server, e.g. at a specific cluster node in a cluster of servers. This option is only used to establish the network connection. It does NOT affect the hostname/port that is used for TLS/SSL (e.g. SNI, certificate verification) or for the application protocols. HOST1 and PORT1 may be the empty string, meaning "any host/port". HOST2 and PORT2 may also be the empty string, meaning "use the request's original host/port".

A hostname specified to this option is compared as a string, so it needs to match the name used in request URL. It can be either numerical such as 127.0.0.1 or the full host name such as example.org.