HTS(1)HTS(1)NAMEhts - httptunnel server
SYNOPSIShts [options] [port]
DESCRIPTION
This manual page briefly documents the hts command.
hts listens for incoming httptunnel connections at PORT (default port
is 8888). When a connection is made, I/O is redirected to the destina‐
tion specified by the --device or --forward-port switch.
OPTIONS
The program follows the usual GNU command line syntax, with long
options starting with two dashes (`-'). A summary of options are
included below.
-h, --help
Show summary of options.
-c, --content-length BYTES
use HTTP PUT requests of BYTES size (k, M, and G postfixes rec‐
ognized)
-d, --device DEVICE
use DEVICE for input and output
-F, --forward-port HOST:PORT
connect to PORT at HOST and use it for input and output
-k, --keep-alive SECONDS
send keepalive bytes every SECONDS seconds (default is 5)
-M, --max-connection-age SEC
maximum time a connection will stay open is SEC seconds (default
is 300)
-S, --strict-content-length
always write Content-Length bytes in requests
-V, --version
output version information and exit
-p, --pid-file LOCATION
write a PID file to LOCATION
EXAMPLES
To get past proxy, On the server you must run hts. If I wanted to have
port 80 (http) redirect all traffic to port 23 (telnet) then it would
go something like:
hts-F server.test.com:23 80
On the client you would run htc. If you are going through a proxy, the
-P option is needed,otherwise omit it.
htc -P proxy.corp.com:80 -F 22 server.test.com:80
Then telnet localhost and it will redirect the traffic out to port 80
on the proxy server and on to port 80 of the server, then to port 23.
Q: When I use SSH (or VNC, or <insert other program here>) over GNU
httptunnel, the program locks up after a few minutes (or hours). When I
close the program and attempt to reconnect, SSH times out. What's
wrong?
A: Your httptunnel connection has failed on the client end (possibly
due to network congestion), but the server end has not recognized that
the connection has been lost and won't allow another connection until
the first connection times out. To establish a more stable tunnel, try
experimenting with the various options for the htc and hts programs.
The following settings seem to work pretty well for me, but your
mileage may vary:
hts-S --max-connection-age 20000 -F localhost:22 8890
htc -F 8890 --strict-content-length -B 5k --max-connection-age 2000 -P
proxy.mycompany.com:8080 10.1.1.1:8890
FAQ
Visit http://www.nocrew.org/software/httptunnel/faq.html
AUTHOR
This manual page was contributed by Teemu Hukkanen <tjhukkan@iki.fi>,
and was originally written for the Debian GNU/Linux system.
HTS(1)
