win-sshpass

Related Project

go-web-frame — Effortless auth: declare required permissions on routes, verify once in a Filter, keep handlers clean. Generic Model for full-stack CRUD: define a struct, and create/read/update/delete just works. Lightweight, install only the components you need. No code generation, no CI tooling required — the most elegant Go web full-stack framework.

win-sshpass

English | 简体中文 | 繁體中文 | 日本語

A cross-platform implementation of sshpass (Windows & Linux), providing similar functionality to the Linux sshpass tool.

💡 Like this project? Give it a ⭐ Star — it helps others discover the tool!

Features

SSH login with password or private key authentication
Execute remote commands or open interactive shell
File upload/download via SFTP (with progress bar)
SCP-style and Rsync-style file transfer
Config file support for managing multiple servers
Interactive shell with raw terminal mode (proper echo, Ctrl+C, and full-screen app support)
Dynamic terminal resizing in interactive shell mode
Git Bash path conversion detection and auto-fix
IPv6 address support
Support for Windows (x64, ARM64) and Linux (amd64, arm64)
Reusable Go SDK — import as a library (package sshpass) to embed SSH/SFTP/shell in your own app, with injectable I/O streams and progress callbacks
Proxy support — tunnel SSH connections through SOCKS5/SOCKS4/HTTP/HTTPS proxies
Breakpoint resume — resume interrupted SFTP file transfers from where they left off
File hash & verify — compute and verify local file hashes (MD5, SHA-1, SHA-256, SHA-512)

Download

Download the latest release from GitHub Releases:

Windows

Architecture	Zip	MSI Installer
x64 (amd64)	`win-sshpass-*-amd64.zip`	`win-sshpass-*-amd64.msi`
ARM64	`win-sshpass-*-arm64.zip`	`win-sshpass-*-arm64.msi`

Linux

Architecture	Tarball
amd64	`win-sshpass-*-linux-amd64.tar.gz`
arm64	`win-sshpass-*-linux-arm64.tar.gz`

Go to Releases page
Download the package for your platform and architecture
Windows MSI: run the installer — it will add the install directory to your system PATH automatically
Windows Zip / Linux tar.gz: extract and place the binary in your PATH

Zero dependencies: win-sshpass.exe is a standalone binary. No need to install OpenSSH or any other software. Download it, put it in your PATH, and you're ready to go.

Install via Scoop

scoop bucket add chuccp https://github.com/chuccp/scoop-bucket
scoop install win-sshpass

Install via WinGet

winget install chuccp.win-sshpass

Quick Start

# Password login and execute command
win-sshpass -p 'password' ssh user@example.com 'whoami'

# Private key login and execute command
win-sshpass -i ~/.ssh/id_ed25519 ssh user@example.com 'hostname'

# Upload file
win-sshpass -h example.com -p 'password' -local file.txt -remote /tmp/file.txt

# Download file
win-sshpass -h example.com -p 'password' -d -remote /tmp/file.txt -local ./file.txt

Interactive Shell

When no command is specified, win-sshpass opens an interactive shell with raw terminal mode:

win-sshpass -p 'password' ssh user@host

Raw terminal mode features:

Proper echo — typed characters are displayed correctly (no double echo)
Ctrl+C / Ctrl+Z — signals are forwarded to the remote process
Full-screen apps — vim, top, htop, nano, etc. work correctly
Dynamic terminal resizing — the remote terminal automatically matches your local window size
Tab completion — remote shell tab completion works as expected

File Transfer in Interactive Shell

While connected, use rz / sz commands to transfer files (no need to install anything on the remote server):

# Upload file to remote current directory (opens file picker)
rz

# Upload specific local file
rz /local/path/to/file

# Download remote file (opens save dialog)
sz /remote/path/to/file

# Download remote file to specific local path
sz /remote/path/to/file /local/save/path

How it works: When the remote shell reports rz/sz: command not found, the tool intercepts it and performs the transfer over SFTP instead. Files and directories are both supported, with progress bars.

Command Format

SSH Login

# Password authentication
win-sshpass -p <password> ssh [user@host] [command]
win-sshpass -p <password> ssh -p <port> user@host 'command'
win-sshpass -p <password> ssh -o StrictHostKeyChecking=no user@host

