Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

file 55 lines (42 sloc) 1.39 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
This is a program to make generating SSH tunnels easier. It allows
you to configure many tunnels using a .tunnelrc configuration file.
It also makes use of autossh to keep the tunnels alive.

Installation
------------
Copy tunnel into your PATH.

Write a .tunnelrc file in your home directory. Here's an example.

Tunnels:
  Default:
    th: example.com # the host to tunnel with
    autossh: autossh # path to autossh, if you have it
    autossh_port: 30000 # port to use for autossh
    autossh_poll: 300 # how many seconds between trying to
                                # reconnect

  # An example of using SSH as a SOCKS proxy
  # on localhost:1080. IM, IRC, web browsers... lots of things
  # can talk through a SOCKS proxy
  socks:
    dynamic: 1 # tell SSH to run as a SOCKS proxy
    lp: 1080 # local port to run on

  # Tunnel your outgoing mail connection to Gmail
  # handy for networks which block outgoing mail
  outgoing_gmail:
    lp: 587
    rh: smtp.gmail.com

  # Tunnel to an SVN server
  svn:
    lp: 3690
    rh: svn.example.com
 

Requirements
------------

Perl 5.8 or up

The Perl modules...
  autodie
  http://search.cpan.org/dist/autodie

  YAML::Any
  http://search.cpan.org/dist/YAML


Optional
--------
autossh
(Will keep your tunnels alive and reopen them)
http://www.harding.motd.ca/autossh/
Something went wrong with that request. Please try again.