recmd is a simple utility that can be used to execute command on a remote host.
cargo build --releaseFor building using Docker or for static builds, see here
On the remote host where the command must be executed run recmd in server mode:
remcd srv -p 22000If you prefer to run the server in background, you can enable the daemon mode by
using the option -d:
remcd srv -p 22000 -dwith the commands above recmd will listen on port 22000 (TCP) for incoming
command requests.
For sending a command request, run recmd in send mode (change 1.2.3.4 with
the IP address of the host where the server is running):
recmd snd -a 1.2.3.4 -p 22000 -c "bash -c 'ls /etc > /tmp/out'"
recmd snd -a 1.2.3.4 -p 22000 -c "bash -c 'cat /tmp/out'"Communications between the client and the server are encrypted and authenticated
with ChaCha20-Poly1305. recmd uses a static password (used to derive the 256
bits ChaCha20 key) defined in src/config.rs with the variable
PASSWORD_DEF.
const PASSWORD_DEF: &str = "1e$tob5UtRi6oFr8jlYO";Be sure to change the value of this variable with your own password before
building your own recmd executable.
Alternatively, it is possible to set on-demand the password used for deriving
the cryptographic key by setting the RECMDK environment variable. For using
this methodology, run the server with (in this example the password is set to
"mypasswd"):
RECMDK='mypasswd' remcd srv -p 22000 -dand then use recmd in client mode like this (change 1.2.3.4 with
the IP address of the host where the server is running):
RECMDK='mypasswd' recmd snd -a 1.2.3.4 -p 22000 -c "bash -c 'ls /etc > /tmp/out'"Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.