# Interactive shell (raw terminal mode: proper echo, Ctrl+C, vim/top support)
win-sshpass -p <password> ssh user@host

# Private key authentication
win-sshpass -i <private_key_path> ssh [user@host] [command]

# Password from environment variable
SSHPASS=<password> win-sshpass -e ssh user@host

# Password from file
echo 'password' > pass.txt
win-sshpass -f pass.txt ssh user@host

# Configuration file (multi-line format)
win-sshpass -f server.config

File Transfer

Git Bash users: Use // prefix for remote paths, e.g. -remote //tmp/file.txt. See Git Bash Notes below.

# Upload file
win-sshpass -h <host> -p <password> -local <local_path> -remote <remote_path>

# Upload multiple files (comma-separated)
win-sshpass -h <host> -p <password> -local "a.txt,b.txt,c.txt" -remote //tmp/

# Upload multiple files (space-separated, only for simple paths without / or \)
win-sshpass -h <host> -p <password> -local "a.txt b.txt c.txt" -remote //tmp/

# Upload directory (auto-recursive)
win-sshpass -h <host> -p <password> -local <local_dir> -remote <remote_dir>

# Download file/directory
win-sshpass -h <host> -p <password> -d -remote <remote_path> -local <local_path>

SCP Style

# Upload file
win-sshpass -p <password> scp <local_file> user@host:<remote_path>
win-sshpass -p <password> scp -P <port> <local_file> user@host:<remote_path>

# Upload directory
win-sshpass -p <password> scp -r <local_dir> user@host:<remote_path>

# Download file/directory
win-sshpass -p <password> scp user@host:<remote_file> <local_path>

Rsync Style

# Upload
win-sshpass -p <password> rsync -avz <local_path> user@host:<remote_path>

# Download
win-sshpass -p <password> rsync -avz user@host:<remote_path> <local_path>

Parameters

Parameter	Description	Example
`-p`	Password	`-p 'secret123'`
`-i`	Private key path	`-i ~/.ssh/id_ed25519`
`-f`	Password file / config file	`-f pass.txt`
`-e`	Read password from SSHPASS env var	`SSHPASS='pass' win-sshpass -e ssh ...`
`-h`	Host address	`-h example.com`
`-u`	Username, default: root	`-u ubuntu`
`-P`	Port, default: 22	`-P 2222`
`-c`	Command to execute	`-c 'ls -la'`
`-local`	Local path(s) (comma or space separated)	`-local "a.txt,b.txt"`
`-remote`	Remote path (upload/download)	`-remote /tmp/file.txt`
`-d`	Download mode	`-d`
`-k`	Enable strict host key verification	`-k`
`-t`	Total operation timeout in seconds (0 = no limit)	`-t 30`
`-ct`	TCP connection timeout in seconds (default: 10)	`-ct 5`
`-retry`	Total connection attempts (default: 3)	`-retry 5`
`-resume`	Resume interrupted file transfer from breakpoint	`-resume`
`-proxy`	Proxy URL (socks5/socks4/http/https)	`-proxy socks5://127.0.0.1:1080`
`-v`	Show version	`-v`
`-help`	Show help message	`-help`

Hash & Verify

Compute and verify local file hashes without needing an SSH connection:

# Compute hash
win-sshpass hash md5 ./file.iso
win-sshpass hash sha256 ./file.iso

# Verify file against expected hash
win-sshpass verify sha256 d1dc38f6df... ./file.iso
# Output: OK  (or: FAILED)

Supported algorithms: md5, sha1, sha256, sha512.

Configuration File Format

host: example.com
username: root
password: your_password
port: 22
# key: ~/.ssh/id_ed25519  # optional, use private key instead of password
# timeout: 0              # optional, total operation timeout in seconds (0 = no limit)
# connect_timeout: 10     # optional, TCP connection timeout in seconds
# strict_host_key: false  # optional, enable strict host key verification
# proxy: socks5://user:pass@127.0.0.1:1080  # optional, proxy URL (socks5/socks4/http/https)

Usage:

win-sshpass -f server.config -c 'ls -la'
win-sshpass -f server.config 'ls -la'

Complete Examples

# 1. Password login and execute command
win-sshpass -p 'mypass' ssh root@192.168.1.100 'docker ps'

