README_en-US.md

ENG | 中文

ssher

ssher is a lightweight SSH connection management command-line tool that allows you to connect to your server more conveniently.

ssher developed with Go language, so it supports multiple platforms, including Linux, MacOS, and Windows.

🔍 Preview

⚙️ Installation

Go install

If you have already installed the Go environment locally, you can directly use go install to install:

go install github.com/poneding/ssher@latest

Wget binary

MacOS & Linux installation, refer to the following commands:

# MacOS
sudo wget https://ghproxy.ketches.cn/https://github.com/poneding/ssher/releases/download/v1.0.3/ssher_1.0.3_darwin_arm64 -O /user/local/bin/ssher && sudo chmod +x /user/local/bin/ssher

# Linux
sudo wget https://ghproxy.ketches.cn/https://github.com/poneding/ssher/releases/download/v1.0.3/ssher_1.0.3_linux_amd64 -O /user/local/bin/ssher && sudo chmod +x /user/local/bin/ssher

Note: Before downloading, make sure your system is arm64 or amd64, and download the corresponding binary file.
Windows installation, refer to the following steps:

Download the ssher.exe file first:

# Download .exe file
wget https://github.com/poneding/ssher/releases/download/v1.0.3/ssher_1.0.3_windows_amd64.exe

Add the ssher.exe file path to the environment variable after download done, or put it in a path that has already been added to the environment variable.

Download from browser

👉🏻 GitHub Releases

Compile from source

Go environment is required, then execute the following command:

git clone https://github.com/poneding/ssher.git
cd ssher
go build -o ssher main.go

🛠️ Usage

Get started

ssher

Execute the above command, you will enter the interactive mode, where you can use the ↓ ↑ → ← keys to select the ssh profile you want to connect to or add a new ssh profile.

SSH profile operation

# View the ssh profile list
ssher list

# Add ssh profile
ssher add

# Remove ssh profile
ssher remove

SSH Profile file operation

Profile file stores your server information, you can view and edit the profile file with the following commands:

# View profile
ssher profile view

# Edit profile
ssher profile edit

Version and upgrade

# Check version
ssher version

# Upgrade
ssher upgrade

Auto-completion

# Append the completion script to ~/.bashrc or ~/.zshrc
# bash
echo 'source <(ssher completion bash)' >> ~/.bashrc
source ~/.bashrc

# zsh
echo 'source <(ssher completion zsh)' >> ~/.zshrc
source ~/.zshrc

⭐️ Stars

Welcome to give me a Star ⭐️ if this project is helpful to you, your support is my greatest motivation.