hss
is an interactive ssh client for multiple servers. It will provide almost the same experience as in the bash environment. It supports:
- interactive input: based on libreadline.
- history: responding to the
C-r
key. - auto-completion: completion from remote server on the
tab
key, for commands and paths.
Command is executed on all servers in parallel. Execution on one server does not need to wait for that on another server to finish before starting. So we can run a command on hundreds of servers at the same time.
Usage: hss [-f hostfile] [-o file] [-u username] [command]...
Options:
-f file file with the list of hosts
-H host specifies a host option, support the same options as the ssh command
-l limit number of multiple ssh to perform at a time (default: unlimited)
-u user the default user name to use when connecting to the remote server
-c opts specify the common ssh options (i.e. '-p 22 -i identity_file')
-o file write remote command output to a file
-O write remote command output to one log file per server
> file name like ~/.hss/<server>/date_per_day.log
-s transfer files over scp
-i force use a vi-style line editing interface
-v be more verbose
-V show program version
-h display this message
For more information, see https://github.com/six-ddc/hss
- This is a screenshot
You can pass "-f hostfile" where hostfile is a full path of a plain text file.
The application also uses folder named .hss/ in home as a default for the host files. if the path given is not found, the program will look for the file in .hss folder. You can then maintain easily hosts groups in a central way.
Please look at these commands:
hss -f demo -s /path/to/main.c remote:/tmp
hss -f demo -s remote:/path/to/main.c /tmp
You have to specify which side is the remote machine as SCP can go in either direction. You specify it always using "remote" keyword (it is not an alias)
you can also type:
hss -f demo -s /path/to/main.c
In this case /tmp is used as the default target.
- MacOS
brew install hss
-
Linux
- Install dependency
## on CentOS yum install readline-devel ## on Ubuntu / Debian apt-get install libreadline6-dev
- Compile and install
make && make install
-
Or you can download the binary release here .
The fundamental of hss
is to execute the ssh
command for every host
, and then show the results on the terminal. So hss
supports every argument supported by the ssh
command. Following is an example of the hostfile
:
192.168.1.1
-p 2222 root@192.168.1.2
-p 2222 -i ~/.ssh/identity_file root@192.168.1.3
-p 2222 -oConnectTimeout=3 root@192.168.1.4
Connect to servers:
# Specify the hostfile directly
hss -f hostfile
# Or pass servers in arguments
hss -H '192.168.1.1' -H '-p 2222 root@192.168.1.2' -H '-p 2222 -i ~/.ssh/identity_file root@192.168.1.3' -H '-p 2222 -oConnectTimeout=3 root@192.168.1.4'
Passthrough of ssh
arguments are supported. For example, by specify -c '-oConnectTimeout=3'
, sessions without a timeout configured will set its timeout on this argument.
The interactive input is implemented on libreadline
, supporting command and path completion from remote, history storage and searching, moving around, etc. (please refer to readline for more)
- Command history is stored in file
~/.hss_history
. - Completion of commands and paths are based on the first server in the list.
- Path completion is available when the first input character is
/
,~
or.
.
- Solve the "@" suffix problem on directory symbol-link.