Skip to content

austinginder/periscope

Repository files navigation

Periscope

Peer into any domain.

A single-file .php script to fetch domain information from whois and dig. It supports exporting discovered records as a DNS zone file.

Requirements

  • PHP
  • shell_exec enabled
  • The following command-line tools: whois, dig, host, curl

Running Locally

You can run this on a local machine or any web server that supports PHP and shell_exec.

# Clone the repository
git clone https://github.com/austinginder/periscope.git

# Navigate into the directory
cd periscope

# Start the local PHP server
php -S localhost:8000

Then open http://localhost:8000 in your browser

🏝️ Using Cove to run Periscope

You will need to have Cove installed and running: https://cove.run. Periscope is a simple PHP app so it can be added to Cove by running the following commands:

cove add periscope --plain
cd $(cove path periscope)
git clone https://github.com/austinginder/periscope.git .

Then open https://periscope.localhost in your browser.

Using from the CLI

It's also possible to use from the CLI for scripting purposes by running php index.php "domain.tld" as shown in the following example.

php index.php "austinginder.com"

The response would be:

Looking up domain: austinginder.com...

--- Summary for austinginder.com ---
Registrar:     Spaceship, Inc.
IP Addresses:  162.159.135.42
Name Servers:  ns1.anchor.host., ns2.anchor.host., ns3.anchor.host., ns4.anchor.host.
---------------------------

Full report saved to database.

About

Peer into any domain.

Resources

License

Stars

Watchers

Forks

Languages