3 releases (breaking)

0.3.0 Mar 11, 2023
0.2.0 Mar 1, 2023
0.1.0 Feb 25, 2023

#102 in #run-command

Download history 8/week @ 2024-09-21 6/week @ 2024-09-28

1,323 downloads per month

MIT/Apache

57KB
1.5K SLoC

REmote CoMmanD Executor

recmd is a simple utility that can be used to execute command on a remote host.

Build

cargo build --release

For building using Docker or for static builds, see here

Usage

On the remote host where the command must be executed run recmd in server mode:

remcd srv -p 22000

If you prefer to run the server in background, you can enable the daemon mode by using the option -d:

remcd srv -p 22000 -d

with 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'"

Encryption Key

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 -d

and 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'"

License

Licensed under either of

at your option.

Contribution

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.

Dependencies

~2.4–3.5MB
~66K SLoC