How to tunnel Remote Desktop (RDP) over SSH with PuTTY.

Have you ever been in a situation where you needed to perform remote administration on a Windows Server, and the RDP port 3389 is blocked on a firewall? Did you know you can tunnel RDP over SSH with PuTTY? This particularly comes in handy when there is no VPN available to the remote network… Here is how to set up a RDP SSH tunnel with PuTTY.

Proxy connections with SSH

SSH can proxy connections both forward and backwards. It creates a secure connection between a local computer and a remote machine through which services can be relayed. Because the connection is encrypted, SSH tunneling is useful for transmitting information that uses an unencrypted protocol, such as IMAP, VNC, or IRC. And RDP :)

SSH can proxy connections both forward and backwards, by opening a port on either the local machine running the SSH client, or the remote SSH server. If you have privileges to do so of course.

For example, if you want to connect to a remote host on RDP port 3389, but you don’t have direct access to reach that machine because of firewall or network restrictions, the SSH client can listen on a local port and pretend that it is the remote machine. All connections to that port will be sent through the SSH server to the remote host.

Tunnel Remote Desktop Protocol (#RDP) through #ssh with PuTTY Click To Tweet

Reconfigure PuTTY for Remote Desktop Protocol (RDP) tunneling through ssh

To tunnel Remote Desktop Protocol over ssh using PuTTY, all you need is an account on the premises. For example a firewall or Linux server with ssh access, and PuTTY on your Windows desktop. PuTTY is a nifty ssh client for Windows that you can download here.

Read this too:   How to optimize PHP OPcache configuration

Once you are connected to your remote network with ssh/PuTTY, you need to reconfigure the connection to support SSH-tunneling. In the PuTTY Reconfiguration screen, go to Connection → SSH → Tunnels. This is where we can set up an SSH tunnel for Remote Desktop.

Under Source port, add your local IP address and port. Because the RDP 6+ client in Windows has issues with the loopback to TCP Port 3390, you need to use a different port. I use TCP port 3388 on IP address 127.0.0.2, and my remote internal IP address and RDP port 3389 as Destination (192.168.48.211:3389). See the image:

SSH port forwarding in PuTTY
SSH port forwarding in PuTTY

After clicking Apply, the SSH-tunnel for remote desktop is active, and you can connect the Remote Desktop Connection to 127.0.0.2:3388:

Remote Desktop Connection through SSH tunnel
Remote Desktop Connection through SSH tunnel

For Windows, PuTTY is the de-facto standard SSH client.

Tunnel RDP through SSH & PuTTY Click To Tweet

How to tunnel Windows Remote Desktop through ssh on Linux

On a side note, when you are in a situation where you are on a Linux work station and need to tunnel RDP through ssh in Linux, you can use the following ssh port forwarding, or tunnel (assuming you have an on-premise Linux server to SSH into to set up the port forward):

ssh port forwarding / tunnel set-up for RDP

ssh -L 13389:[Windows Server RDP address]:3389 [address ssh server] -l [ssh username] -N

Now you can connect your RDP client to 127.0.0.1:13389 as if it were the remote server.

Read this too:   Setting up Monit monitoring in Windows Subsystem for Linux WSL

Some Remote Desktop clients for Linux are:

  • KRDC – KRDC is a client application that allows you to view or even control the desktop session on another machine that is running a compatible server. VNC and RDP is supported
  • Remmina – A feature rich Remote Desktop Application for Linux and other Unixes
  • rdesktop – rdesktop is an open source UNIX client for connecting to Windows Remote Desktop Services, capably of natively speaking Remote Desktop Protocol (RDP) in order to present the user’s Windows desktop
  • xfreerdp – FreeRDP is a free implementation of the Remote Desktop Protocol (RDP), released under the Apache license
See this list of common Remote Desktop clients for #Linux Click To Tweet

Or do you need to change port forwarding options in an existing ssh connection?

Tunnel RDP using OpenSSH and PowerShell in Windows 10

If you have the OpenSSH client installed in Windows 10, then you can use a command similar to Linux’ ssh tunnel:

ssh -N -L 13389:[Windows Server RDP address]:3389 [address ssh server] -l [ssh username] -N

To ease the usage, I wrapped in a PowerShell script, that connects to my on-premise stepping-stone host with ssh:

$remHost = (Read-host -Prompt ("RDP host: "))
Write-Output "Setting up an SSH RDP tunnel with ${remHost}"
Start-Process ssh -ArgumentList "-N -L 13389:${remHost}:3389 -l [ssh username] steppingstone-host.example" -Verb open
[void](Read-Host 'Press Enter to continue...')
&mstsc /V:localhost:13389 /w:800 /h:600 /prompt

Protip: use this PowerShell one-liner to verify whether OpenSSH client is installed on your Windows 10 system. It should print Installed.

(Get-WindowsCapability -Online | ? Name -like 'OpenSSH.Client*').State

Tunnel ssh using sshuttle

Another great option is to tunnel ssh using sshuttle, on GNU/Linux. From its manpage:

sshuttle allows you to create a VPN connection from your machine to any remote server that you can connect to via ssh, as long as that server has python 2.3 or higher.
To work, you must have root access on the local machine, but you can have a normal account on the server.

It’s valid to run sshuttle more than once simultaneously on a single client machine, connecting to a different server every time, so you can be on more than one VPN at once.

If run on a router, sshuttle can forward traffic for your entire subnet to the VPN.

If you have an on-premise host / hop / stepping stone, you can use the following sshuttle example:

sshuttle -r username@steppingstone-host.example 192.168.0.0/16

This’ll easily create a VPN (Virtual Private Network) connection from your machine to any remote server that you can connect to via ssh.

Read this too:   Forfiles: How to delete files recursively on Windows Server

Unfortunately you cannot use sshuttle from Windows Subsystem for Linux (WSL) in Windows 10, yet: Command: ” iptable -L ” is not working.

6 replies
  1. Mark Eastwood
    Mark Eastwood says:

    I have a tunnel open on port 8080:remote-server:3389 bastion -l user-name -N… but when I try to connect the MacOS RDP app to my Windows server on the other end …

    channel 2: open failed: connect failed: Connection refused

    Reply
  2. Pablo H
    Pablo H says:

    The Linux instructions also work great on MacOS. BTW, if you specify -f on the ssh command, it will put itself in the background.

    Reply
  3. LEVI BALIEIRO LUGATO
    LEVI BALIEIRO LUGATO says:

    I tried to do the Tunnel but when i try to connect via RDP i get “internal error”

    Reply
    • Jan Reilink
      Jan Reilink says:

      Assuming you meant the PowerShell and OpenSSH tunneling solution, I tried to debug it. Turns out that, when I use a short host name, that cannot be resolved on the ssh server, I get an error message:

      channel 2: open failed: administratively prohibited: open failed

      And my RDP client would also quit with An internal error has occured.. Filling out the complete host name resolved it for me.

      Reply

Leave a Reply

Want to join the discussion?
Feel free to contribute!

Leave a Reply

Your email address will not be published. Required fields are marked *