2021-03-09 00:56:25 +01:00
|
|
|
# rcon-cli
|
2021-03-08 16:57:30 +01:00
|
|
|
A little RCON cli written in golang.
|
2017-04-05 22:37:32 +02:00
|
|
|
|
2021-03-08 16:57:30 +01:00
|
|
|
This is a fork from [itzg/rcon-cli](https://github.com/itzg/rcon-cli) with following extra features:
|
|
|
|
- Provied a smaller binary (ca. 50% smaller).
|
|
|
|
- Replace base RCON lib from [james4k/rcon](https://github.com/james4k/rcon) with [hamburghammer/rcon](https://github.com/hamburghammer/rcon).
|
|
|
|
- Remove `config.yml` support.
|
|
|
|
- Change the `Dockerfile` to have build support.
|
2017-04-05 22:37:32 +02:00
|
|
|
|
2023-07-28 14:52:31 +02:00
|
|
|
Note: *This tool is primarily being maintained to support minecraft RCON implementation.*
|
|
|
|
|
2021-03-08 16:57:30 +01:00
|
|
|
## Installation
|
|
|
|
### From Source
|
|
|
|
Clone the repository and install it with `go install` (requires working `go` installation)
|
2017-04-05 22:37:32 +02:00
|
|
|
|
2021-03-08 16:57:30 +01:00
|
|
|
### Docker/Podman
|
|
|
|
Clone the repository and use docker/podman to build a image with the executable `docker build -t hamburghammer/rcon-cli .`
|
|
|
|
Start the image `docker run hamburghammer/rcon-cli -h`
|
2017-04-05 22:37:32 +02:00
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2017-04-09 15:18:37 +02:00
|
|
|
```text
|
2021-03-08 16:57:30 +01:00
|
|
|
rcon-cli is a CLI to interact with a RCON server.
|
|
|
|
It can be run in an interactive mode or to execute a single command.
|
|
|
|
|
|
|
|
USAGE:
|
|
|
|
rcon-cli [FLAGS] [RCON command ...]
|
|
|
|
|
|
|
|
FLAGS:
|
|
|
|
-h, --help Prints this help message and exits.
|
|
|
|
--host string RCON server's hostname. (default "localhost")
|
|
|
|
--password string RCON server's password.
|
|
|
|
--port string RCON server's port. (default "25575")
|
|
|
|
|
|
|
|
ENVIRONMENT VARIABLE:
|
|
|
|
All flags can be set through the flag name in capslock with the RCON_CLI_ prefix (see examples).
|
|
|
|
Flags have allways priority over env vars!
|
|
|
|
|
|
|
|
EXAMPLES:
|
|
|
|
rcon-cli --host 127.0.0.1 --port 25575
|
|
|
|
rcon-cli --password admin123 stop
|
|
|
|
RCON_CLI_PORT=25575 rcon-cli stop
|
2019-05-27 14:40:45 +02:00
|
|
|
```
|
2023-07-28 14:48:09 +02:00
|
|
|
|
|
|
|
## LICENSE
|
|
|
|
|
|
|
|
The software is licensed under the [Apache-2.0](LICENSE) license.
|