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