Why SSH tunneling (port forwarding) in Linux CLI? - Purpose & Use Cases

The Big Idea

What if you could securely reach any private service with just one simple command?

The Scenario

Imagine you need to access a private database on your company network from home. Without special tools, you try to connect directly but the network blocks you. You ask IT to open ports or send files back and forth manually.

The Problem

Manually requesting network changes is slow and risky. Opening ports can expose your system to hackers. Copying files repeatedly wastes time and can cause version mix-ups. You feel stuck and frustrated.

The Solution

SSH tunneling creates a secure, invisible bridge from your computer to the private network. It forwards the needed ports safely through an encrypted connection, letting you work as if you were inside the company network without exposing anything.

Before vs After

✗ Before

telnet private-db.company.com 3306

✓ After

ssh -L 3306:private-db.company.com:3306 user@company-gateway

What It Enables

SSH tunneling lets you securely access remote services as if they were local, unlocking powerful remote work and automation possibilities.

Real Life Example

A developer uses SSH tunneling to connect their local browser to a remote web server's admin panel that is only accessible inside the company network, without exposing the server to the internet.

Key Takeaways

Manual remote access is slow, risky, and frustrating.

SSH tunneling creates a secure, encrypted path for port forwarding.

This enables safe, seamless access to remote services as if local.

Practice

1. What does the SSH command ssh -L 8080:localhost:80 user@remote do?

easy

A. Creates a VPN connection between your machine and the remote server

B. Forwards remote port 8080 to your local port 80

C. Forwards your local port 8080 to port 80 on the remote server's localhost

D. Copies files from port 8080 on remote to port 80 locally

Solution

1. Step 1: Understand the -L option in SSH

   The -L option sets up local port forwarding, mapping a local port to a remote address and port.

2. Step 2: Analyze the command ports and hosts

   Local port 8080 is forwarded to port 80 on the remote server's localhost, allowing local access to remote web service.

3. Final Answer:

   Forwards your local port 8080 to port 80 on the remote server's localhost -> Option C

4. Quick Check:

   ssh -L local_port:remote_host:remote_port = local to remote [OK]

Hint: Remember -L means local port to remote host:port [OK]

Common Mistakes:

• Confusing -L with -R (remote forwarding)
• Mixing up local and remote ports
• Thinking it copies files instead of forwarding ports

2. Which of the following is the correct syntax to forward local port 3306 to remote port 3306 on host db.example.com using SSH?

easy

A. ssh -L 3306:db.example.com:3306 user@remote

B. ssh -R 3306:db.example.com:3306 user@remote

C. ssh -F 3306:db.example.com:3306 user@remote

D. ssh -P 3306:db.example.com:3306 user@remote

Solution

1. Step 1: Identify the correct option for local port forwarding

   The -L flag is used for local port forwarding, which forwards a local port to a remote host and port.

2. Step 2: Check the syntax correctness

   ssh -L 3306:db.example.com:3306 user@remote correctly forwards local port 3306 to remote db.example.com port 3306.

3. Final Answer:

   ssh -L 3306:db.example.com:3306 user@remote -> Option A

4. Quick Check:

   -L for local forwarding syntax [OK]

Hint: Use -L for local forwarding, not -R or others [OK]

Common Mistakes:

• Using -R instead of -L for local forwarding
• Using invalid flags like -F or -P
• Swapping local and remote ports

3. What will be the output of the following command if you run ssh -L 9000:localhost:5432 user@remote and then connect your local machine to port 9000?

Assuming PostgreSQL runs on port 5432 on the remote server, what happens?

medium

A. You connect to the remote PostgreSQL database through local port 9000

B. You connect to a local PostgreSQL database on your machine on port 5432

C. The SSH connection fails because port 9000 is blocked

D. You connect to port 9000 on the remote server directly

Solution

1. Step 1: Understand the port forwarding setup

   The command forwards local port 9000 to remote localhost port 5432, where PostgreSQL runs.

2. Step 2: Analyze the connection effect

   Connecting locally to port 9000 actually connects through SSH tunnel to remote PostgreSQL on port 5432.

3. Final Answer:

   You connect to the remote PostgreSQL database through local port 9000 -> Option A

4. Quick Check:

   Local port 9000 tunnels to remote 5432 [OK]

Hint: Local port connects to remote service via tunnel [OK]

Common Mistakes:

• Thinking it connects to local PostgreSQL instead
• Assuming SSH connection fails without checking firewall
• Confusing local and remote ports

4. You tried to run ssh -L 8080:localhost:80 user@remote but get an error: "bind: Address already in use". What is the most likely cause and fix?

medium

A. Remote port 80 is blocked; use a different remote port

B. Local port 8080 is already used; choose a different local port

C. User authentication failed; check username and password

D. SSH service is not running on remote server

Solution

1. Step 1: Understand the error message

   "bind: Address already in use" means the local port 8080 is occupied by another process.

2. Step 2: Fix by changing local port

   Choose a different unused local port (e.g., 8081) to avoid conflict.

3. Final Answer:

   Local port 8080 is already used; choose a different local port -> Option B

4. Quick Check:

   Port bind error means local port busy [OK]

Hint: Check if local port is free before forwarding [OK]

Common Mistakes:

• Assuming remote port or authentication causes bind error
• Ignoring local port conflicts
• Not checking running processes using the port

5. You want to securely access a web service running on port 5000 of a remote server at 192.168.1.10, but the server only allows SSH connections. Which command correctly sets up a tunnel so you can open http://localhost:7000 in your browser to access the remote service?

hard

A. ssh -L 5000:localhost:7000 user@192.168.1.10

B. ssh -R 7000:localhost:5000 user@192.168.1.10

C. ssh -L 7000:192.168.1.10:5000 user@localhost

D. ssh -L 7000:localhost:5000 user@192.168.1.10

Solution

1. Step 1: Identify the correct port forwarding direction

   You want to forward your local port 7000 to remote port 5000 on the server 192.168.1.10.

2. Step 2: Verify the command syntax

   ssh -L 7000:localhost:5000 user@192.168.1.10 forwards local port 7000 to remote localhost port 5000 correctly.

3. Final Answer:

   ssh -L 7000:localhost:5000 user@192.168.1.10 -> Option D

4. Quick Check:

   Local port 7000 tunnels to remote 5000 [OK]

Hint: Local port first, then remote host:port in -L [OK]

Common Mistakes:

• Using -R instead of -L for local forwarding
• Swapping local and remote ports
• Incorrect remote host or user syntax