1PROXYTUNNEL(1) General Commands Manual PROXYTUNNEL(1)
2
3
4
6 proxytunnel - program to tunnel a connection throught an standard HTTPS
7 proxy.
8
10 proxytunnel [options]
11
12
14 This manual page documents the proxytunnel command.
15
16 proxytunnel is a program that open a tunnel through a HTTPS proxy.
17
19 This program follow the usual GNU command line syntax, with long
20 options starting with two dashes (`-').
21
22 -h, --help
23 Print help and exit.
24
25 -V, --version
26 kPrint the version of the program and exit.
27
28 -i, --inetd
29 Run from inetd. Default is off.
30
31 -F STRING, --passfile=STRING
32 The file containing Username & Password to send to HTTPS proxy
33 for authentification. This file uses the same format as
34 .wgetrc, and so can use the credentials in common with wget.
35 This option can be used to at least hide the password from any‐
36 one clever enough to use the `ps' command.
37
38 -p STRING, --proxy=STRING
39 The HTTPS Proxy host:port combo to connect to.
40
41 -P STRING, --proxyauth=STRING
42 The credentials (user:pass) to use for local HTTP(S) proxy
43 authentication.
44
45 -d STRING, --dest=STRING
46 The destination host:port to built the tunnel to.
47
48 -r STRING, --remproxy=STRING
49 The second-level proxy host:port to connect to.
50
51 -R STRING, --remproxyauth=STRING
52 The credentials (user:pass) to use for remote HTTP(S) proxy
53 authentication.
54
55 -v, --verbose
56 Turn on verbosity. Default is off.
57
58 -q, --quiet
59 Suppress messages. Default is off.
60
61
63 To use this program with OpenSSH to connect to a host somewhere, create
64 a $HOME/.ssh/config file with the following content:
65
66 Host foobar
67 ProtocolKeepAlives 30
68 ProxyCommand /usr/bin/proxytunnel -p proxy.customer.com:8080 -u
69 user -s password -d mybox.athome.nl:443
70
71 If your proxy doesn't require the username and password for using it,
72 you can skip these options.
73
74 If you want to run proxytunnel from inetd add the '--inetd' option.
75
76 Most HTTPS proxies do not allow access to ports other than 443 (HTTPS)
77 and 563 (SNEWS), so some hacking is necessary to start the SSH daemon
78 on the required port. (On the server side add an extra Port statement
79 in the sshd_config file)
80
81
82
84 This manual page was written by Loïc Le Guyader
85 <loic.leguyader@laposte.net>, for the Debian GNU/Linux system (but may
86 be used by others).
87
88
89
90 august 1, 2007 PROXYTUNNEL(1)