2 # Main page of 'My::Project::tcpoverudp'
3 # Copyright (C) 2007 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; exactly version 2 of June 1991 is required
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 package project::tcpoverudp::Index;
20 require 5.6.0; # at least 'use warnings;' but we need some 5.6.0+ modules anyway
21 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
28 Wrequire 'product::Lib';
33 "platform"=>"unixuser",
36 # FIXME: 'http://cvs.jankratochvil.net/viewcvs/' -> $W->{"project_viewcvs"}
37 "link-Source file"=>'http://cvs.jankratochvil.net/viewcvs/'."tcpoverudp/tcpoverudp?rev=HEAD",
38 "summary"=>"Forward TCP connections over UDP without root",
40 "maintenance"=>"ready",
42 "description"=>sub { return <<"HERE"; },
43 <p>Does your link suffer from a high packet loss (up to 70%)?
44 Do you have a UNIX account in public Internet but no root privileges access there?
45 This tool can provide you a reliable fast TCP (web proxy + SSH) connectivity while
46 constantly retrying transmissions on link of any quality.</p>
58 ./tcpoverudp --udp-server-addr=public.server.com --udp-server-port=8120 \\
59 --tcp-listen-port=8128 8122
63 ./tcpoverudp --udp-listen-port=8120 \\
64 --tcp-forward-addr=public.web.proxy --tcp-forward-port=3128 \\
65 --tcp-forward-addr=localhost --tcp-forward-port=22
68 <p>This setup configures a connection:</p>
69 <table border="1" class="margin-center padded">
71 <td>:8128 (TCP, for web proxy)</td>
73 <td rowspan="2">(UDP) → 8120 (UDP)</td>
75 <td>public.web.proxy:3128 (TCP, parent web proxy)</td>
78 <td>:8122 (TCP, for SSH)</td>
82 <td>localhost:22 (TCP, SSH server)</td>
86 <p>You should also use this <code>~/.ssh/config</code>for transparent SSH access:</p>
89 HostName public.server.com
90 HostKeyAlias public.server.com
94 ProxyCommand ssh public-proxy exec nc %h %p