remote-hosts 0.1.0

A lightweight SSH remote host management tool for managing and connecting to remote hosts.

Remote Hosts

A lightweight and efficient SSH remote host management tool that makes your remote connections simpler and more convenient
English | 中文

📦 Installation

Install from PyPI (recommended)

pip install remote-hosts

Install from source

# Clone the repository
git clone https://github.com/hollson/remote-hosts.git
cd remote-hosts

# Install
pip install -e .

🎯 Usage Examples

• Display help information

$ remote_hosts -h
==============================================
        SSH Remote Host Management Tool        
==============================================

usage: remote_hosts [-h] [-v] [-e [editor]]

options:
  -l, --list      View host list
  -e [editor]     Edit configuration file
  -m, --manual    View operation guide
  -v, --version   Display version information
  -h, --help      Display help information

• Login to remote host

$ remote_hosts
┌──────────┬────────────────┬──────────┬───────────────┬──────────┬───────────┬───────────┐
│    ID    │      Host      │   User   │     System    │   Arch   │   Region  │   Mark    │
├──────────┼────────────────┼──────────┼───────────────┼──────────┼───────────┼───────────┤
│1         │example.com    │root      │ubuntu22.04    │x86_64    │newyork    │example    │
│2         │172.16.1.10     │root      │-              │-         │-          │example    │
└──────────┴────────────────┴──────────┴───────────────┴──────────┴───────────┴───────────┘
Please enter host ID (q to exit): 1
Connecting to [e-mail]:22...

• Edit configuration file

$ remote_hosts -e
Please select text editor:
  1. default    System default text editor
  2. vi         Vi editor
  3. vim        Vim editor
  4. nano       Nano editor
  5. code       Visual Studio Code
Please enter option number: 

⚙️ Configuration Example

The configuration file is located at ~/.ssh/term_hosts.json in JSON format. A sample configuration file will be automatically created when running for the first time.

[
	{
		"id": 1,
		"host": "example.com",
		"port": 22,
		"user": "root",
		"key": "~/.ssh/id_rsa",
		"os": "ubuntu22.04",
		"arch": "x86_64",
		"region": "newyork",
		"mark": "example"
	},
	{
		"id": 2,
		"host": "172.16.1.10",
		"user": "root",
		"mark": "example"
	}
]

📄 License

This project is licensed under the MIT License - see the LICENSE file for details