relaxhuang/pssh-container repository overview

⁠pssh-container: Your Lightweight Remote Management & Network Troubleshooting Toolkit

This Docker image provides a pre-configured Linux environment, specifically designed for users who frequently perform batch operations and network diagnostics on remote systems. It integrates parallel-ssh (pssh) and parallel-scp (pscp), enabling efficient simultaneous management of multiple remote servers.

⁠Key Features

• parallel-ssh (pssh) & parallel-scp (pscp) Out-of-the-Box: No extra installation needed; instantly perform multi-host SSH connections and file transfers.
• Comprehensive Network Toolset: Includes curl, wget, nmap, telnet, dig, ip, traceroute, and more for quick network issue detection and resolution.
• Simplified SSH Connection Setup: The SSH client is pre-configured to automatically handle host key authentication, offering a smooth experience in development and testing environments (StrictHostKeyChecking=accept-new and LogLevel=ERROR).
• Lightweight & Efficient: Built on the latest Ubuntu image, ensuring a stable environment with low resource consumption.
• Built-in SSH Server: The container itself includes an SSH service, allowing easy external connections for operational tasks.

⁠Use Cases

• IT operations personnel executing remote commands and scripts in batches.
• Developers needing to quickly test connection statuses and service availability on multiple servers.
• Network engineers performing basic network troubleshooting and path tracing.
• Setting up temporary test environments that simulate multi-host collaborative work.

---

⁠Quick Start

1. Pull the Image:

   docker pull relaxhuang/pssh-container:latest
   

   Copy

2. Run the Container (mapping port 2222 for SSH and mounting a data volume):

   docker run -it --name my-pssh-tool -p 2222:22 -v ./data:/app/data relaxhuang/pssh-container:latest bash
   

   Copy

   or run on detached

   docker run -d --name my-pssh-tool -p 2222:22 -v ./data:/app/data relaxhuang/pssh-container:latest
   

   Copy
   • The -p 2222:22 flag maps your host's port 2222 to the container's SSH port 22.
   • The -v ./data:/app/data flag mounts your host's ./data directory to /app/data inside the container, allowing you to easily share files.

3. Log in to the Container and Start Using:

   ssh root@localhost -p 2222
   

   Copy

   (Password: changeMe@@ - Note: This password is for a test environment!)

   Once inside the container, you can directly use pssh, pscp, nmap, and other commands.

---

⁠Important Note

This image is designed to provide a quick-to-deploy, feature-rich environment for testing and development. Its default SSH root login configuration is only recommended for controlled test environments. For production use, you should disable root login and use SSH key-based authentication for enhanced security.