https://github.com/sepppenner/portknocker
PortKnocker is a project to run a simple port knocking client for UDP and TCP connections.
https://github.com/sepppenner/portknocker
Last synced: about 1 year ago
JSON representation
PortKnocker is a project to run a simple port knocking client for UDP and TCP connections.
- Host: GitHub
- URL: https://github.com/sepppenner/portknocker
- Owner: SeppPenner
- License: mit
- Created: 2020-02-25T19:56:08.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-09T14:55:43.000Z (over 1 year ago)
- Last Synced: 2025-04-02T00:24:39.628Z (about 1 year ago)
- Language: C#
- Homepage:
- Size: 33.2 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: License.txt
Awesome Lists containing this project
README
PortKnocker
====================================
PortKnocker is a project to run a simple [port knocking](https://en.wikipedia.org/wiki/Port_knocking) client for UDP and TCP connections.
[](https://ci.appveyor.com/project/SeppPenner/portknocker)
[](https://github.com/SeppPenner/PortKnocker/issues)
[](https://github.com/SeppPenner/PortKnocker/network)
[](https://github.com/SeppPenner/PortKnocker/stargazers)
[](https://raw.githubusercontent.com/SeppPenner/PortKnocker/master/License.txt)
[](https://snyk.io/test/github/SeppPenner/PortKnocker)
[](https://franzhuber23.blogspot.de/)
[](https://patreon.com/SeppPennerOpenSourceDevelopment)
[](https://paypal.me/th070795)
## Basic usage
```cmd
PortKnocker -i 192.168.0.1 -u 23 Knocks with UDP on 192.168.0.1:23.
PortKnocker -i 192.168.0.1 -u 25 -u 26 Knocks with UDP on 192.168.0.1:25 and 192.168.0.1:26.
PortKnocker -i 192.168.0.1 -u 38 -p test Knocks with UDP on 192.168.0.1:38 and sends the string 'test'.
PortKnocker -i 192.168.0.1 -u 40 -b 0103 Knocks with UDP on 192.168.0.1:40 and sends the hexadecimal value '0x01 0x03'.
PortKnocker -i 192.168.0.1 -i 192.168.0.2 -u 23 Knocks with UDP on 192.168.0.1:23 and 192.168.0.2:23.
PortKnocker -i 192.168.0.1 -t 24 Knocks with TCP on 192.168.0.1:24.
PortKnocker -i 192.168.0.1 -t 32 -t 17 Knocks with TCP on 192.168.0.1:32 and 192.168.0.1:17.
PortKnocker -i 192.168.0.1 -t 11 -p test Knocks with TCP on 192.168.0.1:11 and sends the string 'test'.
PortKnocker -i 192.168.0.1 -t 42 -b 0103 Knocks with TCP on 192.168.0.1:42 and sends the hexadecimal value '0x01 0x03'.
PortKnocker -i 192.168.0.1 -i 192.168.0.2 -t 25 Knocks with TCP on 192.168.0.1:25 and 192.168.0.2:25.
```
Checkout the examples in the [PortKnockerTest](https://github.com/SeppPenner/PortKnocker/tree/master/PortKnockerTest) project as well.
## Hints
The `-b` option will overwrite the `-p` option if both are specified.
## Commands
```html
PortKnocker Commands manual PortKnocker
NAME
PortKnocker — I'm the one who knocks.
SYNOPSIS
PortKnocker { -i ipAddress { -u udpPort [-p packet | -b binary] | -t tcpPort [-p packet | -b binary]
| -u udpPort -t tcpPort [-p packet | -b binary] } | -h }
DESCRIPTION
PortKnocker is a program to run a simple port knocking client for UDP and TCP connections.
The options are as follows:
-i || -ip Specifies the IP address(es) to knock on.
-u || -udp Specifies the UDP port(s).
-t || -tcp Specifies the TCP port(s).
-p || -packet Specifies the packet.
-b || -binary Specifies the packet (in binary form).
-h || -help Shows the help.
DEFAULT VALUES
Packet 0x00 0x01
SEE ALSO
Port knocking, https://en.wikipedia.org/wiki/Port_knocking.
AUTHORS
PortKnocker is a free software provided under the MIT license. It is written by SeppPenner.
Haemmer Electronics Feb 26, 2020 Haemmer Electronics
```
## Further links
* https://github.com/sebastienwarin/Knock
* https://en.wikipedia.org/wiki/Port_knocking
* https://github.com/xamarin/XamarinComponents/tree/master/XPlat/Mono.Options
Change history
--------------
See the [Changelog](https://github.com/SeppPenner/PortKnocker/blob/master/Changelog.md).