| 1 |
httptunnel creates a bidirectional virtual data path tunnelled in HTTP |
| 2 |
requests. The requests can be sent via an HTTP proxy if so desired. |
| 3 |
|
| 4 |
This can be useful for users behind restrictive firewalls. If WWW |
| 5 |
access is allowed through an HTTP proxy, it's possible to use |
| 6 |
httptunnel and, say, telnet or PPP to connect to a computer outside |
| 7 |
the firewall. |
| 8 |
|
| 9 |
If you still don't understand what this is all about, maybe you |
| 10 |
can find some useful information in the FAQ file. |
| 11 |
|
| 12 |
This program is mostly intended for technically oriented users. |
| 13 |
They should know what to do. |
| 14 |
|
| 15 |
Read INSTALL for instructions on how to build a released version. |
| 16 |
If you build the development repository, run ./autogen.sh first. |
| 17 |
|
| 18 |
httptunnel is free software. See COPYING for terms and conditions. |
| 19 |
If you like it, I would appreciate if you sent a post card to: |
| 20 |
Lars Brinkhoff |
| 21 |
Kopmansgatan 2 |
| 22 |
411 13 Goteborg |
| 23 |
Sweden |
| 24 |
|
| 25 |
Information and/or latest release should be available from these places: |
| 26 |
http://www.nocrew.org/software/httptunnel.html |
| 27 |
http://www.gnu.org/software/httptunnel/httptunnel.html |
| 28 |
ftp://ftp.gnu.org/pub/gnu/httptunnel |
| 29 |
|
| 30 |
I take no responsibility for what you do with this software. It has |
| 31 |
the potential to do dangerous things, like disabling the protection |
| 32 |
you system administrator has set up for the local network. Read the |
| 33 |
DISCLAIMER file. |
| 34 |
|
| 35 |
There are two programs: hts and htc. hts is the httptunnel server |
| 36 |
and htc is the client. hts should be installed on a computer outside |
| 37 |
the HTTP proxy, and htc should be installed on your local computer. |
| 38 |
|
| 39 |
Documentation about how to use the programs should be searched in this |
| 40 |
order: |
| 41 |
source code |
| 42 |
--help output |
| 43 |
FAQ |
| 44 |
README |
| 45 |
|
| 46 |
Having said that, here's a (probably outdated) example: |
| 47 |
At host REMOTE, start hts like this: |
| 48 |
hts -F localhost:23 8888 |
| 49 |
At host LOCAL, start htc like this: |
| 50 |
htc -F 2323 -P PROXY:8000 REMOTE:8888 |
| 51 |
or, if using a buffering HTTP proxy: |
| 52 |
htc -F 2323 -P PROXY:8000 -B 48K REMOTE:8888 |
| 53 |
|
| 54 |
Now you can do this at host LOCAL: |
| 55 |
telnet localhost 2323 |
| 56 |
and you will hopefully get a login prompt from host REMOTE. |
| 57 |
|
| 58 |
See also |
| 59 |
http://metalab.unc.edu/LDP/HOWTO/mini/Firewall-Piercing.html |
| 60 |
which is a good introduction to firewall piercing. It also has |
| 61 |
describes one way to use httptunnel. |