Skip to content

Commit 7f7fd31

Browse files
committed
full rewrite
rebase
1 parent 25919d0 commit 7f7fd31

40 files changed

+1708
-1060
lines changed

.github/workflows/publish.yml

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
name: Publish Docker Image
2+
on: [push]
3+
jobs:
4+
publish-docker:
5+
runs-on: ubuntu-latest
6+
defaults:
7+
steps:
8+
- name: 'Checkout GitHub Action'
9+
uses: actions/checkout@main
10+
11+
- name: 'Login to GitHub Container Registry'
12+
uses: docker/login-action@v1
13+
with:
14+
registry: ghcr.io
15+
username: ${{github.actor}}
16+
password: ${{secrets.GITHUB_TOKEN}}
17+
18+
- name: 'Build Inventory Image'
19+
run: |
20+
docker build . --tag ghcr.io/ngn13/ezcat:latest
21+
docker push ghcr.io/ngn13/ezcat:latest

Dockerfile

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
FROM golang:1.21.6
2+
3+
WORKDIR /app
4+
5+
COPY *.go ./
6+
COPY *.mod ./
7+
COPY *.sum ./
8+
COPY log ./log
9+
COPY routes ./routes
10+
COPY shell ./shell
11+
COPY static ./static
12+
COPY util ./util
13+
COPY views ./views
14+
15+
EXPOSE 5566
16+
RUN go build .
17+
18+
ARG PASSWORD
19+
ENV PASSWORD $PASSWORD
20+
21+
ENTRYPOINT ["/app/ezcat"]

LICENSE.txt

+622-288
Large diffs are not rendered by default.

README.md

+14-71
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,21 @@
1-
# Ezcat 🐱‍💻 Easy netcat reverse shell handler</h1>
2-
![](images/showcase.png)
1+
# ezcat 🐱 easy shell handler
2+
ezcat allows you to manage multiple reverse shells
3+
with a simple web interface.
34

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
237
```
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
3511
```
3612

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`
3816

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:
4619
```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 .
7821
```

bridge/shell.go

-36
This file was deleted.

bridge/util.go

-11
This file was deleted.

cmds/download.go

-54
This file was deleted.

cmds/gen.go

-22
This file was deleted.

cmds/help.go

-26
This file was deleted.

cmds/list.go

-38
This file was deleted.

cmds/main.go

-47
This file was deleted.

0 commit comments

Comments
 (0)