SSH tunneling (port forwarding) in Linux CLI - Mini Project: Build & Apply

SSH Tunneling (Port Forwarding)

📖 Scenario: You work in a company where you need to securely access a database server that is only accessible from the company network. You want to use SSH tunneling (port forwarding) to connect to the database from your local machine.

🎯 Goal: Learn how to create a local SSH tunnel that forwards a local port to a remote database server port through an SSH server.

📋 What You'll Learn

Create a variable with the SSH server address

Create a variable with the remote database port

Write the SSH command to create a local port forwarding tunnel

Display the SSH command output or confirmation

💡 Why This Matters

🌍 Real World

SSH tunneling is used to securely access remote services like databases or web servers that are behind firewalls or private networks.

💼 Career

Many IT and DevOps roles require setting up SSH tunnels to securely connect to remote resources without exposing them publicly.

1

Set SSH server address

Create a variable called ssh_server and set it to [e-mail] which is the SSH server address.

Linux CLI

# Create a variable called ssh_server and set it to '[e-mail]'
# Your code here

Hint

Use single quotes to assign the string value to the variable.

2

Set remote database port

Create a variable called remote_db_port and set it to 5432, which is the port number of the remote database server.

Linux CLI

ssh_server='[e-mail]'
# Create a variable called remote_db_port and set it to 5432
# Your code here

Hint

Assign the port number as an integer without quotes.

3

Write SSH local port forwarding command

Create a variable called ssh_command that stores the SSH command string to forward local port 6543 to the remote database port 5432 on localhost through the SSH server stored in ssh_server. Use the syntax: ssh -L 6543:localhost:5432 [e-mail].

Linux CLI

ssh_server='[e-mail]'
remote_db_port=5432
# Create ssh_command variable with the SSH local port forwarding command
# Your code here

Hint

Use double quotes and variable substitution with ${variable} inside the string.

4

Display the SSH command

Write a command to print the value of the ssh_command variable to show the full SSH tunneling command.

Linux CLI

ssh_server='[e-mail]'
remote_db_port=5432
ssh_command="ssh -L 6543:localhost:${remote_db_port} ${ssh_server}"
# Echo the ssh_command variable
# Your code here

Hint

Use echo "$ssh_command" to display the command.

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