sshtunl

SSH Tunnel Manager

A simple and easy-to-use SSH tunnel management tool for quickly creating and managing multiple SSH tunnel connections.

Features

• 🔧 Interactive SSH tunnel configuration management
• 🚀 Quick connection to saved tunnels
• ⏱️ Connection duration display
• 📝 Configuration stored in ~/.ssh-tunnels/config

Installation

Global Installation (Recommended)

npm install -g sshtunl

After installation, you can use the sshtunl command anywhere:

sshtunl add
sshtunl connect my-tunnel

Local Development

git clone <repository-url>
cd sshtunl
npm install
node bin/index.js add

Usage

Add a Tunnel

sshtunl add

You will be prompted to enter:

• Tunnel name
• SSH user
• SSH host
• Local port
• Remote host (default: 127.0.0.1)
• Remote port

Connect to a Tunnelect to a Tunnel

# Method 1: Use tunnel name with connect command
sshtunl connect <tunnel-name>

# Method 2: Use tunnel name as first argument (shorthand)
sshtunl <tunnel-name>

# Method 3: No arguments, interactive selection
sshtunl

Edit a Tunnel a Tunnel

# Edit specific tunnel
sshtunl edit <tunnel-name>

# Interactive selection
sshtunl edit

Delete a Tunnelte a Tunnel

# Delete specific tunnel
sshtunl delete <tunnel-name>

# Interactive selection
sshtunl delete

Show Help

sshtunl help

Configuration File Example

Configuration file is located at ~/.ssh-tunnels/config with the following format:

[project]
user=ubuntu
host=1.2.3.4
local_port=3336
remote_host=127.0.0.1
remote_port=3306

[apple]
user=ubuntu
host=12.34.56.78
local_port=3337
remote_host=127.0.0.1
remote_port=3306

Example Usage

Connecting to a database:

# Create SSH tunnel to remote MySQL
sshtunl project

# Then connect to local port in another terminal
mysql -h 127.0.0.1 -P 3336 -u user -p

Dependencies

• chalk - Terminal color output
• prompts - Interactive command line prompts

License

MIT