From 74377cf4ea903618fe7830abc6e0352eef3d6a8e Mon Sep 17 00:00:00 2001 From: phillip-stephens Date: Wed, 5 Jun 2024 17:02:24 -0700 Subject: [PATCH 1/2] fixed typo in cleanup script --- integration_tests/amqp091/cleanup.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/integration_tests/amqp091/cleanup.sh b/integration_tests/amqp091/cleanup.sh index a80456c1..4b1ae12b 100755 --- a/integration_tests/amqp091/cleanup.sh +++ b/integration_tests/amqp091/cleanup.sh @@ -3,11 +3,11 @@ # Keep cleaning up even if something fails set +e -# Stop all MySQL containers. +# Stop all AMQP containers. VERSIONS="3.12.14 3.13.2" -for version in $MYSQL_VERSIONS; do +for version in $VERSIONS; do CONTAINER_NAME="zgrab_amqp091-$version" echo "amqp091/cleanup: Stopping $CONTAINER_NAME..." docker stop $CONTAINER_NAME From eb19f31fa933aa82d91a8a9e96ff4970eaec7fd9 Mon Sep 17 00:00:00 2001 From: Raymond Nook <59678453+developStorm@users.noreply.github.com> Date: Thu, 6 Jun 2024 10:22:02 -0700 Subject: [PATCH 2/2] docs: docker usage (#438) --- README.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3f53a534..298d1706 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,25 @@ ZGrab is a fast, modular application-layer network scanner designed for completi ZGrab 2.0 contains a new, modular ZGrab framework, which fully supersedes https://github.com/zmap/zgrab. +## Installation -## Building +### With Docker + +You can run ZGrab 2.0 with our official Docker image. For example, to scan a single website using the HTTP module, you can use: + +```shell +echo 'example.com' | docker run --rm -i ghcr.io/zmap/zgrab2 http +``` + +For more complex scanning scenarios, such as using multiple modules or custom configurations, you can create a configuration file and pass it to the container: + +```shell +docker run --rm -i -v /path/to/your/config.ini:/config.ini ghcr.io/zmap/zgrab2 multiple -c /config.ini +``` + +Replace `/path/to/your/config.ini` with the path to your configuration file on the host machine. See [Multiple Module Usage](#multiple-module-usage) for more details on configurations. + +### Building from Source For Go 1.17 and later you must build from source: