From 3d8dc5110c72fa7377e10638b8e4be783a863cc6 Mon Sep 17 00:00:00 2001 From: Toni Uhlig Date: Sun, 5 Apr 2020 19:26:01 +0200 Subject: README's provide some simple ptunnel-ng usage examples (fixes #21) Signed-off-by: Toni Uhlig --- README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 57eb353..4627364 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,52 @@ to a remote host using ICMP echo request and reply packets, commonly known as ping requests and replies. ``` +## Simple usage +Opens a SSH over ICMP tunnel to a remote. + +Server: + +`sudo ptunnel-ng` + +Client: + +`sudo ptunnel-ng -p[Server-IP/NAME] -l2222` + +`ssh -p2222 -luser 127.0.0.1` + +## Restricted usage +Opens a SSH over ICMP tunnel to a remote but restricts destination IP/Port for tunnel clients. +10.0.3.1 is the machine your SSH daemon listens on. This can be a virtual machine, container or (.\*). + +Server: + +`sudo ptunnel-ng -r10.0.3.1 -R22` + +Client: + +`sudo ptunnel-ng -p[Server-IP/NAME] -l2222 -r10.0.3.1 -R22` + +`ssh -p2222 -luser 127.0.0.1` + +## Reverse shell usage +Opens a SSH over ICMP tunnel to a remote and creates a reverse tunnel on same +but restricts destination IP/Port for tunnel clients. +10.0.3.1 is the machine your SSH daemon listens on. This can be a virtual machine, container or (.\*). + +Server: + +`sudo ptunnel-ng -r10.0.3.1 -R22` + +Client: + +`sudo ./src/ptunnel-ng -p[Server-IP/NAME] -l2222 -r10.0.3.1 -R22` + +`ssh -R 127.0.0.1:22222 127.0.0.1 -p2222` + +Server: + +`ssh -p22222 -luser 127.0.0.1` + ## How does it work? ``` ICMP Packet structure -- cgit v1.2.3