user/httptunnel/README

   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 httptunnel is free software.  See COPYING for terms and conditions.
  16 If 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
  22 Information 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
  28 I take no responsibility for what you do with this software.  It has
  29 the potential to do dangerous things, like disabling the protection
  30 you system administrator has set up for the local network.  Read the
  31 DISCLAIMER file.
  32
  33 There are two programs: hts and htc.  hts is the httptunnel server
  34 and htc is the client.  hts should be installed on a computer outside
  35 the HTTP proxy, and htc should be installed on your local computer.
  36
  37 Documentation about how to use the programs should be searched in this
  38 order:
  39         source code
  40         --help output
  41         FAQ
  42         README
  43
  44 Having 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
  56 See also
  57         http://metalab.unc.edu/LDP/HOWTO/mini/Firewall-Piercing.html
  58 which is a good introduction to firewall piercing.  It also has
  59 describes one way to use httptunnel.