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 | 42 ++++++++++++++++++++++++++++++++++++++++++ README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 88 insertions(+) diff --git a/README b/README index f2df04e..73b7517 100644 --- a/README +++ b/README @@ -14,6 +14,48 @@ 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 + + Contact details --------------- The ptunnel-ng fork was done by Toni Uhlig: 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