Dynamic port forwarding with SSH and SOCKS5
Antonio Gioia, 2015
In this article i collected all the necessary information and useful tips to create SSH tunnels between hosts in order to protect internet traffic with an encrypted layer.
- What is SSH
- Why you need to use a SSH tunnel
- Public and private key pair
- VPS setup and firewall
- Dynamic port forwarding in details
- Configure browser, email, instant messages
- Optional configurations
What is SSH
SSH stands for Secure Shell and is described on Wikipedia as “a cryptographic (encrypted) network protocol for initiating text-based shell sessions on remote machines in a secure way”.
SSH can do much more than remote shell. For example you can copy files from local to remote host (local forward) or mount a remote file system on your computer (remote forward) or tunnel to internet from a local SOCKS proxy (dynamic forward).
In this article i will explain how to forward and encrypted network traffic between a local SOCKS5 proxy and a VPS (virtual private server).
- SSH enables port forwarding with encrypted tunnel
- SOCKS5 (Socket Secure) provides a proxy server to route traffic between client and server using authentication
- VPS is our remote server that connect us to internet
- Applications needs to be configured to make use of the tunnel
Why you need a SSH tunnel
The answer is simple: SSH dynamic port forwarding is the fastest and cheapest way to protect your traffic from undesired eyes.
- An additional layer to protect your identity
- An encrypted channel of internet traffic
- A less risky communication environment for your privacy
A few practical examples:
- You can connect to open networks and no one can read in clear your network packets, assuming you carefully protect your private key
- You can reach content blocked because of your location
- You can circumvent firewalls
Private and public key pair
The very first thing you need to setup is a private and public key pair. With this keys you can authenticate the client (your machine) on a remote server.
- Generate both keys, private and public, on your computer
- Protect private key with long, possibly complex pass phrase. You need to enter it every time you want to create a SSH connection
- Copy the public key on the server you want to log in
- SSH opens a connection only to clients matching the server public key with the right client private key
This process ensures a higher level of security compared to passwords protected accounts vulnerable to brute force attacks.
You need to protect your private key, anyone owning it can authenticate himself as you on every server that can match relative public key.
You can create a different keys pair for every remote host you intend to connect with SSH, this way if one private key gets compromised you have an isolated case.
Let’s create SSH keys. On your computer terminal type:
ssh-keygen -t rsa
Next step is to choose a name for the keys. If you would just press enter it would assign the default name idrsa and idrsa.pub and those would became your default keys. I prefer instead to define a custom name for a pair used only for SSH tunnel: idrsatunnel as private key and idrsatunnel.pub as public one.
Enter file in which to save the key (/home/user/.ssh/id_rsa): id_rsa_tunnel
Enter two times the pass phrase you want to use for your private key and you are done. Your keys are located in your home directory,
/home/user/.ssh/id_rsa_tunnel (private) and
/home/user/.ssh/id_rsa_tunnel.pub (public) where /user/ is the user you are logged in.
VPS setup and firewall
Your remote host, a VPS in this case, is going to route your traffic to internet. Choose the right VPS provider according to your needs. Once you have the remote public IP it’s convenient to change your hosts file, assuming the public IP of your VPS is 220.127.116.11 (I just invented it) you can add this line to file
/etc/hosts naming it “tunnel”:
Save (you need to be root) and quit. From now on your system will recognize your remote host with the word “tunnel”. Open a terminal and type:
You should get a remote shell as root after you type in the password. Once logged in update server:
and install new packages if any. Install the tools needed:
apt-get install sudo ufw
sudo grants administrative permissions to regular users and
ufw stands for Uncomplicated Firewall, an easy to use front end for
It’s time to create a regular user account and say goodbye to root. Go for a generic name like “sshuser” and choose a password easy to remember and difficult to brute force, finally add user to sudo, each line is a different command to enter:
useradd -s /bin/bash -m -d /home/sshuser -c "sshuser" sshuser passwd sshuser usermod -aG sudo sshuser
You can now log out from root session.
It’s now time to SSH into the VPS using the user account you just created but first you have to associate your public key to the account. There is a tool called
ssh-copy-id that will help with this. You just have to run:
and your default public key will be automatically copied securely to remote host (use option -i to define a custom public key). If you created the key pair following the article you have to type:
ssh-copy-id -i ~/.ssh/id_rsa_tunnel.pub sshuser@tunnel
Now you can log in into your VPS with:
Enter the pass phrase and you are in. It’s time to change the server SSH configuration in
/etc/ssh/sshd_config. Open file with sudo and check the following lines, if not there add them:
Port 5432 Protocol 2 UsePrivilegeSeparation yes PermitRootLogin no StrictModes yes PubkeyAuthentication yes AuthorizedKeysFile %h/.ssh/authorized_keys PasswordAuthentication no X11Forwarding no TCPKeepAlive yes AllowUsers sshuser AllowTcpForwarding yes
SSH default port is 22 but you can obfuscate a little the traffic setting it to port 5432, usually adopted by PostgreSQL. With
PasswordAuthentication we block possible easy attacks and with
AllowUsers you restrict access even more to only your user.
Last step to strengthen your server is to configure the firewall. All you have to do is allowing connections only to the port you want to connect and limit possible brute force attacks.
sudo ufw allow 5432/tcp
Opens the TCP port 5432 from outside connections.
sudo ufw limit 5432/tcp
sudo service ufw restart
Restart firewall to enable changes. Your remote server is now ready.
Dynamic port forwarding in details
You have now everything ready to create a SSH tunnel. Open a terminal on your computer and type:
ssh -D 8080 -N -p 5432 sshuser@tunnel -vv
If everything works as expected the tunnel is created after you type the pass phrase. That’s it.
The command in details:
-Denables dynamic forwarding
8080is the port of localhost you are going to listen with proxy, can be any port open of your computer
-Nstops SSH from executing commands
-pis the port of the remote host you connect to, you configured the firewall server to keep port 5432 open
-vvis very verbose output on console (
-vvvare less and more verbose). I suggest to keep this option the very first times to have a better idea of what’s going on with the SSH connection and remove it later on.
You can fork the process in the background and keep SSH quiet with the options
ssh -D 8080 -fNq -p 5432 sshuser@tunnel
Tunnel is now up. All traffic can now be routed trough your localhost (or 127.0.0.1) from port 8080 to your VPS and then to internet.
Note this will work using your default private key. To specify the private key you created earlier use the option
ssh -i ~/.ssh/id_rsa_tunnel -D 8080 -fNq -p 5432 sshuser@tunnel
You SSH connection is now in the background. To close it you have to terminate the process; use
htop to find and kill it.
Configure browser, email, instant messages
Every applications not listening on SOCKS proxy will leak packets out of the tunnel. It’s important you configure all applications you normally use for internet to make use of the proxy.
Tunnel is created so let’s open a browser to access internet. You can open Chromium from terminal typing:
chromium --temp-profile --proxy-server="socks5://localhost:8080"
Note the flag
—-proxy-server that tells Chromium where is located the proxy. This is enough to browse using the SSH tunnel.
You can add more flags to a Chromium session, there is plenty of chromium command line switches listed here. Why not running incognito mode and disable most functionalities you don’t use:
chromium --temp-profile --incognito --no-referrers --enable-strict-mixed-content-checking --disable-java --disable-plugins --no-experiments --no-pings --disable-preconnect --disable-translate --dns-prefetch-disable --disable-background-mode --proxy-server="socks5://localhost:8080"
Add or remove flags depending on your needs.
To configure Firefox (known as Iceweasel on Linux) click on the menu icon and go to Preferences. Click on the tab Advanced and on the inner tab Network. Finally click on Settings button and click on “Manual proxy configuration” typing “localhost” in the field next to SOCKS Host, port 8080. Click on SOCKS v5 if not selected. Click on OK and your browsing should now be encrypted.
Watch out for DNS leaks using Firefox (or Iceweasel). Open the config window typing
about:config where you would type a URL and press enter. Search for
network.proxy.socks_remote_dns and set it to true. Test results before and after the changes on dnsleaktest.com.
The procedure to enable SOCKS proxy on Thunderbird (or Icedove on Linux) is similar as for Firefox described above. Menu, Preferences, Preferences, Advanced, Network and Disk Space, Settings and then configure proxy same way.
Pigdin is a universal chat client that supports most common protocols and social network chats. In one application you can chat over many networks and in combination with OTR plugin you can encrypt your messages over not secure networks. You can configure Pidgin to use the proxy as well, just open Preferences and under Network label you can set the Proxy Server as SOCKS5, host is “localhost” and port 8080.
If you are more old school and chat over IRC with
irssi client, type within the console (each line is a different commando to enter):
/set proxy_address 127.0.0.1 /set proxy_port 8080 /set use_proxy ON
Note that 127.0.0.1 is the address of
localhost. I wrote an article about IRC, SSL and OTR configurations if you want to know more.
You can now create shortcuts for future SSH sessions. You can also run a script at boot time that opens a tunnel in background. You can find many examples on internet about it. I personally prefer to create and delete tunnels as i need it, without any automation.
Remember the command to open a tunnel:
ssh -i ~/.ssh/id_rsa_tunnel -D 8080 -fNq -p 5432 sshuser@tunnel
To create a shortcut to this command edit or create a config file on your computer at:
/home/user/.ssh/config and add the lines:
Host tunnel HostName 18.104.22.168 Port 5432 User sshuser IdentityFile ~/.ssh/id_rsa_tunnel.pub
Now to open a SSH tunnel you can type:
ssh -fNq tunnel
An even better alternative are alias. Add the following line to
.bashrc file in your home directory:
alias sshtunnel='ssh -i ~/.ssh/id_rsa_tunnel -D 8080 -fNq -p 5432 sshuser@tunnel'
And now you can create a tunnel just typing:
There is one more shortcut available. You can avoid to type the same damn long pass phrase every time you want to log in your VPS: use
ssh-add, an SSH agent that takes care of your private keys identities. Type:
Press enter and type the pass phrase. If ssh agent is not started type:
and repeat the ssh-add command. Log in your server with SSH now and if everything is correct you should automatically get the remote shell.
Another important add on useful for tunnels is autossh, a tool to automate SSH reconnections if the tunnel drops for network connectivity problems.
- OpenSSH, project homepage
- SOCKS, protocol standards
- Ufw, un-complicated firewall
- SSHguard, log monitor
- autossh, restarts SSH sessions and tunnels
Feel free to save or share this article. If you notice a mistake or want to contribute to a revision of the article contact me at firstname.lastname@example.org.
Cover picture by Francesco Ungaro