-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
rebase
- Loading branch information
Showing
40 changed files
with
1,708 additions
and
1,060 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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"] |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 . | ||
``` |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.