Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vulhub/vulhub

Pre-Built Vulnerable Environments Based on Docker-Compose
https://github.com/vulhub/vulhub

docker docker-compose dockerfile vulhub vulnerability-environment

Last synced: 6 days ago
JSON representation

Pre-Built Vulnerable Environments Based on Docker-Compose

Host: GitHub
URL: https://github.com/vulhub/vulhub
Owner: vulhub
License: mit
Created: 2017-04-09T10:13:13.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-04-18T18:48:05.000Z (7 months ago)
Last Synced: 2024-05-02T05:58:25.547Z (6 months ago)
Topics: docker, docker-compose, dockerfile, vulhub, vulnerability-environment
Language: Dockerfile
Homepage: https://vulhub.org
Size: 165 MB
Stars: 16,220
Watchers: 570
Forks: 4,316
Open Issues: 38
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome - vulhub/vulhub - Pre-Built Vulnerable Environments Based on Docker-Compose (Dockerfile)
awesome-list - vulhub - Built Vulnerable Environments Based on Docker-Compose | vulhub | 8322 | (Dockerfile)
awesome-list - Vulhub - Pre-Built Vulnerable Environments Based on Docker-Compose. (Security / For Java)
Awesome-Hacking - Vulhub - Built Vulnerable Environments Based on Docker-Compose (Other Useful Repositories)
awesome-hacking-lists - vulhub/vulhub - Pre-Built Vulnerable Environments Based on Docker-Compose (Dockerfile)
my-awesome - vulhub/vulhub - compose,dockerfile,vulhub,vulnerability-environment pushed_at:2024-09 star:17.7k fork:4.5k Pre-Built Vulnerable Environments Based on Docker-Compose (Dockerfile)
awesome-vulnerable-apps - Vulhub
fucking-Awesome-Hacking - Vulhub - Built Vulnerable Environments Based on Docker-Compose (Other Useful Repositories)

README

Vulhub is an open-source collection of pre-built vulnerable docker environments. No pre-existing knowledge of docker is required, just execute two simple commands and you have a vulnerable environment.

[中文版本(Chinese version)](README.zh-cn.md)

## Installation

Install Docker on Ubuntu 22.04:

```bash
# Install the latest version docker
curl -s https://get.docker.com/ | sh

# Run docker service
systemctl start docker
```

Note that as of April 2022, `docker compose` is merged into Docker as a subcommand as [Docker Compose V2](https://www.docker.com/blog/announcing-compose-v2-general-availability/), the Python version of docker-compose will be deprecated after June 2023. So Vulhub will no longer require the installation of additional `docker-compose`, and all documentation will be modified to use the `docker compose` instead.

The installation steps of Docker and Docker Compose for other operating systems might be slightly different, please refer to the [docker documentation](https://docs.docker.com/) for details.

## Usage

```bash
# Download project
wget https://github.com/vulhub/vulhub/archive/master.zip -O vulhub-master.zip
unzip vulhub-master.zip
cd vulhub-master

# Enter the directory of vulnerability/environment
cd flask/ssti

# Compile environment
docker compose build

# Run environment
docker compose up -d
```

There is a **README** document in each environment directory, please read this file for vulnerability/environment testing and usage.

After the test, delete the environment with the following command.

```
docker compose down -v
```

It is recommended to use a VPS of at least 1GB memory to build a vulnerability environment. The `your-ip` mentioned in the documentation refers to the IP address of your VPS. If you are using a virtual machine, it refers to your virtual machine IP, not the IP inside the docker container.

**All environments in this project are for testing purposes only and should not be used as a production environment!**

## Notice

1. To prevent permission errors, please ensure that the docker container has permission to access all files in the current directory.
2. Vulhub does not support running on machines with non-x86 architecture such as ARM for now.

## Contribution

This project relies on docker. So any error during compilation and running are thrown by docker and related programs. Please find the cause of the error by yourself first. If it is determined that the dockerfile is written incorrectly (or the code is wrong in vulhub), then submit the issue. More details please 👉[Common reasons for compilation failure](https://github.com/phith0n/vulhub/wiki/%E7%BC%96%E8%AF%91%E5%A4%B1%E8%B4%A5%E7%9A%84%E5%8E%9F%E5%9B%A0), hope it can help you.

For more question, please contact:

- [Discord](https://discord.gg/bQCpZEK)
- [Twitter](https://twitter.com/vulhub)

Thanks for the following contributors:

[![](https://opencollective.com/vulhub/contributors.svg?width=890&button=false)](https://github.com/vulhub/vulhub/graphs/contributors)

More contributors：[Contributors List](contributors.md)

## Partner

Our Partners and users: