ssh-tunnels-labs

KO | EN

gitlite — search

#python #hacktoberfest #typescript #android #macos #java #nodejs #windows #awesome #cli #awesome-list #vue #openai #open-source

ssh-tunnels-labs

(★ 12)

No description available.

ssh-tunnels-labs Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SSH Tunnels Lab Setup

This repository contains hands-on labs for learning **SSH tunneling** in real, practical scenarios.

Each lab runs inside its own Vagrant environment so you can reproduce the setups exactly as demonstrated in the guide:

- `local-tunnel/` — Local Port Forwarding lab
- `remote-tunnel/` — Remote Port Forwarding lab
- `proxy-lab/` — Using a Bastion Host (SSH Proxy Tunnel)
- (Optional future folder) `dynamic-tunnel/` — Dynamic SOCKS5 forwarding

Every lab includes its own **Vagrantfile** so you can spin up the environment independently.

## 1. Prerequisites

Before you begin, make sure you have the following installed on your system:

- **VirtualBox**
    
    https://www.virtualbox.org/wiki/Downloads
    
- **Vagrant**
    
    https://developer.hashicorp.com/vagrant/downloads

> You don’t need any prior Vagrant knowledge. The instructions below show you the exact commands to use.
>

## 2. Directory Structure

```
ssh-tunnels-labs/
│
├── local-tunnel/
│   ├── Vagrantfile
│   └── .vagrant/
│
├── remote-tunnel/
│   ├── Vagrantfile
│   └── .vagrant/
│
├── proxy-lab/
│   ├── Vagrantfile
│   └── .vagrant/
│
└──  README.md
```

Each folder is a **separate lab** with its own virtual machines, network settings, and demonstration exercises.

## 3. How to Use the Labs

### Step 1 - Clone the repository

```bash
git clone https://github.com/<your-username>/ssh-tunnels-labs.git
cd ssh-tunnels-labs

```

### Step 2 -  Choose a lab

For example, to work on the Local Port Forwarding lab:

```bash
cd local-tunnel

```

### Step 3 -  Spin up the VMs

```bash
vagrant up

```

Vagrant will automatically:

- Download the required base boxes (if not already cached)
- Create the virtual machines
- Assign network interfaces
- Run provisioning steps

You don’t have to configure anything manually.

### Step 4 -  SSH into a machine

Each VM is accessible via:

```bash
vagrant ssh <machine-name>

```

## 4. Basic Vagrant Commands

Here are the main commands you’ll need while working through the labs:

| Task | Command |
| --- | --- |
| Start all machines | `vagrant up` |
| Suspend machines | `vagrant suspend` |
| Stop machines | `vagrant halt` |
| Destroy lab (removes VMs) | `vagrant destroy -f` |
| Rebuild the lab from scratch | `vagrant destroy -f && vagrant up` |
| SSH into a machine | `vagrant ssh <name>` |
| Check VM status | `vagrant status` |

## 5. Resetting a Lab

If you break something during experimentation (which is normal), reset the lab easily:

```bash
vagrant destroy -f
vagrant up

```

This gives you a clean environment every time.

## 6. Notes

- Each lab is self-contained. You can run `local-tunnel` without touching `proxy-lab` or `remote-tunnel`.
- All networking is internal to VirtualBox - it won’t interfere with your host machine's network.
- If you want to modify IP addresses or test variations, feel free to edit the Vagrantfiles.

ssh-tunnels-labs

ssh-tunnels-labs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ssh-tunnels-labs

ssh-tunnels-labs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README