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
1,323 downloads per month
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
- 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.
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