# 2. Private key login and execute sudo command
win-sshpass -i ~/.ssh/id_ed25519 ssh ubuntu@server.com 'sudo systemctl restart nginx'

# 3. Upload entire directory to server
win-sshpass -h server.com -p 'mypass' -local ./dist -remote //var/www/html

# 4. Download server log directory
win-sshpass -h server.com -p 'mypass' -d -remote //var/log/nginx -local ./logs

# 5. SCP upload file
win-sshpass -p 'mypass' scp ./app.jar user@server.com:/opt/app/

# 6. Password via environment variable (more secure)
export SSHPASS='mypass'
win-sshpass -e ssh user@server.com 'whoami'

# 7. Operation timeout (abort after 30 seconds)
win-sshpass -p 'mypass' -t 30 ssh user@server.com 'long-running-command'

# 8. Config file with positional command
win-sshpass -f server.config 'docker ps'

# 9. Resume interrupted upload
win-sshpass -p 'mypass' -h server.com -local ./bigfile.iso -remote //data/bigfile.iso -resume

# 10. Compute file hash
win-sshpass hash sha256 ./download.iso

# 11. Verify file integrity
win-sshpass verify sha256 d1dc38f6dfb1e4c8... ./download.iso

Proxy Support

Tunnel SSH connections through a proxy server. Supported protocols: SOCKS5, SOCKS4, SOCKS4A, HTTP CONNECT, and HTTPS CONNECT.

# SOCKS5 proxy
win-sshpass -p 'pass' -proxy socks5://127.0.0.1:1080 ssh user@host

# SOCKS5 with authentication
win-sshpass -p 'pass' -proxy socks5://proxyuser:proxypass@127.0.0.1:1080 ssh user@host

# SOCKS4 proxy
win-sshpass -p 'pass' -proxy socks4://192.168.1.1:1080 ssh user@host

# HTTP CONNECT proxy
win-sshpass -p 'pass' -proxy http://proxy.local:8080 ssh user@host

# HTTPS CONNECT proxy with authentication
win-sshpass -p 'pass' -proxy https://user:pass@proxy.local:8443 ssh user@host

# Proxy with file transfer
win-sshpass -p 'pass' -proxy socks5://127.0.0.1:1080 -h host -local ./file.txt -remote /tmp/file.txt

# Proxy with SCP
win-sshpass -p 'pass' -proxy socks5://127.0.0.1:1080 scp ./app.jar user@host:/opt/app/

# Proxy via config file
# proxy: socks5://user:pass@127.0.0.1:1080

Git Bash Notes

Use // prefix for remote paths to avoid path conversion:

# Wrong: /tmp will be converted to Windows path
win-sshpass ... -remote /tmp/file.txt

# Correct: use double slashes
win-sshpass ... -remote //tmp/file.txt

Use as a Go SDK

win-sshpass is also a reusable Go library (package sshpass). Import it to embed SSH/SFTP/shell capabilities in your own application:

go get github.com/chuccp/win-sshpass

package main

import (
	"log"

	sshpass "github.com/chuccp/win-sshpass"
)

func main() {
	cfg := sshpass.NewConfig()
	cfg.Host = "example.com"
	cfg.User = "root"
	cfg.Password = "secret"

	// NewClient dials and returns a ready-to-use client.
	client, err := sshpass.NewClient(cfg, sshpass.WithSignalHandler())
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()

	// Execute a command (output streams to os.Stdout/os.Stderr by default).
	if err := client.Exec("uname -a"); err != nil {
		log.Fatal(err)
	}

	// Upload a file over SFTP.
	sftp, err := client.SFTP()
	if err != nil {
		log.Fatal(err)
	}
	defer sftp.Close()
	if err := sftp.Upload("./local.txt", "/tmp/remote.txt"); err != nil {
		log.Fatal(err)
	}
}

Customization options

Behavior is configured through functional options passed to NewClient:

Option	Purpose
`WithStdin(r)` / `WithStdout(w)` / `WithStderr(w)`	Redirect I/O streams (default `os.Stdin`/`os.Stdout`/`os.Stderr`).
`WithProgress(fn)`	Set a `ProgressFunc` callback that receives `(description string, sent, total int64)` during SFTP transfers. The SDK performs no rendering — callers display progress however they like. Defaults to none (headless-friendly).
`WithFileSelector(s)`	Set the `FileSelector` used by the rz/sz shell-transfer fallback. The SDK ships no default implementation; without one, rz/sz prompts for a path on stdin.
`WithSignalHandler()`	Register a Ctrl+C handler that closes the connection. Off by default so the library never interferes with host signal handling.

