1PROXYTUNNEL(1)              General Commands Manual             PROXYTUNNEL(1)
2
3
4

NAME

6       proxytunnel - program to tunnel a connection throught an standard HTTPS
7       proxy.
8

SYNOPSIS

10       proxytunnel [options]
11
12

DESCRIPTION

14       This manual page documents the proxytunnel command.
15
16       proxytunnel is a program that open a tunnel through a HTTPS proxy.
17

OPTIONS

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

NOTES

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

AUTHOR

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)
Impressum