Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
English | 简体中文
tryssh is a command line SSH terminal tool with password guessing function.
It can use the SSH protocol to interactively log in to the server, or upload local files to the server or download remote files to the local location.
Of course, it can also manage the usernames, port numbers, passwords, and cached information of successfully logged-in servers for login attempts.
Attention! Do not use tryssh in a production environment!
- I prefer command-line tools and do not want to use graphical tools
- I have many servers with similar login information, but I don't want to input login details every time I log in
- I frequently use SSH terminal across multiple operating systems, but I haven't found a tool that allows me to maintain the same workflow across different OSes
- I haven't used tryssh before, but it looks good, and I want to give it a try
- Go 1.25 or later
makemake testmake lintmake coveragemake multi# Create an alternative user named "testuser"
tryssh create users testuser
# Create an alternative port number 22
tryssh create ports 22
# Create an alternative password (interactive prompt)
tryssh create passwords
# Attempt to log in to 192.168.1.1 using the information created above
tryssh ssh 192.168.1.1All usage help for the subcommands has been documented in the tryssh help information. You can view it by using the following command:
tryssh -h
# View the help documentation for the subcommand "ssh"
tryssh ssh -h$ tryssh -h command line ssh terminal tool. Usage: tryssh [command] Available Commands: alias Set, unset, and list aliases, aliases can be used to log in to servers create Create alternative username, port number, password, and login cache information delete Delete alternative username, port number, password, and login cache information encrypt Encrypt passwords in the configuration file get Get alternative username, port number, password, and login cache information help Help about any command prune Check if all current caches are available and clear the ones that are not available scp Upload/Download file to/from the server through SSH protocol ssh Connect to the server through SSH protocol version Print the client version information for the current context Flags: -h, --help help for tryssh Use "tryssh [command] --help" for more information about a command.
The "create" command of tryssh is used to create various configurations for password guessing login, such as usernames, port numbers, and passwords. It can also directly create caches with known usernames, port numbers, and passwords.
$ tryssh create -h Create alternative username, port number, password, and login cache information Usage: tryssh create [command] Available Commands: caches Create an alternative cache keys Create a alternative key file path passwords Create an alternative password ports Create an alternative port users Create an alternative username Flags: -h, --help help for create Use "tryssh create [command] --help" for more information about a command.
# Create an alternative user named testuser tryssh create users testuser # Create an alternative port: 22 tryssh create ports 22 # Create an alternative password (interactive prompt) tryssh create passwords
The "delete" command of tryssh is used to delete various configurations for password guessing login, such as usernames, port numbers, and passwords. It can also directly delete caches.
$ tryssh delete -h Delete alternative username, port number, password, and login cache information Usage: tryssh delete [command] Available Commands: caches Delete an alternative cache keys Delete a alternative key file path passwords Delete an alternative password ports Delete an alternative port users Delete an alternative username Flags: -h, --help help for delete Use "tryssh delete [command] --help" for more information about a command.
# Delete an alternative user named testuser tryssh delete users testuser # Delete an alternative port: 22 tryssh delete ports 22 # Delete an alternative passwords: 123456 tryssh delete passwords 123456 # Delete the cache information about 192.168.1.1 tryssh delete caches 192.168.1.1
The "get" command of tryssh is used to view various configurations for password guessing login, such as usernames, port numbers, passwords, and login caches.
$ tryssh get -h Get alternative username, port number, password, and login cache information Usage: tryssh get [command] Available Commands: caches Get alternative caches by ipAddress passwords Get alternative passwords ports Get alternative ports users Get alternative usernames Flags: -h, --help help for get Use "tryssh get [command] --help" for more information about a command.
# View candidate users for password guessing tryssh get users # View candidate ports for password guessing tryssh get ports # View the currently existing login caches tryssh get caches
The "prune" command of tryssh is used to test whether the existing caches are still usable. If they are not, you can choose to delete the cache, or directly delete it without confirmation.
$ tryssh prune -h Check if all current caches are available and clear the ones that are not available Usage: tryssh prune [flags] Flags: -a, --auto Automatically perform concurrent cache optimization without asking for confirmation to delete -c, --concurrency int Number of multiple requests to perform at a time (default 8) -h, --help help for prune -t, --timeout duration SSH timeout when attempting to log in. It can be "1s" or "1m" or other duration (default 2s)
# Interactively conduct cache availability testing tryssh prune # Conduct non-interactive cache availability testing tryssh prune -a # Conduct non-interactive cache availability testing, while setting the concurrency to 10 (default is 8) and the connection timeout to 5 seconds (default is 2 seconds). tryssh prune -c 10 -t 5s -a
The setting for concurrency is invalid in interactive mode.
The "alias" command of tryssh is used to assign aliases to existing caches, making it convenient to use these aliases directly for login or file transfer operations.
$ tryssh alias -h Set, unset, and list aliases, aliases can be used to log in to servers Usage: tryssh alias [command] Available Commands: list List all alias set Set an alias for the specified server address unset Unset the alias Flags: -h, --help help for alias Use "tryssh alias [command] --help" for more information about a command.
# View all current aliases tryssh alias list # Set an alias named 'host1' for the server with the IP address 192.168.1.1 tryssh alias set host1 -t 192.168.1.1 # Remove the alias named 'host1' tryssh alias unset host1
The "ssh" command of tryssh is used for password guessing login to a server. Upon successfully obtaining the correct login information, it will cache these details for direct login in future attempts, without the need to guess the password again.
chenjingyu@MacBook ~ % tryssh ssh -h
Connect to the server through SSH protocol
Usage:
tryssh ssh <ipAddress> [flags]
Flags:
-c, --concurrency int Number of multiple requests to perform at a time (default 8)
-h, --help help for ssh
-t, --timeout duration SSH timeout when attempting to log in. It can be "1s" or "1m" or other duration (default 1s)
-u, --user string Specify a username to attempt to login to the server,
if the specified username does not exist, try logging in using that username
# Login to the server at 192.168.1.1. If there is no cache available, attempt to guess the password for login tryssh ssh 192.168.1.1 # Login to the server with the alias 'host1' tryssh ssh host1 # Login to the server at 192.168.1.1. If there is no cache available, attempt to guess the password for login. Set the concurrency to 20, timeout to 500 milliseconds, and specify the user as 'root'. tryssh ssh 192.168.1.1 -c 20 -t 500ms -u root
The "scp" command of tryssh is used to upload or download files or directories. The scp command supports the use of aliases.
chenjingyu@MacBook ~ % tryssh scp -h
Upload/Download file to/from the server through SSH protocol
Usage:
tryssh scp <source> <destination> [flags]
Examples:
# Download test.txt file from 192.168.1.1 and place it under ./
tryssh scp 192.168.1.1:/root/test.txt ./
# Upload test.txt file to 192.168.1.1 and place it under /root/
tryssh scp ./test.txt 192.168.1.1:/root/
# Download test.txt file from 192.168.1.1 and rename it to test2.txt and place it under ./
tryssh scp 192.168.1.1:/root/test.txt ./test2.txt
# Download testDir directory from 192.168.1.1 and place it under ~/Downloads/
tryssh scp -r 192.168.1.1:/root/testDir ~/Downloads/
# Upload testDir directory to 192.168.1.1 and rename it to testDir2 and place it under /root/
tryssh scp -r ~/Downloads/testDir 192.168.1.1:/root/testDir2
Flags:
-c, --concurrency int Number of multiple requests to perform at a time (default 8)
-h, --help help for scp
-r, --recursive Recursively copy entire directories
-t, --timeout duration SSH timeout when attempting to log in. It can be "1s" or "1m" or other duration (default 1s)
-u, --user string Specify a username to attempt to login to the server,
if the specified username does not exist, try logging in using that username
Same as the information in the help section.
# Download test.txt file from 192.168.1.1 and place it under ./ tryssh scp 192.168.1.1:/root/test.txt ./ # Upload test.txt file to 192.168.1.1 and place it under /root/ tryssh scp ./test.txt 192.168.1.1:/root/ # Download test.txt file from 192.168.1.1 and rename it to test2.txt and place it under ./ tryssh scp 192.168.1.1:/root/test.txt ./test2.txt # Download testDir directory from 192.168.1.1 and place it under ~/Downloads/ tryssh scp -r 192.168.1.1:/root/testDir ~/Downloads/ # Upload testDir directory to 192.168.1.1 and rename it to testDir2 and place it under /root/ tryssh scp -r ~/Downloads/testDir 192.168.1.1:/root/testDir2 # Upload all .txt files to 192.168.1.1:/root/ (wildcard support) tryssh scp ./*.txt 192.168.1.1:/root/ # Download all .log files from remote (wildcard support) tryssh scp 192.168.1.1:/var/log/*.log ./
- Interactive password input: Passwords are entered via interactive terminal prompts (never exposed in shell history)
- Sensitive info masking: Passwords and keys are masked in get output and logs
- Config encryption: Use tryssh encrypt to encrypt stored passwords with a master password (AES-GCM). Alternatively, set the TRYSSH_MASTER_KEY environment variable for non-interactive encryption
- File permissions: Config files and directories use restrictive permissions (0600/0700)
The "encrypt" command encrypts all plaintext passwords stored in the configuration file using a master password. Once encrypted, passwords are automatically decrypted when needed.
# Interactively encrypt all passwords (prompts for master password twice) tryssh encrypt # Encrypt using an environment variable (no interactive prompt) TRYSSH_MASTER_KEY=mypassword tryssh encrypt
Warning: If you forget your master password, encrypted passwords cannot be recovered.