Skip to content

Commit

Permalink
full rewrite
Browse files Browse the repository at this point in the history
rebase
  • Loading branch information
ngn13 committed Jan 20, 2024
1 parent 25919d0 commit 7f7fd31
Show file tree
Hide file tree
Showing 40 changed files with 1,708 additions and 1,060 deletions.
21 changes: 21 additions & 0 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
name: Publish Docker Image
on: [push]
jobs:
publish-docker:
runs-on: ubuntu-latest
defaults:
steps:
- name: 'Checkout GitHub Action'
uses: actions/checkout@main

- name: 'Login to GitHub Container Registry'
uses: docker/login-action@v1
with:
registry: ghcr.io
username: ${{github.actor}}
password: ${{secrets.GITHUB_TOKEN}}

- name: 'Build Inventory Image'
run: |
docker build . --tag ghcr.io/ngn13/ezcat:latest
docker push ghcr.io/ngn13/ezcat:latest
21 changes: 21 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
FROM golang:1.21.6

WORKDIR /app

COPY *.go ./
COPY *.mod ./
COPY *.sum ./
COPY log ./log
COPY routes ./routes
COPY shell ./shell
COPY static ./static
COPY util ./util
COPY views ./views

EXPOSE 5566
RUN go build .

ARG PASSWORD
ENV PASSWORD $PASSWORD

ENTRYPOINT ["/app/ezcat"]
910 changes: 622 additions & 288 deletions LICENSE.txt

Large diffs are not rendered by default.

85 changes: 14 additions & 71 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,78 +1,21 @@
# Ezcat 🐱‍💻 Easy netcat reverse shell handler</h1>
![](images/showcase.png)
# ezcat 🐱 easy shell handler
ezcat allows you to manage multiple reverse shells
with a simple web interface.

Ezcat allows you to interact with mutliple netcat
reverse shells and it lets you manage them easily

---

### Features
- HTTP/HTTPS beacon
- Payload generation
- Simple CLI interface
- File upload & download
- Upgradable netcat shells

---

### Install
#### Automated installation
For an automated installation, you can use the install script:
```bash
curl https://raw.githubusercontent.com/ngn13/ezcat/main/scripts/install.sh | sudo bash
# install
### docker
```
#### Manual installation
Download the latest binary from the [releases tab](https://github.com/ngn13/ezcat/releases),
then copy it to somewhere in your `PATH`

---

### Build
Install a recent version of go (I recommend `1.20`), then clone the repository and run the go build
command:
```bash
go build .
docker run --rm --network host \
-e PASSWORD=securepassword \
ghcr.io/ngn13/ezcat
```

---
### other
you can download the latest binary from the [releases tab](https://github.com/ngn13/ezcat/releases),
then copy it to somewhere in your `PATH`

### Use
To run ezcat, simply run the command:
```
ezcat
```
this will start the HTTP beacon and put you in an interactive shell
to list the commands, run `help`:
# build
install a recent version of go, then clone the repository and run the go build command:
```bash
Command Description
======= ===========
help List all the commands
list List all shells
gen Generate a shell payload
shell Hop on a shell
upload Upload a file
download Download a file
exit Quit the program
```
if you want to run the HTTP beacon on a different port/interface, use the `HTTP_ADDR` enviroment
variable, for example:
```
HTTP_ADDR=127.0.0.1:1234 ezcat
```
#### HTTPS Beacon
In order to run the beacon over HTTPS, you can setup nginx or a similar proxy service,
here is an example nginx configuration:
```
server {
server_name mycooldomain.com;
location / {
proxy_pass http://localhost:6001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
go build .
```
36 changes: 0 additions & 36 deletions bridge/shell.go

This file was deleted.

11 changes: 0 additions & 11 deletions bridge/util.go

This file was deleted.

54 changes: 0 additions & 54 deletions cmds/download.go

This file was deleted.

22 changes: 0 additions & 22 deletions cmds/gen.go

This file was deleted.

26 changes: 0 additions & 26 deletions cmds/help.go

This file was deleted.

38 changes: 0 additions & 38 deletions cmds/list.go

This file was deleted.

47 changes: 0 additions & 47 deletions cmds/main.go

This file was deleted.

Loading

0 comments on commit 7f7fd31

Please sign in to comment.