Repository: zardus/ctf-tools
Stars: 9362
README.md
ctf-tools
This is a collection of setup scripts to create an install of various security research tools.
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.
The install-scripts for these tools are checked every once in a while, so things should hopefully have a decent chance of working!
Installers for the following tools are included:
| Category | Tool | Description |
|----------|------|-------------|
| binary | angr | !Last Build Next-generation binary analysis engine from Shellphish. | <!--tool-->
| binary | angr-management | !Last Build A GUI reverse engineering and decompilation tool. | <!--tool-->
| binary | beef | !Last Build Browser exploitation framework. | <!--tool-->
| binary | crosstool | !Last Build Cross-compilers and cross-architecture tools. | <!--tool--><!--no-test-->
| binary | cross2 | !Last Build A set of cross-compilation tools from a Japanese book on C. | <!--tool--><!--no-test-->
| binary | decomp2dbg | !Last Build A plugin to introduce interactive symbols into your debugger from your decompiler. | <!--tool-->
| binary | elfkickers | !Last Build A set of utilities for working with ELF files. | <!--tool-->
| binary | elfparser | !Last Build Multiplatform CLI and GUI tool to show information about ELF files. | <!--tool-->
| binary | evilize | !Last Build Tool to create MD5 colliding binaries | <!--tool-->
| binary | gdb | !Last Build Up-to-date gdb with python2 bindings. | <!--tool--><!--slow-test-->
| binary | gef | !Last Build Enhanced environment for gdb. | <!--tool-->
| binary | ghidra | !Last Build Open-source reverse engineering and decompilation tool. | <!--tool-->
| binary | honggfuzz | !Last Build A general-purpose, easy-to-use fuzzer with interesting analysis options. | <!--tool-->
| binary | ida | Decompilation and reversing tool (requires you to download it to ~/Downloads on your own!). | <!--tool--><!--no-test-->
| binary | manticore | !Last Build Manticore is a prototyping tool for dynamic binary analysis, with support for symbolic execution, taint analysis, and binary instrumentation. | <!--tool-->
| binary | one_gadget | !Last Build Magic gadget search for libc. | <!--tool-->
| binary | preeny | !Last Build A collection of helpful preloads (compiled for many architectures!). | <!--tool-->
| binary | pwninit | !Last Build Script to automate starting pwning challenges. | <!--tool-->
| binary | pwndbg | !Last Build Enhanced environment for gdb. Especially for pwning. | <!--tool-->
| binary | pwnsh | !Last Build Useful shell scripts for assembly, exploitation, etc. | <!--tool-->
| binary | pwntools | !Last Build Useful CTF utilities. | <!--tool-->
| binary | qemu | !Last Build Latest version of qemu! | <!--tool--><!--slow-test-->
| binary | qiling | !Last Build A dynamic binary instrumentation framework. | <!--tool-->
| binary | qira | !Last Build Parallel, timeless debugger. | <!--tool--><!--slow-test-->
| binary | rappel | !Last Build A linux-based assembly REPL. | <!--tool-->
| binary | ropper | !Last Build Another gadget finder. | <!--tool-->
| binary | rp++ | !Last Build Another gadget finder. | <!--tool-->
| binary | seccomp-tools | !Last Build Provides powerful tools for seccomp analysis | <!--tool-->
| binary | shellnoob | !Last Build Shellcode writing helper. | <!--tool-->
| binary | taintgrind | !Last Build A valgrind taint analysis tool. | <!--tool--><!--failing-->
| binary | valgrind | !Last Build A Dynamic Binary Instrumentation framework with some built-in tools. | <!--tool-->
| binary | villoc | !Last Build Visualization of heap operations. | <!--tool-->
| binary | xrop | !Last Build Gadget finder. | <!--tool--><!--failing-->
| forensics | firmware-mod-kit | !Last Build Tools for firmware packing/unpacking. | <!--tool-->
| forensics | pdf-parser | !Last Build Tool for digging in PDF files | <!--tool-->
| forensics | peepdf | !Last Build Powerful Python tool to analyze PDF documents. | <!--tool-->
| forensics | scrdec18 | !Last Build A decoder for encoded Windows Scripts. | <!--tool-->
| forensics | volatility | !Last Build Analyzer for system memory dumps (classic python2 version; requires python2 tool). | <!--tool-->
| forensics | volatility3 | !Last Build Analyzer for system memory dumps (latest version). | <!--tool-->
| crypto | codext | !Last Build Python codecs extension featuring CLI tools for encoding/decoding anything including AI-based guessing mode. | <!--tool-->
| crypto | cribdrag | !Last Build Interactive crib dragging tool (for crypto). | <!--tool-->
| crypto | fastcoll | !Last Build An md5sum collision generator. | <!--tool-->
| crypto | foresight | !Last Build A tool for predicting the output of random number generators. To run, launch "foresee". | <!--tool-->
| crypto | featherduster | !Last Build An automated, modular cryptanalysis tool. WARNING: needs python2 (which can be installed with ctf-tools). | <!--tool-->
| crypto | galois | !Last Build A fast galois field arithmetic library/toolkit. | <!--tool-->
| crypto | hashpump-partialhash | !Last Build Hashpump, supporting partially-unknown hashes. | <!--tool-->
| crypto | hash-identifier | !Last Build Simple hash algorithm identifier. | <!--tool-->
| crypto | libc-database | !Last Build Build a database of libc offsets to simplify exploitation. | <!--tool--><!--slow-test-->
| crypto | msieve | !Last Build Msieve is a C library implementing a suite of algorithms to factor large integers. | <!--tool-->
| crypto | nonce-disrespect | !Last Build Nonce-Disrespecting Adversaries: Practical Forgery Attacks on GCM in TLS. | <!--tool-->
| crypto | pemcrack | !Last Build SSL PEM file cracker. | <!--tool-->
| crypto | pkcrack | !Last Build PkZip encryption cracker. | <!--tool-->
| crypto | reveng | !Last Build CRC finder. | <!--tool-->
| crypto | rsactftool | !Last Build RSA attack tool. | <!--tool-->
| crypto | ssh_decoder | !Last Build A tool for decoding ssh traffic. You will need ruby1.8 from https://launchpad.net/~brightbox/+archive/ubuntu/ruby-ng to run this. Run with ssh_decoder --help for help, as running it with no arguments causes it to crash. | <!--tool-->
| crypto | sslsplit | !Last Build SSL/TLS MITM. | <!--tool-->
| crypto | xortool | !Last Build XOR analysis tool. | <!--tool-->
| crypto | yafu | !Last Build Automated integer factorization. | <!--tool-->
| web | burpsuite | !Last Build Web proxy to do naughty web stuff. | <!--tool--><!--failing-->
| web | commix | !Last Build Command injection and exploitation tool. | <!--tool-->
| web | mitmproxy | !Last Build CLI Web proxy and python library. | <!--tool-->
| web | subbrute | !Last Build A DNS meta-query spider that enumerates DNS records, and subdomains. | <!--tool-->
| web | webgrep | !Last Build grep for Web pages, with JS deobfuscation, CSS unminifying and OCR on images. | <!--tool-->
| stego | steganabara | !Last Build Another image stenography solver. | <!--tool-->
| stego | stegano-tools | !Last Build A collection of text and image steganography tools (incl LSB, PVD, PIT). | <!--tool-->
| stego | stegdetect | !Last Build Stenography detection/breaking tool. | <!--tool-->
| stego | stegsolve | !Last Build Image stenography solver. | <!--tool-->
| stego | stegosaurus | !Last Build A steganography tool for embedding arbitrary payloads in Python bytecode (pyc or pyo) files. | <!--tool-->
| stego | zsteg | !Last Build detect stegano-hidden data in PNG & BMP. | <!--tool-->
| misc | jdgui | !Last Build Java decompiler. | <!--tool-->
| misc | python2 | !Last Build For when you really need it... | <!--tool-->
| misc | social-analyzer | !Last Build Social media reconnaissance tool... | <!--tool-->
| misc | veles | !Last Build Binary data analysis and visualization tool. | <!--tool-->
| misc | xspy | !Last Build Tiny tool to spy on X sessions. | <!--tool-->
There are also some installers for non-CTF stuff to break the monotony!
| Category | Tool | Description |
|----------|------|-------------|
| game | df | !Last Build Dwarf Fortress! Something to help you relax after a CTF! | <!--tool-->
| web | tor-browser | !Last Build Useful when you need to hit a web challenge from different IPs. | <!--tool-->
Usage
To use, do:
set up the path
/path/to/ctf-tools/bin/manage-tools setup
source ~/.bashrclist the available tools
manage-tools listinstall gdb, allowing it to try to sudo install dependencies
manage-tools -s install gdbinstall pwntools, but don't let it sudo install dependencies
manage-tools install pwntoolsinstall qemu, but use "nice" to avoid degrading performance during compilation
manage-tools -n install qemuuninstall gdb
manage-tools uninstall gdbuninstall all tools
manage-tools uninstall allsearch for a tool
manage-tools search preloadWhere 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).
Python and Ruby tools are installed in a tool-specific virtual environment.
If you want to add other packages to this environment, look under the ctf-tools/TOOL/pipx or ctf-tools/TOOL/gems directories.
Help!
Something not working?
I didn't write (almost) any of these tools, but hit up the discord if you're desperate.
Maybe some kind soul will help!
Dockerized Tools
Prebuilt Tool Containers
You can get most of these tools in prebuilt containers from https://hub.docker.com/r/ctftools.
For example:
$ echo hi | docker run -i ctftools/taintgrind taintgrind --taint-stdin=yes /bin/cat
/home/ctf/tools/taintgrind/valgrind-3.21.0/build/bin/valgrind --tool=taintgrind --taint-stdin=yes /bin/cat
==8== Taintgrind, the taint analysis tool
==8== Copyright (C) 2010-2018, and GNU GPL'd, by Wei Ming Khoo.
==8== Using Valgrind-3.21.0 and LibVEX; rerun with -h for copyright info
==8== Command: /bin/cat
==8==
0xFFFFFFFF: _syscall_read | Read:3 | 0x0 | 4a5a000_unknownobj
hi
==8==Building Your Own
You can build a docker image with:
git clone https://github.com/zardus/ctf-tools
cd ctf-tools
docker build -t ctf-tools --build-arg PREINSTALLED=some-tool .And run it with:
docker run -it ctf-toolsThe built image will have ctf-tools cloned and ready to go and your tool installed.
Kali Linux
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.
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, use docker, or running another distribution separately such as Ubuntu.
Adding Tools
To add a tool (say, named toolname), do the following:
1. Create a toolname directory.
2. Create an install script.
3. Add it to the readme.
4. (optional) if special uninstall steps are required, create an uninstall script.
Install Scripts
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.
Ideally, full uninstallation should be possible with a git clean.
The install script should create a bin directory and put its executables there.
These executables will be automatically linked into the main bin directory for the repo.
They could be launched from any directory, so don't make assumptions about the location of $0!
License
The individual tools are all licensed under their own licenses.
As for ctf-tools itself, it is licensed under BSD 2-Clause License.
If you find it useful, star it on github (https://github.com/zardus/ctf-tools).
Good luck!
See Also
There's a curated list of CTF tools, but without installers, here: https://github.com/apsdehal/aWEsoMe-cTf.
There's a Vagrant config with a lot of the bigger frameworks here: https://github.com/thebarbershopper/epictreasure.
Useful CTF tools in apt repos
As tools get officially packaged, we switch to just suggesting that you apt install them!
| Category | Source | Tool | Description |
|----------|--------|------|-------------|
| binary | apt | aflplusplus | State-of-the-art fuzzer. |
| binary | apt | checksec | Check binary hardening settings. |
| binary | apt | radare2 | Some crazy thing crowell likes. |
| binary | apt | rr | Record and Replay Debugging Framework |
| binary | apt | wcc | The Witchcraft Compiler Collection is a collection of compilation tools to perform binary black magic on the GNU/Linux and other POSIX platforms. |
| forensics | apt | binwalk | Firmware (and arbitrary file) analysis tool. |
| forensics | apt | foremost | File carver. |
| forensics | apt | dislocker | Tool for reading Bitlocker encrypted partitions. |
| forensics | apt | origami-pdf | PDF manipulator. |
| forensics | apt | testdisk | Testdisk and photorec for file recovery. |
| web | apt | dirb | Web path scanner. |
| web | apt | dirsearch | Web path scanner. |
| web | apt | sqlmap | SQL injection automation engine. |
| stego | apt | pngtools | PNG's analysis tool. |
| stego | apt | sonic-visualizer | Audio file visualization. |
| networking | apt | dsniff | Grabs passwords and other data from pcaps/network streams. |
| networking | apt | bettercap | Network shenanigans swiss army knife. |
| misc | apt | z3 | Theorem prover from Microsoft Research. |
| osint | apt | sherlock | Tools for Hunt down social media accounts by username across 400+ social networks . |
Useful CTF tools in docker images
Previously, this repository included some scripts that were wrappers around docker pull.
We trust that you can do that yourself :-)
| Category | Source | Tool | Description |
|----------|--------|------|-------------|
| binary | docker | panda | Platform for Architecture-Neutral Dynamic Analysis. |
| stego | Docker | stego-toolkit | A docker image with dozens of steg tools. |
Useful CTF Libraries
Previously, this repository included library installers.
Because of how bespoke library install preferences are (e.g., unlike a tool, it's not clear if per-library venvs are a desired thing), we've stopped shipping them, and link them here for posterity.
| Category | Source | Tool | Description |
|----------|--------|------|-------------|
| binary | Library | capstone | Multi-architecture disassembly framework. |
| binary | Library | keystone | Lightweight multi-architecture assembler framework. |
| binary | Library | lief | Library to Instrument Executable Formats. |
| binary | Library | miasm | Reverse engineering framework in Python. |
| binary | Library | unicorn | Multi-architecture CPU emulator framework. |
| binary | Library | virtualsocket | A nice library to interact with binaries. |
| crypto | Library | cryptanalib3 | The surviving core of featherduster cryptanalysis tool, updated for python3. |
| crypto | Library | python-paddingoracle | Padding oracle attack automation. |