westnetdocker/peplink-cli-tools-x86 repository overview

⁠CLI Tools for x86 Peplink Edge Compute Devices (Alpine-Based)

⁠Overview

This Docker image provides a lightweight Alpine Linux environment with a suite of command-line network tools and Speedtest CLI, optimized for x86-based Peplink Edge Compute Devices. It includes utilities like iperf3, nmap, tcpdump, speedtest, and more, accessible via SSH.

⁠Default Login Information

• Username: peplink
• Password: peplink

⁠How to Run the Docker Container

1. Access the Web Admin Interface:

   • Open the Web Admin or Remote Web Admin interface for your Peplink router.
   • Navigate to the Advanced tab.

2. Install the Docker Image:

   • Click on Docker.
   • Click Here to Pull Image.
   • Type in westnetdocker/peplink-cli-tools-x86.
   • Click OK and wait for the image to be installed.

3. Run the Docker Container:

   • Click the Plus Sign (+) to add a new container.
   • Use one of the following Docker commands:
     • Without a custom password:

       docker run --name nameofcontainer -p 22:22 westnetdocker/peplink-cli-tools-x86
       

       Copy
     • With a custom password:

       docker run --name nameofcontainer -p 22:22 -e PASSWORD=yourcustompassword westnetdocker/peplink-cli-tools-x86
       

       Copy
     • Replace nameofcontainer with a desired name for your container.
     • If you do not specify a custom password, the default credentials (peplink / peplink) will be used.
     • Note: Special characters (e.g., &, !, #) in custom passwords are not supported on InTouch.
     • Port 22 is exposed for SSH access.
     • Use --ip x.x.x.x to set a custom IP address.
     • Use --network vlan10 to put the container on VLAN 10.

4. Grab the IP Address:

   • Note the IP address assigned to the container.

⁠Connecting to CLI Tools

1. Access via SSH:

   • Use an SSH client (e.g., PuTTY or terminal) to connect:
     • IP Address: The container’s IP address
     • Username: peplink
     • Password: The default (peplink) or your custom password
     • Port: 22
   • Once connected, you can use the CLI tools directly in the terminal.

2. Access via InTouch:

   • Use an InTouch to connect:
     • IP Address: The container’s IP address
     • Username: peplink
     • Password: The default (peplink) or your custom password
     • Port: 22
   • Once connected, you can use the CLI tools directly from Intouch.

⁠Features

• Lightweight Base: Built on Alpine Linux for minimal resource usage.
• Network Tools: Pre-installed tools include speedtest, iperf3, nmap, tcpdump, hping3, ntpsec, net-snmp-tools, nuttcp, and more.
• SSH Access: Securely enabled for remote CLI access.
• Customizable Password: Set via the PASSWORD environment variable during container creation, with support for special characters.