├── .docker └── apt-get-install ├── .dockerignore ├── .gitignore ├── .travis.yml ├── .travis.yml.footer ├── .travis.yml.header ├── Dockerfile ├── Dockerfile.archlinux ├── Dockerfile.artful ├── Dockerfile.fedora ├── Dockerfile.xenial ├── LICENSE ├── README.md ├── TODO ├── Vagrantfile ├── _buildstatus ├── .gitignore ├── fail.png ├── index.md ├── success.png └── unknown.png ├── bin ├── ctf-tools-pip ├── ctf-tools-pip3 ├── ctf-tools-test-action ├── ctf-tools-venv-activate ├── ctf-tools-venv-activate3 ├── manage-tools ├── travis-ci-status │ ├── Dockerfile │ ├── Makefile │ ├── fetch_latest_timingdata.inside-docker.sh │ ├── gen_travis_yml.sh │ ├── make_binpacked_travis_ci_conf.py │ └── make_build_status_md.py └── travis-ci.sh ├── sonic-visualizer ├── install ├── install-root-archlinux └── install-root-debian ├── steganabara └── install ├── stegdetect ├── install ├── install-root-archlinux └── install-root-debian ├── stego-toolkit ├── install └── install-root-debian ├── stegosaurus └── install ├── stegsolve └── install └── zsteg ├── install ├── install-root-archlinux ├── install-root-debian └── uninstall /.docker/apt-get-install: -------------------------------------------------------------------------------- 1 | #!/bin/sh -e 2 | export DEBIAN_FRONTEND="noninteractive" 3 | # update the package lists etc. 4 | apt-get -q update 5 | # this is actually against docker recommendations... But we'll do it anyway in 6 | # case our base image was not yet updated. 7 | apt-get dist-upgrade -y --no-install-recommends --auto-remove 8 | # finally install the package 9 | apt-get install -y --no-install-recommends --auto-remove "$@" 10 | # remove the package lists and apt-get metadata, such that the docker image 11 | # layer stays small 12 | apt-get -q clean 13 | rm -rf /var/lib/apt/lists/* 14 | -------------------------------------------------------------------------------- /.dockerignore: -------------------------------------------------------------------------------- 1 | * 2 | !.git 3 | !.docker 4 | !bin/ 5 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | */* 2 | bin/* 3 | !*/install 4 | !*/uninstall 5 | !*/install-root-* 6 | !*/upgrade 7 | !*/test 8 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: bash 2 | sudo: required 3 | services: 4 | - docker 5 | before_install: 6 | - if [ "$DISTRO" = "archlinux" ]; then docker build -t ctftools -f Dockerfile.archlinux .; fi 7 | - if [ "$DISTRO" = "fedora" ]; then docker build -t ctftools -f Dockerfile.fedora .; fi 8 | - if [ "$DISTRO" = "xenial" ]; then docker build -t ctftools -f Dockerfile.xenial .; fi 9 | - if [ "$DISTRO" = "trusty" ]; then docker build -t ctftools -f Dockerfile .; fi 10 | 11 | env: 12 | 13 | - DISTRO='archlinux' TOOL='afl android-sdk apktool binwalk burpsuite checksec df dirb elfkickers evilize featherduster firmware-mod-kit gdb hashpump hashpump-partialhash honggfuzz jdgui keystone libheap msieve pkcrack pwndbg pwntools python-paddingoracle pyvmmonitor radare2 sqlmap sslsplit testdisk tor-browser unicorn veles virtualsocket xortool xrop yafu zsteg' # estimated 2000 seconds 14 | - DISTRO='archlinux' TOOL='commix cribdrag dirsearch exetractor foresight gef pdf-parser peda peepdf pemcrack rp++ scrdec18 shellnoob ssh_decoder steganabara stegsolve subbrute' # estimated 16 seconds 15 | - DISTRO='archlinux' EXPECTFAIL=1 TOOL='qira taintgrind z3' # estimated 1831 seconds 16 | - DISTRO='archlinux' EXPECTFAIL=1 TOOL='angr barf beef bindead capstone codereason dislocker elfparser gdb-heap hash-identifier hashkill littleblackbox mitmproxy panda pathgrind preeny python-pin reveng ropper shellsploit snowman sonic-visualizer stegdetect villoc wcc xspy' # estimated 764 seconds 17 | # - DISTRO='archlinux' TOOL='qemu' # unknown duration... 18 | - DISTRO='fedora' TOOL='apktool binwalk burpsuite capstone checksec commix cribdrag dirsearch elfkickers evilize exetractor foresight gdb gef jdgui libheap pdf-parser peda peepdf pkcrack python-paddingoracle pyvmmonitor radare2 ropper rp++ scrdec18 shellnoob shellsploit ssh_decoder steganabara stegsolve subbrute unicorn virtualsocket xortool yafu z3' # estimated 1779 seconds 19 | - DISTRO='fedora' EXPECTFAIL=1 TOOL='afl android-sdk angr barf beef bindead codereason df dirb dislocker elfparser featherduster firmware-mod-kit gdb-heap hash-identifier hashkill hashpump hashpump-partialhash honggfuzz keystone littleblackbox mitmproxy msieve panda pathgrind pemcrack preeny pwndbg pwntools python-pin qemu qira reveng snowman sonic-visualizer sqlmap sslsplit stegdetect taintgrind testdisk tor-browser veles villoc wcc xrop xspy zsteg' # estimated 549 seconds 20 | - DISTRO='trusty' TOOL='barf capstone jdgui stegdetect yafu z3' # estimated 1995 seconds 21 | - DISTRO='trusty' TOOL='qemu' # estimated 2160 seconds 22 | - DISTRO='trusty' TOOL='apktool bindead featherduster gdb qira snowman' # estimated 1976 seconds 23 | - DISTRO='trusty' TOOL='afl android-sdk burpsuite codereason df firmware-mod-kit hashkill keystone mitmproxy pwndbg pwntools radare2 unicorn' # estimated 1976 seconds 24 | - DISTRO='trusty' TOOL='binwalk checksec commix cribdrag dirb dirsearch dislocker elfkickers elfparser evilize exetractor foresight gef hash-identifier hashpump hashpump-partialhash honggfuzz libheap littleblackbox msieve pdf-parser peda peepdf pemcrack pkcrack preeny python-paddingoracle python-pin pyvmmonitor ropper rp++ scrdec18 shellnoob shellsploit sqlmap ssh_decoder sslsplit steganabara stegsolve subbrute testdisk tor-browser villoc virtualsocket xortool xspy zsteg' # estimated 374 seconds 25 | - DISTRO='trusty' EXPECTFAIL=1 TOOL='angr panda sonic-visualizer' # estimated 1877 seconds 26 | - DISTRO='trusty' EXPECTFAIL=1 TOOL='beef gdb-heap pathgrind reveng taintgrind veles wcc xrop' # estimated 303 seconds 27 | - DISTRO='xenial' TOOL='qemu' # estimated 1928 seconds 28 | - DISTRO='xenial' TOOL='barf keystone mitmproxy z3' # estimated 1920 seconds 29 | - DISTRO='xenial' TOOL='afl android-sdk angr firmware-mod-kit gdb snowman' # estimated 1985 seconds 30 | - DISTRO='xenial' TOOL='apktool binwalk burpsuite capstone checksec codereason commix cribdrag df dirb dirsearch dislocker elfkickers elfparser evilize exetractor featherduster foresight gef hash-identifier hashpump hashpump-partialhash honggfuzz jdgui libheap littleblackbox msieve pdf-parser peda peepdf pemcrack pkcrack preeny pwndbg python-paddingoracle pyvmmonitor radare2 ropper rp++ scrdec18 shellnoob shellsploit sqlmap ssh_decoder sslsplit steganabara stegsolve subbrute testdisk tor-browser unicorn veles virtualsocket xortool xspy yafu' # estimated 1230 seconds 31 | - DISTRO='xenial' EXPECTFAIL=1 TOOL='beef bindead gdb-heap hashkill panda pathgrind pwntools python-pin qira reveng sonic-visualizer stegdetect taintgrind villoc wcc xrop zsteg' # estimated 457 seconds 32 | script: 33 | - travis_wait 50 ./bin/travis-ci.sh 34 | 35 | -------------------------------------------------------------------------------- /.travis.yml.footer: -------------------------------------------------------------------------------- 1 | script: 2 | - travis_wait 50 ./bin/travis-ci.sh 3 | 4 | -------------------------------------------------------------------------------- /.travis.yml.header: -------------------------------------------------------------------------------- 1 | language: bash 2 | sudo: required 3 | services: 4 | - docker 5 | before_install: 6 | - if [ "$DISTRO" = "archlinux" ]; then docker build -t ctftools -f Dockerfile.archlinux .; fi 7 | - if [ "$DISTRO" = "fedora" ]; then docker build -t ctftools -f Dockerfile.fedora .; fi 8 | - if [ "$DISTRO" = "xenial" ]; then docker build -t ctftools -f Dockerfile.xenial .; fi 9 | - if [ "$DISTRO" = "trusty" ]; then docker build -t ctftools -f Dockerfile .; fi 10 | 11 | env: 12 | 13 | -------------------------------------------------------------------------------- /Dockerfile: -------------------------------------------------------------------------------- 1 | FROM ubuntu:trusty 2 | 3 | # wrapper script for apt-get 4 | COPY .docker/apt-get-install /usr/local/bin/apt-get-install 5 | RUN chmod +x /usr/local/bin/apt-get-install 6 | 7 | RUN apt-get-install build-essential libtool g++ gcc \ 8 | texinfo curl wget automake autoconf python python-dev git subversion \ 9 | unzip virtualenvwrapper sudo git virtualenvwrapper ca-certificates 10 | 11 | RUN useradd -m ctf 12 | RUN echo "ctf ALL=NOPASSWD: ALL" > /etc/sudoers.d/ctf 13 | 14 | COPY .git /home/ctf/tools/.git 15 | RUN chown -R ctf.ctf /home/ctf/tools 16 | 17 | # git checkout of the files 18 | USER ctf 19 | WORKDIR /home/ctf/tools 20 | RUN git checkout . 21 | 22 | # add non-commited scripts 23 | USER root 24 | COPY bin/manage-tools /home/ctf/tools/bin/ 25 | COPY bin/ctf-tools-pip /home/ctf/tools/bin/ 26 | COPY bin/ctf-tools-venv-activate /home/ctf/tools/bin/ 27 | COPY bin/ctf-tools-venv-activate3 /home/ctf/tools/bin/ 28 | RUN chown -R ctf.ctf /home/ctf/tools 29 | 30 | # finally run ctf-tools setup 31 | USER ctf 32 | RUN bin/manage-tools -s setup 33 | RUN bin/ctf-tools-pip install appdirs 34 | #RUN echo "workon ctftools" >> /home/ctf/.bashrc 35 | RUN echo 'source $(which ctf-tools-venv-activate)' >> /home/ctf/.bashrc 36 | 37 | WORKDIR /home/ctf 38 | CMD bash -i 39 | -------------------------------------------------------------------------------- /Dockerfile.archlinux: -------------------------------------------------------------------------------- 1 | from base/archlinux 2 | 3 | RUN cat /etc/pacman.d/mirrorlist \ 4 | | sed 's/^#Server/Server/' \ 5 | > /etc/pacman.d/mirrorlist.backup \ 6 | && rankmirrors -n 10 /etc/pacman.d/mirrorlist.backup \ 7 | > /etc/pacman.d/mirrorlist 8 | 9 | RUN echo "[multilib]" >> /etc/pacman.conf 10 | RUN echo "Include = /etc/pacman.d/mirrorlist" >> /etc/pacman.conf 11 | 12 | RUN pacman -Syy \ 13 | && pacman -S --noconfirm archlinux-keyring \ 14 | && pacman -Scc --noconfirm 15 | RUN pacman-key --refresh-keys 16 | RUN pacman -Syu --noconfirm \ 17 | && pacman-db-upgrade \ 18 | && pacman -Scc --noconfirm \ 19 | && pacman -Syu --noconfirm \ 20 | && pacman -Scc --noconfirm 21 | RUN trust extract-compat 22 | RUN pacman -Syu --noconfirm --needed \ 23 | curl wget python2 python3 git subversion \ 24 | python2-pip python-pip \ 25 | unzip python-virtualenvwrapper \ 26 | zsh grml-zsh-config \ 27 | sudo which \ 28 | && pacman -Scc --noconfirm 29 | 30 | RUN useradd -m ctf 31 | RUN echo "ctf ALL=NOPASSWD: ALL" > /etc/sudoers.d/ctf 32 | RUN chsh -s /usr/bin/zsh ctf 33 | 34 | COPY .git /home/ctf/tools/.git 35 | RUN chown -R ctf.ctf /home/ctf/tools 36 | 37 | USER ctf 38 | 39 | WORKDIR /home/ctf/tools 40 | RUN git checkout . 41 | 42 | # add non-commited scripts 43 | USER root 44 | COPY bin/manage-tools /home/ctf/tools/bin/ 45 | COPY bin/ctf-tools-pip /home/ctf/tools/bin/ 46 | COPY bin/ctf-tools-venv-activate /home/ctf/tools/bin/ 47 | COPY bin/ctf-tools-venv-activate3 /home/ctf/tools/bin/ 48 | RUN chown -R ctf.ctf /home/ctf/tools 49 | 50 | USER ctf 51 | RUN bin/manage-tools -s setup 52 | RUN echo 'source $(which virtualenvwrapper.sh)' >> ~/.zshrc 53 | RUN echo 'workon ctftools' >> ~/.zshrc 54 | 55 | WORKDIR /home/ctf 56 | CMD ["zsh", "-i"] 57 | -------------------------------------------------------------------------------- /Dockerfile.artful: -------------------------------------------------------------------------------- 1 | FROM ubuntu:artful 2 | 3 | # wrapper script for apt-get 4 | COPY .docker/apt-get-install /usr/local/bin/apt-get-install 5 | RUN chmod +x /usr/local/bin/apt-get-install 6 | 7 | RUN apt-get-install build-essential libtool g++ gcc \ 8 | texinfo curl wget automake autoconf python python-dev git subversion \ 9 | unzip virtualenvwrapper sudo git virtualenvwrapper 10 | 11 | RUN useradd -m ctf 12 | RUN echo "ctf ALL=NOPASSWD: ALL" > /etc/sudoers.d/ctf 13 | 14 | COPY .git /home/ctf/tools/.git 15 | RUN chown -R ctf.ctf /home/ctf/tools 16 | 17 | # git checkout of the files 18 | USER ctf 19 | WORKDIR /home/ctf/tools 20 | RUN git checkout . 21 | 22 | # add non-commited scripts 23 | USER root 24 | COPY bin/manage-tools /home/ctf/tools/bin/ 25 | COPY bin/ctf-tools-pip /home/ctf/tools/bin/ 26 | COPY bin/ctf-tools-venv-activate /home/ctf/tools/bin/ 27 | COPY bin/ctf-tools-venv-activate3 /home/ctf/tools/bin/ 28 | RUN chown -R ctf.ctf /home/ctf/tools 29 | 30 | # finally run ctf-tools setup 31 | USER ctf 32 | RUN bin/manage-tools -s setup 33 | RUN bin/ctf-tools-pip install appdirs 34 | #RUN echo "workon ctftools" >> /home/ctf/.bashrc 35 | RUN echo 'source $(which ctf-tools-venv-activate)' >> /home/ctf/.bashrc 36 | 37 | WORKDIR /home/ctf 38 | #CMD bash -i 39 | -------------------------------------------------------------------------------- /Dockerfile.fedora: -------------------------------------------------------------------------------- 1 | FROM fedora 2 | 3 | RUN dnf -y install which sudo git redhat-lsb 4 | 5 | RUN useradd -m ctf 6 | COPY .git /home/ctf/tools/.git 7 | RUN chown -R ctf.ctf /home/ctf/tools 8 | 9 | RUN echo "ctf ALL=NOPASSWD: ALL" > /etc/sudoers.d/ctf 10 | USER ctf 11 | 12 | WORKDIR /home/ctf/tools 13 | RUN git checkout . 14 | 15 | # add non-commited scripts 16 | USER root 17 | COPY bin/manage-tools /home/ctf/tools/bin/ 18 | COPY bin/ctf-tools-pip /home/ctf/tools/bin/ 19 | COPY bin/ctf-tools-venv-activate /home/ctf/tools/bin/ 20 | COPY bin/ctf-tools-venv-activate3 /home/ctf/tools/bin/ 21 | RUN chown -R ctf.ctf /home/ctf/tools 22 | 23 | USER ctf 24 | RUN bin/manage-tools -s setup 25 | RUN bin/ctf-tools-pip install appdirs 26 | RUN echo 'source $(which ctf-tools-venv-activate)' >> /home/ctf/.bashrc 27 | 28 | WORKDIR /home/ctf 29 | CMD bash -i 30 | -------------------------------------------------------------------------------- /Dockerfile.xenial: -------------------------------------------------------------------------------- 1 | from ubuntu:xenial 2 | 3 | # wrapper script for apt-get 4 | COPY .docker/apt-get-install /usr/local/bin/apt-get-install 5 | RUN chmod +x /usr/local/bin/apt-get-install 6 | 7 | RUN apt-get-install build-essential libtool g++ gcc \ 8 | texinfo curl wget automake autoconf python python-dev git subversion \ 9 | unzip virtualenvwrapper sudo git virtualenvwrapper 10 | 11 | RUN useradd -m ctf 12 | RUN echo "ctf ALL=NOPASSWD: ALL" > /etc/sudoers.d/ctf 13 | 14 | COPY .git /home/ctf/tools/.git 15 | RUN chown -R ctf.ctf /home/ctf/tools 16 | 17 | # git checkout of the files 18 | USER ctf 19 | WORKDIR /home/ctf/tools 20 | RUN git checkout . 21 | 22 | # add non-commited scripts 23 | USER root 24 | COPY bin/manage-tools /home/ctf/tools/bin/ 25 | COPY bin/ctf-tools-pip /home/ctf/tools/bin/ 26 | COPY bin/ctf-tools-venv-activate /home/ctf/tools/bin/ 27 | COPY bin/ctf-tools-venv-activate3 /home/ctf/tools/bin/ 28 | RUN chown -R ctf.ctf /home/ctf/tools 29 | 30 | # finally run ctf-tools setup 31 | USER ctf 32 | RUN bin/manage-tools -s setup 33 | RUN bin/ctf-tools-pip install appdirs 34 | #RUN echo "workon ctftools" >> /home/ctf/.bashrc 35 | RUN echo 'source $(which ctf-tools-venv-activate)' >> /home/ctf/.bashrc 36 | 37 | WORKDIR /home/ctf 38 | CMD bash -i 39 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | BSD 3-Clause License 2 | 3 | Copyright (c) 2019-present, Zardus and contributors 4 | All rights reserved. 5 | 6 | Redistribution and use in source and binary forms, with or without 7 | modification, are permitted provided that the following conditions are met: 8 | 9 | * Redistributions of source code must retain the above copyright notice, this 10 | list of conditions and the following disclaimer. 11 | 12 | * Redistributions in binary form must reproduce the above copyright notice, 13 | this list of conditions and the following disclaimer in the documentation 14 | and/or other materials provided with the distribution. 15 | 16 | * Neither the name of the copyright holder nor the names of its 17 | contributors may be used to endorse or promote products derived from 18 | this software without specific prior written permission. 19 | 20 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 21 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 23 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 24 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 26 | SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 27 | CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 28 | OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 29 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # ctf-tools 2 | [![Build Status](https://travis-ci.org/zardus/ctf-tools.svg?branch=master)](https://travis-ci.org/zardus/ctf-tools) 3 | [![IRC](https://img.shields.io/badge/freenode-%23ctf--tools-green.svg)](http://webchat.freenode.net/?channels=#ctf-tools) 4 | 5 | This is a collection of setup scripts to create an install of various security research tools. 6 | Of course, this isn't a hard problem, but it's really nice to have them in one place that's easily deployable to new machines and so forth. 7 | The install-scripts for these tools are checked regularly, the results can be found on [the build status page](_buildstatus/index.md). 8 | 9 | Installers for the following tools are included: 10 | 11 | | Category | Source | Tool | Description | 12 | |----------|--------|------|-------------| 13 | | stego | apt | [pngtools](https://launchpad.net/ubuntu/+source/pngtools) | PNG's analysis tool. | 14 | | stego | Directory | [sound-visualizer](http://www.sonicvisualiser.org/) | Audio file visualization. | 15 | | stego | Directory | [steganabara](http://www.caesum.com/handbook/stego.htm) | Another image stenography solver. | 16 | | stego | Directory | [stegdetect](http://www.outguess.org/) | Stenography detection/breaking tool. | 17 | | stego | Docker | [stego-toolkit](https://github.com/DominicBreuker/stego-toolkit) | A docker image with dozens of steg tools. | 18 | | stego | Directory | [stegsolve](http://www.caesum.com/handbook/stego.htm) | Image stenography solver. | 19 | | stego | Directory | [stegosaurus](https://github.com/AngelKitty/stegosaurus) | A steganography tool for embedding arbitrary payloads in Python bytecode (pyc or pyo) files. | 20 | | stego | Directory | [zsteg](https://github.com/zed-0xff/zsteg) | detect stegano-hidden data in PNG & BMP. | 21 | 22 | ## Fork 23 | 24 | This repository contains a fork of the original 25 | [ctf-tools](https://github.com/zardus/ctf-tools). It was made a long time ago, 26 | and contains a lot of tools that do not reflect the current state of the art. 27 | 28 | This fork is based on The Flat Network Society's experience with modern CTF. It 29 | contains only tools that are used to solve challenges in 2020. 30 | 31 | ## Usage 32 | 33 | To use, do: 34 | 35 | ```bash 36 | # set up the path 37 | /path/to/ctf-tools/bin/manage-tools setup 38 | source ~/.bashrc 39 | 40 | # list the available tools 41 | manage-tools list 42 | 43 | # install gdb, allowing it to try to sudo install dependencies 44 | manage-tools -s install gdb 45 | 46 | # install pwntools, but don't let it sudo install dependencies 47 | manage-tools install pwntools 48 | 49 | # install qemu, but use "nice" to avoid degrading performance during compilation 50 | manage-tools -n install qemu 51 | 52 | # uninstall gdb 53 | manage-tools uninstall gdb 54 | 55 | # uninstall all tools 56 | manage-tools uninstall all 57 | 58 | # search for a tool 59 | manage-tools search preload 60 | ``` 61 | 62 | Where possible, the tools keep the installs very self-contained (i.e., in to tool/ directory), and most uninstalls are just calls to `git clean` (**NOTE**, this is **NOT** careful; everything under the tool directory, including whatever you were working on, is blown away during an uninstall). 63 | One exception to this are python tools, which are installed using the `pip` 64 | package manager if possible. A `ctftools` virtualenv is created during the 65 | `manage-tools setup` command and can be accessed using the command 66 | `workon ctftools`. 67 | 68 | ## Help! 69 | 70 | Something not working? 71 | I didn't write (almost) any of these tools, but hit up [#ctf-tools on freenode](http://webchat.freenode.net/?channels=#ctf-tools) if you're desperate. 72 | Maybe some kind soul will help! 73 | 74 | ## Docker (version 1.7+) 75 | 76 | By popular demand, a Dockerfile has been included. 77 | You can build a docker image with: 78 | 79 | ```bash 80 | git clone https://github.com/zardus/ctf-tools 81 | cd ctf-tools 82 | docker build -t ctf-tools . 83 | ``` 84 | 85 | And run it with: 86 | 87 | ```bash 88 | docker run -it ctf-tools 89 | ``` 90 | 91 | The built image will have ctf-tools cloned and ready to go, but you will still need to install the tools themselves (see above). 92 | 93 | Alternatively, you can also pull ctf-tools (with some tools preinstalled) from dockerhub: 94 | 95 | ```bash 96 | docker run -it zardus/ctf-tools 97 | ``` 98 | 99 | ## Vagrant 100 | 101 | You can build a Vagrant VM with: 102 | 103 | ```bash 104 | wget https://raw.githubusercontent.com/zardus/ctf-tools/master/Vagrantfile 105 | vagrant plugin install vagrant-vbguest 106 | vagrant up 107 | ``` 108 | 109 | And connect to it via: 110 | 111 | ```bash 112 | vagrant ssh 113 | ``` 114 | 115 | ## Kali Linux 116 | 117 | Kali Linux (Sana and Rolling), due to manually setting certain libraries to not use the latest version available (sometimes being out of date by years) causes some tools to not install at all, or fail in strange ways. AFL and Panda comes to mind, in fact any tool that uses QEMU 2.30 will probably fail during compilation under Kali. 118 | Overriding these libraries breaks other tools included in Kali so your only solution is to either live with some of Kali's tools being broken, or running another distribution separately such as Ubuntu. 119 | 120 | Most tools aren't affected though. 121 | 122 | ## Adding Tools 123 | 124 | To add a tool (say, named *toolname*), do the following: 125 | 126 | 1. Create a `toolname` directory. 127 | 2. Create an `install` script. 128 | 3. (optional) if special uninstall steps are required, create an `uninstall` script. 129 | 130 | ### Install Scripts 131 | 132 | The install script will be run with `$PWD` being `toolname`. It should install the tool into this directory, in as contained a manner as possible. 133 | Ideally, full uninstallation should be possible with a `git clean`. 134 | 135 | The install script should create a `bin` directory and put its executables there. 136 | These executables will be automatically linked into the main `bin` directory for the repo. 137 | They could be launched from any directory, so don't make assumptions about the location of `$0`! 138 | 139 | ## License 140 | 141 | The individual tools are all licensed under their own licenses. 142 | As for ctf-tools itself, it is licensed under BSD 2-Clause License. 143 | If you find it useful, star it on github (https://github.com/zardus/ctf-tools). 144 | 145 | Good luck! 146 | 147 | # See Also 148 | 149 | There's a curated list of CTF tools, but without installers, here: https://github.com/apsdehal/aWEsoMe-cTf. 150 | 151 | There's a Vagrant config with a lot of the bigger frameworks here: https://github.com/thebarbershopper/epictreasure. 152 | -------------------------------------------------------------------------------- /TODO: -------------------------------------------------------------------------------- 1 | xrop -- doesn't build 2 | msieve 3 | sonic visualiser -- doesn't build 4 | -------------------------------------------------------------------------------- /Vagrantfile: -------------------------------------------------------------------------------- 1 | # -*- mode: ruby -*- 2 | # vi: set ft=ruby : 3 | 4 | $bootstrap = <