1ssh-http-proxy-connect(1) User Commands ssh-http-proxy-connect(1)
2
3
4
6 ssh-http-proxy-connect - Secure Shell proxy for HTTP
7
9 /usr/lib/ssh/ssh-http-proxy-connect [-h http_proxy_host]
10 [-p http_proxy_port] connect_host connect_port
11
12
14 A proxy command for ssh(1) that uses HTTP CONNECT. Typical use is where
15 connections external to a network are only allowed via a proxy web
16 server.
17
19 The following options are supported:
20
21 -h http_proxy_host Specifies the proxy web server through which to
22 connect. Overrides the HTTPPROXY and http_proxy
23 environment variables if they are set.
24
25
26 -p http_proxy_port Specifies the port on which the proxy web server
27 runs. If not specified, port 80 is assumed. Over‐
28 rides the HTTPPROXYPORT and http_proxy environ‐
29 ment variables if they are set.
30
31
33 The following operands are supported:
34
35 http_proxy_host The host name or IP address (IPv4 or IPv6) of the
36 proxy.
37
38
39 http_proxy_port The numeric port number to connect to on
40 http_proxy_host.
41
42
43 connect_host The name of the remote host to which the proxy web
44 server is to connect you.
45
46
47 connect_port The numeric port number of the proxy web server to
48 connect you to on http_proxy_host.
49
50
52 The recommended way to use a proxy connection command is to configure
53 the ProxyCommand in ssh_config(4) (see Example 1 and Example 2). Exam‐
54 ple 3 shows how the proxy command can be specified on the command line
55 when running ssh(1).
56
57 Example 1 Setting the proxy from the environment
58
59
60 The following example uses ssh-http-proxy-connect in ssh_config(4) when
61 the proxy is set from the environment:
62
63
64 Host playtime.foo.com
65 ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect \
66 playtime.foo.com 22
67
68
69
70 Example 2 Overriding proxy environment variables
71
72
73 The following example uses ssh-http-proxy-connect in ssh_config(4) to
74 override (or if not set) proxy environment variables:
75
76
77 Host playtime.foo.com
78 ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect -h webcache \
79 -p 8080 playtime.foo.com 22
80
81
82
83 Example 3 Using the command line
84
85
86 The following example uses ssh-http-proxy-connect from the ssh(1) com‐
87 mand line:
88
89
90 example$ ssh -o'ProxyCommand="/usr/lib/ssh/ssh-http-proxy-connect \
91 -h webcache -p 8080 playtime.foo.com 22"' playtime.foo.com
92
93
94
96 HTTPPROXY Takes the http_proxy_host operand to specify the
97 default proxy host. Overrides http_proxy if both are
98 set.
99
100
101 HTTPPROXYPORT Takes the http_proxy_port operand to specify the
102 default proxy port. Ignored if HTTPPROXY is not set.
103
104
105 http_proxy URL format for specifying proxy host and port.
106
107
109 The following exit values are returned:
110
111 0 Successful completion.
112
113
114 1 An error occurred.
115
116
118 See attributes(5) for descriptions of the following attributes:
119
120
121
122
123 ┌─────────────────────────────┬─────────────────────────────┐
124 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
125 ├─────────────────────────────┼─────────────────────────────┤
126 │Availability │SUNWsshu │
127 ├─────────────────────────────┼─────────────────────────────┤
128 │Interface Stability │Stable │
129 └─────────────────────────────┴─────────────────────────────┘
130
132 ssh(1), ssh-socks5-proxy-connect(1), ssh_config(4), attributes(5)
133
134
135
136SunOS 5.11 24 Oct 2001 ssh-http-proxy-connect(1)