From ebc10e3bfb061923dfeacf781b31f87a0fd093c3 Mon Sep 17 00:00:00 2001 From: serverco Date: Sat, 16 Jan 2016 11:52:48 +0000 Subject: [PATCH] Create README.md --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7a78b95 --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# rssh +route ssh through a series of hosts (for if you / the servers are behind firewalls etc) + +This is a script to enable you to route ssh though a series of host to connect to your final host, and then either run as standard SSH, have a forward proxy, or run a command + +``` + rssh ver. 0.1 + route ssh through a series of hosts + + Usage: rssh [-h|--help] [-v] [-s socks_port] sever1 server2 [server3] [server4 ....etc] [-c command] + + Options: + -h, --help Display this help message and exit. + -v verbose output from ssh + -d debug on + -D debug off + -s nnnn socks port + -c command command to run on remote server + + note: This script assumes that any hosts in your ~/.ssh/config file have a non-indented Host + line and the rest of the items related to that host are indented. +``` + +The script reads any hosts you have in your standard ~/.ssh/config file and uses the main attributes for those hosts. It assumes that your config file is indented in a convetional manner i.e. +``` +Host server1 + Hostname 8.8.8.8 + PasswordAuthentication yes + +Host myhomeserver + Hostname homeserver.mydomain.com + KexAlgorithms curve25519-sha256@libssh.org,diffie-hellman-group-exchange-sha256,diffie-hellman-group14-sha1 + +Host devel + Hostname dedicated862.example.com + Port 1292 +``` + +The script works by creating a temporary ssh config file, with all the parameters needed, then running ssh with that. This enables you to then easily create a socks proxy or whatever you need