https://github.com/mdp/runnel

A really simple Ruby ssh tunnel manager
https://github.com/mdp/runnel

Last synced: about 1 year ago
JSON representation

A really simple Ruby ssh tunnel manager

• Host: GitHub
• URL: https://github.com/mdp/runnel
• Owner: mdp
• Created: 2011-03-19T22:20:11.000Z (about 15 years ago)
• Default Branch: master
• Last Pushed: 2017-09-04T09:54:00.000Z (almost 9 years ago)
• Last Synced: 2025-03-18T06:51:24.248Z (over 1 year ago)
• Language: Ruby
• Homepage:
• Size: 140 KB
• Stars: 21
• Watchers: 3
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.markdown

Awesome Lists containing this project

README

          
# runnel - A Ruby ssh tunnel manager

I hate starting autossh tunnels and trying to keep track of them. This solves that issue for me.

## Prereq's

Autossh - you really should already be using this.

    # Mac Homebrew

    brew install autossh

    # Ubuntu

    apt-get isntall autossh

    # Redhat

    Figure it out yourself

## Installation and usage

    gem install runnel

Now let runnel set itself up by simply running it:

    runnel

Edit your tunnels.yml file, found in '~/.runnel'

Here's the example file you'll have after setup:

    ----

    :socks_proxy:

      :name: My socks proxy for secure browsing on public WiFi

      :mport: 44488 #The autossh monitor port

      :command: -NfD 8080 mysecurebox.net

    :mysql_proxy

      :name: mySQL proxy for work

      :mport: 44490

      :command: -NfL 3306:localhost:3306 mysqlbox.org

Then use runnel to start the tunnels

    # Start one tunnel

    runnel start socks_proxy

    # Start all tunnels

    runnel start

You can also kill them the same way

    # Kill one tunnel

    runnel kill socks_proxy

    # Kill all tunnels

    runnel kill

And lastly

    # Show the tunnels, active and inactive

    runnel