https://github.com/leblanc-simon/open-go-knocking
Simple port knocking client written in GoLang
https://github.com/leblanc-simon/open-go-knocking
golang knock knocking network port-knock port-knocking
Last synced: 2 months ago
JSON representation
Simple port knocking client written in GoLang
- Host: GitHub
- URL: https://github.com/leblanc-simon/open-go-knocking
- Owner: leblanc-simon
- License: wtfpl
- Created: 2023-05-25T22:43:24.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-26T20:25:13.000Z (almost 2 years ago)
- Last Synced: 2025-01-10T01:51:42.714Z (4 months ago)
- Topics: golang, knock, knocking, network, port-knock, port-knocking
- Language: Go
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# OpenGoKnocking
Simple and cross-platform port knocking client written in GoLang.
## Installation
To install OpenGoKnocking in your $GOPATH:
```bash
git clone https://github.com/leblanc-simon/open-go-knocking.git
cd open-go-knocking
go install
```
alternatively, you can download binary from [releases](https://github.com/leblanc-simon/open-go-knocking/releases).
Binaries are availables for GNU/Linux, MacOS and Windows
## Usage
```bash
# 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
## License
[WTFPL](http://www.wtfpl.net/)
## Logo
Original Logo from [Takuya Ueda](https://twitter.com/tenntenn), you can find source [in the repository](https://github.com/golang-samples/gopher-vector). Licensed under the Creative Commons 3.0 Attributions license.
Modified by Simon Leblanc.