|
1 |
| -# Ezcat 🐱💻 Easy netcat reverse shell handler</h1> |
2 |
| - |
| 1 | +# ezcat 🐱 easy shell handler |
| 2 | +ezcat allows you to manage multiple reverse shells |
| 3 | +with a simple web interface. |
3 | 4 |
|
4 |
| -Ezcat allows you to interact with mutliple netcat |
5 |
| -reverse shells and it lets you manage them easily |
6 |
| - |
7 |
| ---- |
8 |
| - |
9 |
| -### Features |
10 |
| -- HTTP/HTTPS beacon |
11 |
| -- Payload generation |
12 |
| -- Simple CLI interface |
13 |
| -- File upload & download |
14 |
| -- Upgradable netcat shells |
15 |
| - |
16 |
| ---- |
17 |
| - |
18 |
| -### Install |
19 |
| -#### Automated installation |
20 |
| -For an automated installation, you can use the install script: |
21 |
| -```bash |
22 |
| -curl https://raw.githubusercontent.com/ngn13/ezcat/main/scripts/install.sh | sudo bash |
| 5 | +# install |
| 6 | +### docker |
23 | 7 | ```
|
24 |
| -#### Manual installation |
25 |
| -Download the latest binary from the [releases tab](https://github.com/ngn13/ezcat/releases), |
26 |
| -then copy it to somewhere in your `PATH` |
27 |
| - |
28 |
| ---- |
29 |
| - |
30 |
| -### Build |
31 |
| -Install a recent version of go (I recommend `1.20`), then clone the repository and run the go build |
32 |
| -command: |
33 |
| -```bash |
34 |
| -go build . |
| 8 | +docker run --rm --network host \ |
| 9 | + -e PASSWORD=securepassword \ |
| 10 | + ghcr.io/ngn13/ezcat |
35 | 11 | ```
|
36 | 12 |
|
37 |
| ---- |
| 13 | +### other |
| 14 | +you can download the latest binary from the [releases tab](https://github.com/ngn13/ezcat/releases), |
| 15 | +then copy it to somewhere in your `PATH` |
38 | 16 |
|
39 |
| -### Use |
40 |
| -To run ezcat, simply run the command: |
41 |
| -``` |
42 |
| -ezcat |
43 |
| -``` |
44 |
| -this will start the HTTP beacon and put you in an interactive shell |
45 |
| -to list the commands, run `help`: |
| 17 | +# build |
| 18 | +install a recent version of go, then clone the repository and run the go build command: |
46 | 19 | ```bash
|
47 |
| -Command Description |
48 |
| -======= =========== |
49 |
| -help List all the commands |
50 |
| -list List all shells |
51 |
| -gen Generate a shell payload |
52 |
| -shell Hop on a shell |
53 |
| -upload Upload a file |
54 |
| -download Download a file |
55 |
| -exit Quit the program |
56 |
| -``` |
57 |
| -if you want to run the HTTP beacon on a different port/interface, use the `HTTP_ADDR` enviroment |
58 |
| -variable, for example: |
59 |
| -``` |
60 |
| -HTTP_ADDR=127.0.0.1:1234 ezcat |
61 |
| -``` |
62 |
| -#### HTTPS Beacon |
63 |
| -In order to run the beacon over HTTPS, you can setup nginx or a similar proxy service, |
64 |
| -here is an example nginx configuration: |
65 |
| -``` |
66 |
| -server { |
67 |
| - server_name mycooldomain.com; |
68 |
| -
|
69 |
| - location / { |
70 |
| - proxy_pass http://localhost:6001; |
71 |
| - proxy_http_version 1.1; |
72 |
| - proxy_set_header Upgrade $http_upgrade; |
73 |
| - proxy_set_header Connection 'upgrade'; |
74 |
| - proxy_set_header Host $host; |
75 |
| - proxy_cache_bypass $http_upgrade; |
76 |
| - } |
77 |
| -} |
| 20 | +go build . |
78 | 21 | ```
|
0 commit comments