ssher

English | 简体中文

ssher is an easy-to-use command line tool for connecting to remote servers.

Installation

• Install with cargo install

cargo install ssher

• Install from binary

For MacOS or Linux:

curl -sSL https://github.com/poneding/ssher-rs/raw/master/install.sh | sh

For Windows:

Download the lastest executable from Releases and add it to the PATH.

Usage

1. Select a server and connect

ssher
ssher -s <server>

2. Add a server

ssher add

3. Remove servers

# remove, rm
ssher rm
ssher rm <server_a> <server_b>

4. List servers

# list, ls
ssher ls

5. Rename a server

ssher rename
ssher rename <server_a>

6. Edit a server

ssher edit
ssher edit <server>

7. Check version

# version, v
ssher v

8. Help

ssher help

Completions

# bash
source <(ssher completion bash)
source <(COMPLETE=bash ssher)

# zsh
source <(ssher completion zsh)
source <(COMPLETE=bash zsh)

# fish
ssher completion fish | source
source (COMPLETE=fish ssher | psub)

# powershell
ssher completion powershell > ssher.ps1
. .\ssher.ps1
$env:COMPLETE = "powershell"
ssher | Out-String | Invoke-Expression

You can add the command to your shell's profile e.g. ~/.bashrc or ~/.zshrc to enable completions for each session.

Configuration

The configuration file is saved in the ~/.ssher.yaml file.

Troubleshooting

1. MacOS default bash version is too low, you may occur the following error when using completions source <(COMPLETE=bash ssher):

$ source <(COMPLETE=bash ssher)
error: Broken pipe (os error 32)

Solutions:

• Use the following command to upgrade bash:

brew install bash

• Generate completions to a file and source it:

COMPLETE=bash ssher > .ssher_bash_completion.sh
source .ssher_bash_completion.sh