SSH jump host

From Gentoo Wiki
Jump to:navigation Jump to:search

An alternative to SSH tunneling to access internal machines through gateway is using jump hosts.

The idea is to use ProxyCommand to automatically execute ssh command on remote host to jump to the next host and forward all traffic through.


  • SSH access to the gateway machine and the internal one.
  • Gateway machine has Netcat installed.

Dynamic jumphost list

You can use the -J option to jump through a host:

user $ssh -J host1 host2

If usernames or ports on machines differ, specify them:

user $ssh -J user1@host1:port1 user2@host2 -p port2

Multiple jumps

The same syntax can be used to make jumps over multiple machines:

user $ssh -J user1@host1:port1,user2@host2:port2 user3@host3

Static jumphost list

Static jumphost list means, that you know the jumphost or jumphosts you need, to reach a host. Therefore you can create a static jumphost 'routing' in ~/.ssh/config file. The advantage in comparison to the dynamic jumphost option is, that you don't have to provide the .ssh config on jumphosts between your machine and all the other jumphosts between you and the final host you want to jump to.


FILE ~/.ssh/configProxyJump Example
### First jumphost. Directly reachable
Host betajump
### Host to jump to via
Host behindbeta
  ProxyJump  betajump


user $ssh behindalpha

If usernames on machines differ, specify them by modifing the correspondent ProxyJump line:

FILE ~/.ssh/configModify correspondent ProxyCommand
ProxyJump  otheruser@behindalpha

It works with scp command, too:

user $scp filename behindalphabeta:~/
The colon and path at the end is needed so that scp recognizes it as remote.

Multiple jumps

The same syntax can be used to make jumps over multiple machines:

FILE ~/.ssh/configAdd this text
### First jumphost. Directly reachable
Host alphajump
### Second jumphost. Only reachable via
Host betajump
  ProxyJump alphajump
### Host only reachable via alphajump and betajump
Host behindalphabeta
  ProxyJump betajump
user $ssh behindalphabeta


To ease the connecting even further:

External resources