# SSH Tunnel Manager

A Go-based command-line tool to manage SSH tunnels. This tool allows you to:

- List currently active SSH tunnels
- Start new SSH tunnels as background daemons
- Stop running SSH tunnels
- Monitor traffic statistics for SSH tunnels

## Installation

```
go install git.mvl.sh/vleeuwenmenno/sshtunnel/cmd@latest
```

Or clone this repository and build it yourself:

```
git clone https://git.mvl.sh/vleeuwenmenno/sshtunnel.git
cd sshtunnel
go build -o sshtunnel ./cmd
```

## Usage

### Listing active tunnels

```
sshtunnel list
```

This will display all active SSH tunnels with their IDs, local ports, remote endpoints, and process IDs.

### Starting a new tunnel

```
sshtunnel start -l 8080 -r 80 -H example.com -s user@ssh-server.com
```

Options:
- `-l`: Local port to forward (required)
- `-r`: Remote port to forward to (required)
- `-H`: Remote host to forward to (default: "localhost")
- `-s`: SSH server address in the format user@host (required)
- `-i`: Path to SSH identity file (optional)

### Stopping tunnels

Stop a specific tunnel by ID:
```
sshtunnel stop -i 1
```

Stop all active tunnels:
```
sshtunnel stop --all
```

Options:
- `-i`: ID of the tunnel to stop
- `--all`: Stop all tunnels

### Viewing traffic statistics

View statistics for all tunnels:
```
sshtunnel stats --all
```

View statistics for a specific tunnel:
```
sshtunnel stats -i 1
```

Monitor tunnel traffic in real-time:
```
sshtunnel stats -i 1 --watch
```

Options:
- `--id`: ID of the tunnel to show statistics for
- `--all`: Show statistics for all tunnels
- `--watch`: Continuously monitor statistics (only with specific tunnel ID)
- `--interval`: Update interval in seconds for watch mode (default: 5)

### Debugging tunnels

Run diagnostics to troubleshoot issues with SSH tunnels:
```
sshtunnel debug
```

This command will:
1. Check if SSH client is properly installed
2. Verify the tunnel directory exists and is accessible
3. Validate all recorded tunnels and their current state
4. Show active SSH tunnel processes and their status

## How it works

The tool creates SSH tunnels using the system's SSH client and manages them by tracking their process IDs in a hidden directory (`~/.sshtunnels/`). Each tunnel is assigned a unique ID for easy management. Traffic statistics are collected and stored to help you monitor data transfer through your tunnels.

## Requirements

- Go 1.16 or higher
- SSH client installed on your system

## License

MIT