gun:connect - Establish a tunnel to the origin server
connect(ConnPid, Destination)
-> connect(ConnPid, Destination, [], #{}).
connect(ConnPid, Destination, Headers)
-> connect(ConnPid, Destination, Headers, #{}).
connect(ConnPid, Destination, Headers, ReqOpts)
-> StreamRef
ConnPid :: pid()
Destination :: gun:connect_destination()
Headers :: gun:req_headers()
ReqOpts :: gun:req_opts()
StreamRef :: gun:stream_ref()
Establish a tunnel to the origin server.
This feature is currently only available for HTTP/1.1 connections. Upon successful completion of the CONNECT request a tunnel is established and subsequent requests will go through the tunnel.
Gun will not automatically re-issue the CONNECT request upon reconnection to the proxy server. The gun_up message can be used to know when the tunnel needs to be established again.
The pid of the Gun connection process.
Destination of the CONNECT request.
Additional request headers.
Request options.
A reference that identifies the newly created stream is returned. It is this reference that must be passed in subsequent calls and will be received in messages related to this new stream.
{ok, ConnPid} = gun:open("proxy.example.org", 1080),
{ok, http} = gun:await_up(ConnPid),
StreamRef = gun:connect(ConnPid, #{
host => "origin-server.example.org",
port => 80
}),
{response, fin, 200, _} = gun:await(ConnPid, StreamRef),
%% Subsequent requests will be sent to origin-server.example.org.
{ok, ConnPid} = gun:open("proxy.example.org", 1080),
{ok, http} = gun:await_up(ConnPid),
StreamRef = gun:connect(ConnPid, #{
host => "origin-server.example.org",
port => 443,
protocols => [http2],
transport => tls
}),
{response, fin, 200, _} = gun:await(ConnPid, StreamRef),
%% Subsequent requests will be sent to origin-server.example.org.
{ok, ConnPid} = gun:open("proxy.example.org", 1080),
{ok, http} = gun:await_up(ConnPid),
StreamRef = gun:connect(ConnPid, #{
host => "origin-server.example.org",
port => 80,
username => "essen",
password => "myrealpasswordis"
}),
{response, fin, 200, _} = gun:await(ConnPid, StreamRef),
%% Subsequent requests will be sent to origin-server.example.org.
Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk is fantastic:
Recurring payment options are also available via GitHub Sponsors. These funds are used to cover the recurring expenses like food, dedicated servers or domain names.