OpenGoKnocking

Simple and cross-platform port knocking client written in GoLang.

Installation

To install OpenGoKnocking in your $GOPATH:

git clone https://github.com/leblanc-simon/open-go-knocking.git
cd open-go-knocking
go install

alternatively, you can download binary from releases. Binaries are availables for GNU/Linux, MacOS and Windows

Usage

# Knock to the server 192.168.0.42 at port 1337 (tcp), then 1338 (UDP) and finally 1339 (TCP)
open-go-knocking 192.168.0.42 1337:tcp 1338:udp 1339:tcp

# If the majority of ports are TCP ports, you can use the following syntax (ports without protocol will be in TCP)
open-go-knocking --tcp 192.168.0.42 1337 1338:udp 1339

# If the majority of ports are UDP ports, you can use the following syntax (ports without protocol will be in UDP)
open-go-knocking --udp 192.168.0.42 1337 1338:tcp 1339

# If you use domain name, you can increase the timeout to take account of resolution time
open-go-knocking --timeout 100 example.com 1337:tcp 1338:udp 1339:tcp

Options

• --tcp: use TCP protocol by default
• --udp: use UPD protocol by default
• --delay (in ms / default 1): delay in milliseconds between 2 packets send to host
• --timeout (in ms / default 5): timeout in milliseconds before autoclose connection
• --version: Show the current version
• --help: Show the help

Errors

Possible exit codes :

• 0: all is fine :)
• 1: Not enough arguments (host and port are required)
• 2: Host is not a valid hostname or IP (v4 or v6)
• 3: Problems with ports or protocols (check if you use --tcp or --udp that the option is located before the host)

Author

• Simon Leblanc [email protected]

License

WTFPL

Logo

Original Logo from Takuya Ueda, you can find source in the repository. Licensed under the Creative Commons 3.0 Attributions license.

Modified by Simon Leblanc.