aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorToni Uhlig <matzeton@googlemail.com>2020-04-05 19:26:01 +0200
committerToni Uhlig <matzeton@googlemail.com>2020-04-05 19:30:31 +0200
commit3d8dc5110c72fa7377e10638b8e4be783a863cc6 (patch)
tree9cdacf5fed4fe94a23c4d7f4f54e871c95968554
parentbe1ec607c72810814edc86734c48984f5b7aa6c3 (diff)
README's provide some simple ptunnel-ng usage examples (fixes #21)
Signed-off-by: Toni Uhlig <matzeton@googlemail.com>
-rw-r--r--README42
-rw-r--r--README.md46
2 files changed, 88 insertions, 0 deletions
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