#dnscat2 #client #lang #language

app dnscat-client

Standalone DNSCAT2 client

2 releases

0.1.1 Mar 30, 2020
0.1.0 Mar 30, 2020

#1123 in #lang

MIT license

4.5K SLoC

Build Status Crate Docs


Rust implementation of the DNSCAT2 protocol
Documentation hosted on docs.rs.

dnscat = "0.1"

Client CLI Usage

First install the standalone dnscat client with:

cargo install dnscat-client
$ dnscat-client -h
dnscat-client 0.1
avitex <avitex@wfxlabs.com>
DNSCAT client

    dnscat-client [FLAGS] [OPTIONS] <domain>

    <domain>    DNS endpoint name

        --command               If set, indicate to the server this is a command session
    -h, --help                  Prints help information
        --insecure              If set, will turn off encryption/authentication
        --packet-trace          If set, display incoming/outgoing DNSCAT2 packets
        --prefer-server-name    If set, prefer the server's session name
        --random-delay          If set, will select a random delay for each transmit between <min-delay> and <max-delay>
        --retransmit-backoff    If set, will exponentially backoff in delay from re-attempting a transmit
        --retransmit-forever    If set, will re-transmit forever until a server sends a valid response
    -V, --version               Prints version information

    -e, --exec <exec>...                       Execute a process and attach stdin/stdout
        --max-delay <max-delay>                Set the maximum delay in milliseconds between packets [default: 1000]
        --max-retransmits <max-retransmits>    Set the max re-transmits attempted before assuming the server is dead and
                                               aborting [default: 20]
        --min-delay <min-delay>                Set the minimum delay in milliseconds between packets [default: 0]
        --query <query>...                     Set the query types for DNS requests (comma-delimited) [default: TXT MX
                                               A]  [possible values: TXT, MX, CNAME, A, AAAA]
        --recv-queue-size <recv-queue-size>    Set the receive chunk buffer size [default: 16]
        --secret <secret>                      Set the shared secret used for encryption
        --server <server>                      Set the DNS server address, which by default is auto-detected
        --session-id <session-id>              Set the session ID manually
        --session-name <session-name>          Set the session name manually

Start the client with the DNSCAT2 stream attached to netcat:

dnscat-client example.com. --server \
  --insecure --session-name my-session --exec nc -l 8081


~276K SLoC