The SDK intentionally bundles no UI code (no progress bar, no file dialog). Those concerns live in the CLI package (cmd/sshpass/ui.go), which wires a progressbar-based ProgressFunc and a zenity-based FileSelector into the client. Library users provide their own.

To tunnel the SSH connection through a proxy, set Config.ProxyURL before calling NewClient:

cfg := sshpass.NewConfig()
cfg.Host = "example.com"
cfg.User = "root"
cfg.Password = "secret"
cfg.ProxyURL = "socks5://user:pass@127.0.0.1:1080" // or http://, https://, socks4://

client, err := sshpass.NewClient(cfg)

Lower-level helpers are also exported for advanced use: Dial, NewConfig, LoadConfig, LoadConfigOrPasswordFile, ParseSSHArgs, ParseSCPArgs, ParseRsyncArgs, DetectCommandType, RunSCP, RunRsync, CleanRemotePath, SplitPaths, ParseUserHostPath, ExitCodeFromError.

Build

# Windows
go build -o win-sshpass.exe ./cmd/sshpass

# Linux / macOS
go build -o win-sshpass ./cmd/sshpass

# Cross-compile
GOOS=linux   GOARCH=amd64 CGO_ENABLED=0 go build -o win-sshpass ./cmd/sshpass
GOOS=windows GOARCH=amd64               go build -o win-sshpass.exe ./cmd/sshpass
GOOS=darwin  GOARCH=arm64               go build -o win-sshpass ./cmd/sshpass

Dependencies

Go 1.23+
golang.org/x/crypto/ssh
github.com/pkg/sftp
github.com/schollz/progressbar/v3 (CLI progress bar only)
github.com/ncruces/zenity (CLI file dialogs only)

Name		Name	Last commit message	Last commit date
Latest commit History 78 Commits
.github/workflows		.github/workflows
cmd/sshpass		cmd/sshpass
docs-site		docs-site
.gitignore		.gitignore
ARTICLE.md		ARTICLE.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.ja.md		README.ja.md
README.md		README.md
README.zh-CN.md		README.zh-CN.md
README.zh-TW.md		README.zh-TW.md
args.go		args.go
args_test.go		args_test.go
client.go		client.go
client_test.go		client_test.go
config.go		config.go
config_test.go		config_test.go
doc.go		doc.go
go.mod		go.mod
go.sum		go.sum
hash.go		hash.go
hash_test.go		hash_test.go
options.go		options.go
options_test.go		options_test.go
proxy.go		proxy.go
proxy_test.go		proxy_test.go
scp.go		scp.go
sftp.go		sftp.go
sftp_test.go		sftp_test.go
shell_transfer.go		shell_transfer.go
shell_transfer_test.go		shell_transfer_test.go
ssh.go		ssh.go
ssh_resize_unix.go		ssh_resize_unix.go
ssh_resize_windows.go		ssh_resize_windows.go
test_readme.sh		test_readme.sh
util.go		util.go
util_test.go		util_test.go
version.go		version.go

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Related Project

win-sshpass

Features

Download

Windows

Linux

Install via Scoop

Install via WinGet

Quick Start

Interactive Shell

File Transfer in Interactive Shell

Command Format

SSH Login

File Transfer

SCP Style

Rsync Style

Parameters

Hash & Verify

Configuration File Format

Complete Examples

Proxy Support

Git Bash Notes

Use as a Go SDK

Customization options

Build

Dependencies

About

Uh oh!

Releases 8

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Related Project

win-sshpass

Features

Download

Windows

Linux

Install via Scoop

Install via WinGet

Quick Start

Interactive Shell

File Transfer in Interactive Shell

Command Format

SSH Login

File Transfer

SCP Style

Rsync Style

Parameters

Hash & Verify

Configuration File Format

Complete Examples

Proxy Support

Git Bash Notes

Use as a Go SDK

Customization options

Build

Dependencies

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 8

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages