Ruby

SSH Tunnel Through an Outbound SOCKS Proxy

Demonstrates reaching the SSH server through an outbound SOCKS proxy using the SocksVersion, SocksHostname, SocksPort, SocksUsername, and SocksPassword properties.

Background: This is the reverse direction from dynamic forwarding: here a SOCKS proxy is used to reach the SSH server, for networks where outbound connections must pass through one. SocksVersion is the switch — 0 means no SOCKS, while 4 or 5 selects the protocol. SOCKS5 supports username/password authentication and remote DNS; SOCKS4 supports only a username.

Chilkat Ruby Downloads

Download Chilkat for Ruby

Ruby

require 'chilkat'

success = false

#  Demonstrates reaching the SSH server through an outbound SOCKS proxy using the SshTunnel
#  properties SocksVersion, SocksHostname, SocksPort, SocksUsername, and SocksPassword.

tunnel = Chilkat::CkSshTunnel.new()

#  Set SocksVersion to 4 or 5 to route the outbound connection to the SSH server through a SOCKS
#  proxy.  A value of 0 (the default) means no SOCKS proxy.
tunnel.put_SocksVersion(5)
tunnel.put_SocksHostname("socks.example.com")
tunnel.put_SocksPort(1080)

#  SOCKS4 supports only a username; SOCKS5 supports username and password.
tunnel.put_SocksUsername("myProxyLogin")
tunnel.put_SocksPassword("myProxyPassword")

tunnel.put_DestHostname("db.internal.example.com")
tunnel.put_DestPort(5432)

#  Connect to the SSH server through the SOCKS proxy configured above.
sshPort = 22
success = tunnel.Connect("ssh.example.com",sshPort)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end

#  Normally you would not hard-code the password in source.  You should instead obtain it
#  from an interactive prompt, environment variable, or a secrets vault.
password = "mySshPassword"

success = tunnel.AuthenticatePw("mySshLogin",password)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end

listenPort = 1080
success = tunnel.BeginAccepting(listenPort)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end

print "Tunnel established through the SOCKS proxy." + "\n";

waitForThreadExit = true
success = tunnel.CloseTunnel(waitForThreadExit)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end