Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

subquest-logo

fast and elegant subdomain scanner built with node

Installation

To use subquest in your node scripts you have to install it and add it to your project dependencies:

npm install --save subquest

Than you can require it in your script and use it, following examples below.

After v1.5.0

After the version 1.5.0 the module doesn't use event emitters, just callbacks,

const subquest = require('subquest')

subquest.getSubDomains({
  host: 'google.com'
}, (err, results) => {

  if(err) {
    console.log('Error:', err);
    return;
  }

  console.log('Subdomains:', results);  
})

Before v1.5.0

Before the version 1.5.0 the module makes use of event emitters to determine when it's done.

var subquest = require('subquest');

subquest
  .getSubDomains({
    host: 'google.com', // required
    rateLimit:'4', // four requests at time
    dnsServer:'4.2.2.2', // custom DNS server
    dictionary: 'top_200' // dictionary file to use
  })
  .on('end', function(res){
    console.log(res); // array of subdomains.
  })

This scans google.com for the list of all subdomains using the top_200 dictionary.

Methods

isValidDnsServer(server, [timeout], callback)

Test if a given address is valid DNS server

getResolvers([domain], callback)

Get the list of all the resolvers (DNS Servers) used in the scan, both default and custom

getDictionaryNames()

Get the list of the dictionary files used in the scan

getSubDomains(options, callback)

Run the scan against the domain to enumerate all subdomains

Looking for the cli version?

You can use subquest as a command line tool by cloning the official repository or using npm:

$ npm install -g subquest-cli

Want to add a new entry to Subquest's dictionary?

Add your list of subdomain names to the ./dictionary/all.txt file and send a pull request.

Contributing

  1. Create an issue and describe your idea
  2. Fork the project (https://github.com/skepticfx/subquest/fork)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Publish the branch (git push origin my-new-feature)
  6. Create a new Pull Request

Credits

About

Fast, Elegant subdomain scanner using nodejs

Resources

License

Releases

No releases published

Packages

No packages published