https://github.com/alexrf45/aegis

Repeatable, immutable, and scalable security research w/ Docker
https://github.com/alexrf45/aegis

bug-bounty docker kali-linux penetration-testing red-team zsh

Last synced: 3 months ago
JSON representation

Repeatable, immutable, and scalable security research w/ Docker

• Host: GitHub
• URL: https://github.com/alexrf45/aegis
• Owner: alexrf45
• Created: 2022-12-04T18:32:45.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-23T01:40:27.000Z (7 months ago)
• Last Synced: 2024-05-23T01:43:28.471Z (7 months ago)
• Topics: bug-bounty, docker, kali-linux, penetration-testing, red-team, zsh
• Language: Shell
• Homepage:
• Size: 83.1 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-hacking-lists - alexrf45/aegis - Repeatable, immutable, and scalable security research w/ Docker (Shell)

README

        
![Logo](https://ka-tet.s3.amazonaws.com/logo_long.png)                                                                                                                                           

![Logo](https://img.shields.io/docker/image-size/fonalex45/aegis) ![Logo](https://img.shields.io/docker/pulls/fonalex45/aegis)       

Aegis is a docker image designed for any engagement. Gone are the days of spinning up an entire Kali virtual machine or installing on bare metal. This image offers a flexible, repeatable environment for penetration testers, security researchers and analysts alike.

## Acknowledgements

 I pulled alot of inspiration from this awesome project and can only hope my project is as awesome as this one is.

 

- [Exegol - Fully featured and community-driven hacking environment](https://github.com/ThePorgs/Exegol)

## Features

- Bash script executable

- Command history logging via `script`

- Persistant containers, volumes and workspaces

- Customizable resources and tooling, config files are located in the `resources/` & `sources/` directories

- Non-root container w/ sudo

- Tmux inside the container (my favorite feature)

### Custom aliases included:

```

alias cme='nxc'

alias port-scan='sudo nmap -sC -sV -p- $IP > scan.txt'

alias udp-scan='sudo nmap -sU --top-ports 10 $IP -v > udp.scan.txt'

alias stealth-scan='sudo nmap --data-length 6 -T3 -A -ttl 64 -p- $IP > stealth-scan.txt'

alias public='curl wtfismyip.com/text'

alias t='tmux new -f ~/.tmux.conf -s $1'

alias :q='exit'

alias home='cd ~'

alias :r='. ~/.bashrc'

alias update='sudo apt update'

alias upgrade='sudo apt upgrade -y'

alias i='sudo apt install -y'

alias ls='ls --color=auto'

alias command='cat $HOME/.commands'

alias proxy='proxychains'

alias serve='sudo python3 -m http.server 80'

```

## Installation

**The script has one dependency: gum. this can be installed via your distro's package manager**

1. Clone the repo:

`git clone https://github.com/alexrf45/aegis.git && cd aegis`

2. Run the following commands to make the script ready for use:

```bash

$ cp aegis $HOME/.local/bin/. \

&& chmod +x $HOME/.local/bin/aegis \

&& source $HOME/.bashrc

```

## Usage/Examples

```bash

aegis start - start a container

aegis stop - stop a container

aegis enter- enter running container

aegis destory - destory a container

aegis backup - backup shared volume

aegis pull - update to latest image (dev, latest)

aegis help - view this help menu

```

## Command history

- Useful commands are already built into the container history. Simple type `CTRL+r' to pull up the fzf window where you can filter for the needed command. fzf makes navigating commands and files a breeze.

TODO:

- add quick https server script

- Python wrapper (FUTURE)

- Revamp bash function into script (beta)

- fzf usage (only works in zsh)

- miniserve quick web server w/ TLS function (done)