⚠️ Abandoned project

This project is not maintained anymore and is abandoned. Feel free to fork and make your own changes if needed.

About

Docker image to run Shodan CLI.

Note

Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!

---

• Build locally
• Image
• Usage
• Contributing
• License

Build locally

git clone https://github.com/crazy-max/docker-shodan.git
cd docker-shodan

# Build image and output to docker (default)
docker buildx bake

# Build multi-platform image
docker buildx bake image-all

Image

Registry	Image
Docker Hub	crazymax/shodan
GitHub Container Registry	ghcr.io/crazy-max/shodan

Following platforms for this image are available:

$ docker run --rm mplatform/mquery crazymax/shodan:latest
Image: crazymax/shodan:latest
 * Manifest List: Yes
 * Supported platforms:
   - linux/amd64
   - linux/arm/v6
   - linux/arm/v7
   - linux/arm64
   - linux/386
   - linux/ppc64le
   - linux/s390x

Usage

The entrypoint is shodan itself:

docker run -t --rm crazymax/shodan:latest

Usage: shodan [OPTIONS] COMMAND [ARGS]...

Options:
  -h, --help  Show this message and exit.

Commands:
  alert       Manage the network alerts for your account
  convert     Convert the given input data file into a different format.
  count       Returns the number of results for a search
  data        Bulk data access to Shodan
  domain      View all available information for a domain
  download    Download search results and save them in a compressed JSON...
  honeyscore  Check whether the IP is a honeypot or not.
  host        View all available information for an IP address
  info        Shows general information about your account
  init        Initialize the Shodan command-line
  myip        Print your external IP address
  org         Manage your organization's access to Shodan
  parse       Extract information out of compressed JSON files.
  radar       Real-Time Map of some results as Shodan finds them.
  scan        Scan an IP/ netblock using Shodan.
  search      Search the Shodan database
  stats       Provide summary information about a search query
  stream      Stream data in real-time.
  version     Print version of this tool.

Finally, initialize the Shodan CLI with your API key:

docker run -t --rm crazymax/shodan:latest init 01234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ

Successfully initialized

Then you can start using it:

docker run -t --rm crazymax/shodan:latest search nginx

Contributing

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a Paypal donation to ensure this journey continues indefinitely!

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.